> ## Documentation Index > Fetch the complete documentation index at: https://gccai.heqingsong.uk/llms.txt > Use this file to discover all available pages before exploring further. # GccAi in Claude Code verwenden > Ausführliche Anleitung zur Konfiguration und Nutzung der GccAi-API-Dienste in der Claude-Code-CLI, mit der Sie mehrere KI-Modelle für unterstütztes Programmieren mit einfacher Konfiguration verwenden können. ![Claude Code Main Interface](https://mintcdn.com/apicore/_4UKBib4iqrgK4Ws/images/integrations/claude-code/claude-code-cli.png?fit=max\&auto=format\&n=_4UKBib4iqrgK4Ws\&q=85\&s=219739f4029aa915b90253ad02b01437) ## Voraussetzungen Claude Code ist ein KI-Programmier-Assistent für die Kommandozeile von Anthropic, der direkten KI-Dialog, Codegenerierung und Debugging im Terminal unterstützt. Durch die Verbindung mit GccAi können Sie in Claude Code mehrere Modelle wie GPT, Claude und Gemini verwenden. Bevor Sie beginnen, stellen Sie sicher, dass Sie: 1. **Einen GccAi-API-Schlüssel erhalten haben** Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/keys) an, um Ihren API-Schlüssel zu erhalten (beginnt mit `sk-`) > [!NOTE] > > **Tipp:** Wenn Sie noch kein GccAi-Konto haben, registrieren Sie sich zuerst bei [GccAi](https://gccai.heqingsong.uk) und holen Sie sich Ihren API-Schlüssel. ## Schritt 1: Claude Code installieren Wählen Sie eine der folgenden Methoden zur Installation: **macOS / Linux (empfohlen)** Installation über das offizielle Skript: ```bash theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` Oder Installation über Homebrew: ```bash theme={null} brew install --cask claude-code ``` > [!NOTE] > > Bei Berechtigungsproblemen fügen Sie `sudo` vor dem Befehl ein. **Windows** **PowerShell:** ```powershell theme={null} irm https://claude.ai/install.ps1 | iex ``` **CMD:** ```cmd theme={null} curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd ``` **NPM-Installation** Wenn Sie Node.js 18 oder neuer installiert haben, können Sie über npm installieren: ```bash theme={null} npm install -g @anthropic-ai/claude-code ``` Funktioniert auf allen Betriebssystemen. ### Installation überprüfen Führen Sie nach der Installation den folgenden Befehl zur Bestätigung aus: ```bash theme={null} claude --version ``` Wird eine Versionsnummer angezeigt (z. B. `1.x.x`), war die Installation erfolgreich. ## Schritt 2: GccAi-API konfigurieren Es stehen drei Konfigurationsmethoden zur Verfügung. Wählen Sie die für Ihren Workflow passende. ### Methode 1: settings.json bearbeiten (empfohlen) Der stabilste Ansatz – einmal konfigurieren und es bleibt erhalten. **1. Konfigurationsverzeichnis finden:** * Windows: drücken Sie `Win + R`, geben Sie `%userprofile%\.claude` ein * macOS: drücken Sie `Command + Shift + G`, geben Sie `~/.claude` ein * Linux: navigieren Sie zu `~/.claude` > [!NOTE] > > Existiert das Verzeichnis nicht, führen Sie einmal `claude` im Terminal aus und drücken Sie `Ctrl + C` zum Beenden – das Verzeichnis wird automatisch erstellt. **2. Erstellen oder bearbeiten Sie die Datei `settings.json`:** ```json theme={null} { "env": { "ANTHROPIC_BASE_URL": "https://gccai.heqingsong.uk", "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxx", "ANTHROPIC_MODEL": "claude-opus-5", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1" } } ``` | Parameter | Beschreibung | | - | - | | `ANTHROPIC_BASE_URL` | GccAi-API-Adresse, fest `https://gccai.heqingsong.uk` | | `ANTHROPIC_AUTH_TOKEN` | Ihr GccAi-API-Schlüssel (beginnt mit `sk-`) | | `ANTHROPIC_MODEL` | Standardmäßig verwendetes Modell, aus der Modellliste unten wählen | | `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` | Auf `1` setzen, um nicht wesentliche Netzwerkanfragen zu reduzieren | Speichern Sie die Datei und starten Sie Claude Code neu, um sie anzuwenden. ### Methode 2: Permanente Umgebungsvariablen Schreiben Sie die Konfiguration in die Systemumgebung, sodass alle Terminalfenster sie automatisch laden. **macOS (zsh)** ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.zshrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.zshrc echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.zshrc source ~/.zshrc ``` **macOS / Linux (bash)** ```bash theme={null} echo 'export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk"' >> ~/.bashrc echo 'export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx"' >> ~/.bashrc echo 'export ANTHROPIC_MODEL="claude-opus-5"' >> ~/.bashrc source ~/.bashrc ``` **Windows** **Option A: GUI-Einstellungen** 1. Rechtsklick auf „Dieser PC" → „Eigenschaften" → „Erweiterte Systemeinstellungen" → „Umgebungsvariablen" 2. Neue Benutzervariablen hinzufügen: * `ANTHROPIC_BASE_URL` = `https://gccai.heqingsong.uk` * `ANTHROPIC_API_KEY` = `sk-xxxxxxxxxxxx` * `ANTHROPIC_MODEL` = `claude-opus-5` 3. Terminal neu starten **Option B: PowerShell-Befehle** ```powershell theme={null} [System.Environment]::SetEnvironmentVariable('ANTHROPIC_BASE_URL', 'https://gccai.heqingsong.uk', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-xxxxxxxxxxxx', 'User') [System.Environment]::SetEnvironmentVariable('ANTHROPIC_MODEL', 'claude-opus-5', 'User') ``` ### Methode 3: Temporäre Umgebungsvariablen Geeignet für schnelle Tests – Konfiguration geht beim Schließen des Terminals verloren. **macOS / Linux** ```bash theme={null} export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" export ANTHROPIC_MODEL="claude-opus-5" export ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk" claude ``` **Windows (PowerShell)** ```powershell theme={null} $env:ANTHROPIC_API_KEY="sk-xxxxxxxxxxxx" $env:ANTHROPIC_MODEL="claude-opus-5" $env:ANTHROPIC_BASE_URL="https://gccai.heqingsong.uk" claude ``` **Windows (CMD)** ```cmd theme={null} set ANTHROPIC_API_KEY=sk-xxxxxxxxxxxx set ANTHROPIC_MODEL=claude-opus-5 set ANTHROPIC_BASE_URL=https://gccai.heqingsong.uk claude ``` > [!WARNING] > > Temporäre Umgebungsvariablen funktionieren nur im aktuellen Terminalfenster. Nach Fensterwechsel oder Schließen des Terminals müssen Sie sie erneut setzen. ## Schritt 3: Loslegen ### Konfiguration überprüfen Starten Sie Claude Code und senden Sie eine einfache Nachricht zur Bestätigung: ```bash theme={null} claude "Hello" ``` Erhalten Sie eine KI-Antwort, war die Konfiguration erfolgreich. Bei Fehlern wie `401`, `403` etc. siehe FAQ unten. ### Nutzungsmodi Claude Code bietet zwei Interaktionsmodi: * **Interaktiver Modus**: Führen Sie `claude` aus für eine kontinuierliche Unterhaltung, ideal für komplexe Aufgaben * **Einzelbefehl**: Führen Sie `claude "Ihre Frage"` aus für eine einmalige Antwort, ideal für schnelle Abfragen ### Unterstützte Modelle GccAi unterstützt die gesamte Claude-Modellreihe. Sie können je nach Bedarf flexibel wechseln: | Modellname | Eigenschaften | Empfohlene Nutzung | | - | - | - | | `claude-opus-5` | Flaggschiff der nächsten Generation | Komplexe Architektur, schwieriges Debugging | | `claude-opus-4-6` | Starke Gesamtleistung | Komplexe Architektur, schwieriges Debugging | | `claude-sonnet-4-6` | Ausgewogene Leistung und Geschwindigkeit | Tägliches Programmieren, Codegenerierung | | `claude-opus-4-5-20251101` | Fortgeschrittenes Reasoning | Komplexer Code, tiefe Analyse | | `claude-sonnet-4-5-20250929` | Hervorragende Code-Fähigkeit | Algorithmusdesign, Code-Optimierung | | `claude-haiku-4-5-20251001` | Ultraschnelle Antwort | Schnelle Q\&A, Code-Snippets | Alle obigen Modelle unterstützen eine Thinking-Version (erweitertes Reasoning) – hängen Sie `-thinking` an die Modell-ID an, z. B. `claude-opus-4-6-thinking`. Der Thinking-Modus ist ideal für komplexe Aufgaben, die tiefes Reasoning erfordern. > [!TIP] > > **Modellempfehlungen:** > > * 🚀 **Hohe Leistung:** `claude-opus-5` – für die komplexesten Code- und Architektur-Herausforderungen > * ⚖️ **Ausgewogene Leistung:** `claude-sonnet-4-6` – für tägliches Programmieren > * ⚡ **Schnelle Antwort:** `claude-haiku-4-5-20251001` – wenn Sie sofortiges Feedback benötigen > * 🧠 **Tiefes Denken:** `claude-opus-5-thinking` – wenn tiefes Reasoning nötig ist Zum Wechseln des Modells verwenden Sie den `/model`-Befehl im interaktiven Modus oder ändern Sie das Feld `ANTHROPIC_MODEL` in Ihrer Konfiguration und starten Sie neu. ### Häufige Befehle Hier sind häufig verwendete Befehle und Tastenkürzel in Claude Code: | Befehl | Beschreibung | | - | - | | `claude` | In den interaktiven Modus wechseln | | `claude "Frage"` | Einmaliger Abfrage | | `claude --version` | Version prüfen | | `/model` | Modell im interaktiven Modus wechseln | | `/help` | Hilfeinformationen anzeigen | | `Ctrl + C` | Interaktiven Modus verlassen | ## FAQ ### Q1: Nach der Konfiguration wird immer noch die Login-Auswahlseite angezeigt? Wenn „Select login method" nach dem Start immer noch erscheint, ist die Konfiguration nicht wirksam. **Schritte zur Fehlersuche:** 1. **Bei Verwendung von settings.json**: Prüfen Sie, ob der Dateipfad korrekt ist * Windows: `C:\Users\\.claude\settings.json` * macOS / Linux: `~/.claude/settings.json` 2. **Bei Verwendung von Umgebungsvariablen**: Stellen Sie sicher, dass Sie Claude Code aus **demselben Terminalfenster** gestartet haben, in dem Sie die Variablen gesetzt haben 3. **JSON-Format prüfen**: Stellen Sie sicher, dass Klammern, Kommas und Anführungszeichen alle korrekt sind ### Q2: 401 / 403 Fehler? | Fehlercode | Bedeutung | Lösung | | - | - | - | | `401 Unauthorized` | API-Schlüssel fehlt oder ungültig | Prüfen Sie, ob der Schlüssel korrekt ist und mit `sk-` beginnt | | `403 Forbidden` | Unzureichende Berechtigungen oder abgelaufener Schlüssel | Gehen Sie zur [Konsole](https://gccai.heqingsong.uk/keys), um den Schlüsselstatus zu überprüfen | Stellen Sie außerdem sicher, dass `ANTHROPIC_BASE_URL` auf `https://gccai.heqingsong.uk` gesetzt ist, nicht auf die offizielle Anthropic-Adresse. ### Q3: Fehler „Unable to connect"? Das bedeutet, Claude Code konnte sich nicht mit dem API-Dienst verbinden. 1. Prüfen Sie Ihre Netzwerkverbindung 2. Stellen Sie sicher, dass `ANTHROPIC_BASE_URL` korrekt konfiguriert ist 3. Wenn Sie einen Proxy verwenden, stellen Sie sicher, dass er Zugriff auf `gccai.heqingsong.uk` zulässt ### Q4: Fehler „Auth conflict"? Wenn Sie eine Nachricht wie diese sehen: ``` Auth conflict: Both a token (claude.ai) and an API key (ANTHROPIC_API_KEY) are set. ``` Bedeutet das, Sie sind bei claude.ai angemeldet und haben gleichzeitig einen API Key gesetzt – das verursacht einen Konflikt. **Lösung:** Führen Sie `/logout` im interaktiven Modus von Claude Code aus, um sich bei claude.ai abzumelden und nur die API-Key-Konfiguration zu behalten. ### Q5: max\_tokens-Fehler bei Verwendung von Nicht-Claude-Modellen? Wenn Sie einen Fehler wie diesen sehen: ``` max_tokens is too large: 32000. This model supports at most 16384 completion tokens. ``` Das liegt daran, dass Claude Code Anfragen standardmäßig mit Claude-Modell-Parametern (32000 Tokens) sendet, während einige Nicht-Claude-Modelle (z. B. `gpt-4o`) niedrigere Token-Limits haben. **Lösung:** Wechseln Sie zu einem Claude-Modell (z. B. `claude-sonnet-4-6`), das nativ mit Claude Code kompatibel ist und dieses Problem nicht verursacht. ### Q6: Langsame Antwort? 1. Wechseln Sie zu einem schnelleren Modell (z. B. `claude-haiku-4-5-20251001` oder `claude-sonnet-4-6`) 2. Verkürzen Sie Ihre Prompts, um die Kontextlänge zu reduzieren 3. Prüfen Sie Ihren Netzwerkzustand ### Q7: Wie wechsle ich Modelle? Zwei Wege: 1. **Im interaktiven Modus**: Geben Sie den `/model`-Befehl ein 2. **Konfiguration bearbeiten**: Ändern Sie das Feld `ANTHROPIC_MODEL` in `settings.json` oder den Umgebungsvariablen, starten Sie dann Claude Code neu ### Q8: Liest Claude Code lokale Dateien automatisch? Nein. Claude Code erfordert, dass Sie Dateien explizit referenzieren, und fragt vor sensiblen Operationen nach Bestätigung. Es wird empfohlen, es in dedizierten Projektverzeichnissen zu verwenden. ### Q9: Wie analysiere ich lokale Dateien mit Claude Code? Im interaktiven Modus können Sie Dateien referenzieren, indem Sie: * Den Dateipfad direkt eingeben * Dateien ins Terminalfenster ziehen * Dateiinhalt kopieren und einfügen ### Q10: Wie prüfe ich Nutzung und Kosten? Melden Sie sich in der [GccAi-Konsole](https://gccai.heqingsong.uk/overview) an, um Folgendes zu sehen: * API-Aufruf-Statistiken * Token-Verbrauchsdetails * Kostenstatistiken und Trends ## Support Wenn Sie auf Probleme stoßen: * 📚 [GccAi-Dokumentation](https://gccai.heqingsong.uk) * 💬 [Discord-Community](https://discord.gg/V8zqssyZ5c) * 🐦 [Twitter @GccAi\_](https://x.com/GccAi_) * 📧 Technischer Support: [zhihong@gccai.heqingsong.uk](mailto:zhihong@gccai.heqingsong.uk) *** > **[Mit GccAi loslegen](https://gccai.heqingsong.uk)** > > Registrieren Sie sich jetzt bei GccAi, holen Sie sich Ihren API-Schlüssel und erleben Sie den Multi-Modell-Programmier-Assistenten in Claude Code! This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.