🪄 Claude Code Integration mit benutzerdefinierten CodingPlanX-Modellen

> Claude Code ist ein leistungsstarker KI-Programmierassistent von Anthropic, der direkt in Ihr Terminal integriert wird, Ihre Codebasis versteht und nahtlos mit Ihnen zusammenarbeitet, um Code zu schreiben, zu refaktorieren und zu debuggen. > > Dieses Tutorial führt Sie durch die Umgebungsvorbereitung, die Installation von Tools und die exklusive Konfiguration für die Proxy-Schnittstelle codingplanx.ai.

📋 Systemanforderungen

Bevor Sie beginnen, stellen Sie bitte sicher, dass Ihr System die folgenden Mindestanforderungen erfüllt:

Node.js: Version >= 18.0
Betriebssystem: macOS, Linux, Windows (WSL empfohlen)

🚀 Schnellstart

1. Node.js installieren

> 💡 Tipp: Wenn Sie bereits Node.js 18.0 oder höher installiert haben, überspringen Sie diesen Schritt.

🍎 macOS-Benutzer

Installation über Homebrew wird empfohlen:

# 1. Xcode-Befehlszeilentools installieren
sudo xcode-select --install

# 2. Homebrew installieren (falls noch nicht geschehen)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Node.js über Homebrew installieren
brew install node

# 4. Installation überprüfen
node --version

🐧 Ubuntu / Debian-Benutzer

Verwenden Sie das offizielle NodeSource-Skript, um die LTS-Version zu installieren:

# 1. Installationsskript herunterladen und ausführen
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. Node.js installieren
sudo apt-get install -y nodejs

# 3. Installation überprüfen
node --version

🪟 Windows-Benutzer

Es wird empfohlen, die Kommandozeile winget zu verwenden oder das Installationspaket von der offiziellen Node.js-Website herunterzuladen:

# Node.js LTS-Version mit winget installieren
winget install OpenJS.NodeJS.LTS

# Installation überprüfen (Terminal muss ggf. neu gestartet werden)
node --version

2. Claude Code installieren

Öffnen Sie Ihr Terminal und installieren Sie Claude Code global mit npm:

npm install -g @anthropic-ai/claude-code

# Überprüfen, ob die Installation erfolgreich war
claude --version

(Hinweis: Bei Berechtigungsproblemen müssen macOS-/Linux-Benutzer möglicherweise sudo npm install -g @anthropic-ai/claude-code verwenden)

3. Konfigurieren und loslegen

🔑 Erforderliche Konfigurationsinformationen abrufen

Um diesen Dienst nutzen zu können, müssen Sie die folgenden zwei Umgebungsvariablen vorbereiten:

Konfigurationselement	Beschreibung	Wie man es bekommt
`ANTHROPIC_AUTH_TOKEN`	API-Authentifizierungs-Token	Klicken Sie nach der Registrierung auf Token hinzufügen auf der Seite API-Token (beginnt mit `sk-`)
`ANTHROPIC_BASE_URL`	API-Dienstadresse	Fest eintragen: `https://api.codingplanx.ai`

> 📝 Empfohlene Einstellungen beim Erstellen eines Tokens: > - Name: Beliebiger Name (z.B. claude-code-cli) > - Kontingent (Quota): Auf Unbegrenzt setzen > - Gruppe: Wählen Sie Claude code exklusiv oder Offizieller Transfer Claude 3 und höher > - Andere Optionen: Standardeinstellungen beibehalten

💻 Claude Code starten

Bitte wählen Sie den entsprechenden Startbefehl basierend auf Ihrem Betriebssystem und Terminal. Bitte navigieren Sie zuerst in Ihr Projektverzeichnis:

cd ihr-projekt-ordner

🟢 Linux / macOS (Bash/Zsh)

# Umgebungsvariablen setzen (Gültig für aktuelles Terminal)
export ANTHROPIC_AUTH_TOKEN="sk-Ihr_tatsächliches_Token"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # Timeout auf 300 Sekunden setzen, um Verbindungsabbrüche bei langen Antworten zu vermeiden

# Claude Code starten
claude

🔵 Windows PowerShell

# Umgebungsvariablen setzen (Gültig für aktuelles Terminal)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-Ihr_tatsächliches_Token"
$env:API_TIMEOUT_MS = "300000"

# Claude Code starten
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-Ihr_tatsächliches_Token
set API_TIMEOUT_MS=300000

claude

> 💡 Erweiterter Tipp: Wenn Sie die Umgebungsvariablen nicht jedes Mal eingeben möchten, können Sie die obigen export-Anweisungen zu Ihrer ~/.bashrc- oder ~/.zshrc-Datei (Mac/Linux) hinzufügen oder sie als permanente Umgebungsvariablen in den Windows-Systemeinstellungen eintragen.

⚙️ Konfigurationsassistent beim ersten Start

Wenn Sie claude zum ersten Mal starten, führt Sie das System durch die Grundeinstellungen:

Design auswählen (Theme) 👉 Wählen Sie Ihr bevorzugtes Terminal-Farbschema und drücken Sie Enter.
Sicherheitshinweise (Safety) 👉 Lesen und bestätigen Sie die Sicherheitshinweise, drücken Sie Enter.
Terminal-Konfiguration (Terminal) 👉 Standardkonfiguration wird empfohlen, drücken Sie Enter.
Verzeichnis vertrauen (Trust) 👉 Bestätigen Sie, dass Sie dem aktuellen Arbeitsverzeichnis vertrauen, drücken Sie Enter.

✨ Herzlichen Glückwunsch! Wenn Sie die Eingabeaufforderung sehen, können Sie anfangen, mit Ihrem KI-Programmierpartner zu chatten! Versuchen Sie einzugeben: "Erkläre mir die Hauptstruktur dieses Projekts".

❓ Häufig gestellte Fragen (FAQ)

F: Fehler `Invalid API Key · Please run /login`?

A: Dies bedeutet, dass Claude Code Ihre Umgebungsvariablen nicht erfolgreich lesen konnte. Bitte überprüfen Sie:

Ob ANTHROPIC_AUTH_TOKEN und ANTHROPIC_BASE_URL korrekt eingestellt sind.
Ob das Token-Format korrekt ist (muss mit sk- beginnen, ohne zusätzliche Leerzeichen oder Anführungszeichen).
Wenn Sie permanente Umgebungsvariablen konfiguriert haben, stellen Sie sicher, dass Sie das Terminal neu gestartet haben, damit sie wirksam werden.

F: Warum zeigt die untere linke Ecke des Terminals den Status `offline` an?

A: Claude Code pingt standardmäßig google.com an, um den Netzwerkstatus zu ermitteln. In bestimmten Netzwerkumgebungen (z.B. in China) ist es normal, dass offline angezeigt wird, was Ihre normale Nutzung und die Codegenerierung überhaupt nicht beeinträchtigt.

F: Warum schlägt das Surfen im Web (Fetch) durch Claude fehl?

A: Bevor Claude Code auf externe Webseiten zugreift, muss es den offiziellen Dienst für Sicherheitsüberprüfungen aufrufen. Wenn Fetch fehlschlägt:

Stellen Sie sicher, dass Ihr Computer über eine stabile internationale Internetverbindung verfügt.
Aktivieren Sie bei Bedarf einen globalen Terminal-Proxy (z. B. export https_proxy=...).

F: Die Anfrage meldet immer `fetch failed` oder Timeout?

A: Dies wird normalerweise durch Netzwerkschwankungen oder Proxy-Weiterleitungen verursacht. Lösungen:

Überprüfen Sie, ob die Timeout-Umgebungsvariable korrekt eingestellt ist: API_TIMEOUT_MS=300000.
Versuchen Sie, Ihren lokalen Proxy-Knoten zu wechseln.
Drücken Sie Strg+C, um die aktuelle Sitzung zu beenden, und führen Sie den Befehl claude erneut aus.

F: Fehler beim Web-Login?

A: Wenn beim Abrufen des Tokens auf der Webseite eine Ausnahme auftritt, versuchen Sie, den Cookie-Cache Ihres Browsers zu löschen, oder verwenden Sie den Inkognito-Modus, um sich erneut bei codingplanx.ai anzumelden.

📌 Wichtige Hinweise

🛡️ Schnittstellenbeschreibung: Diese Seite ist direkt mit dem offiziellen Claude Code Forwarding Service verbunden und perfekt an CLI-Tools angepasst.
🚦 Verkehrsbeschränkungen: Die aktuelle Konfiguration unterstützt nur den API-Verkehr von Claude Code und unterstützt keine gewöhnlichen API-Aufrufe für andere Clients von Drittanbietern.
🔒 Sicherheitswarnung: Bitte bewahren Sie Ihr API-Token (sk-...) sicher auf. Codieren Sie es niemals fest in Ihrem Code oder laden Sie es in ein öffentliches GitHub-Repository hoch.