> ## Documentation Index > Fetch the complete documentation index at: https://docs.harogo.ai/llms.txt > Use this file to discover all available pages before exploring further. # Claude Code > Mit dieser Anleitung nutzen Sie Claude Code mit Harogo in wenigen Minuten. > [!NOTE] > > **Diese Anleitung verwendet nur Claude-Modelle.** Claude Code kann die Claude-Modelle (Claude Opus 5.5, Claude Sonnet 5.5, Claude Sonnet 5, Claude Fable 5.1, Claude Haiku 5.5) sowie die Modelle ohne Client-Beschränkung (GLM, Qwen, Kimi, MiniMax, DeepSeek) ausführen. GPT-Modelle sind in Claude Code nicht verfügbar — siehe [Codex](https://docs.harogo.ai/de/codex.md). ### 1. Claude Code installieren #### Lokale Installation ```shellscript macOS theme={null} curl -fsSL https://claude.ai/install.sh | bash ``` ```shellscript Windows theme={null} irm https://claude.ai/install.ps1 | iex ``` #### Installation über npm Erfordert [Node.js 18 oder neuer](https://nodejs.org/en/download/) ```shellscript theme={null} npm install -g @anthropic-ai/claude-code ``` ### 2. Harogo-API konfigurieren Um sich über die Anthropic-kompatible API mit dem Modelldienst von Harogo zu verbinden, setzen Sie die folgenden Umgebungsvariablen. 1. Setzen Sie `ANTHROPIC_BASE_URL` auf `https://api.harogo.ai/` 2. Setzen Sie `ANTHROPIC_AUTH_TOKEN` auf den API-Key, den Sie auf der [Harogo-Plattform](https://console.harogo.ai/keys) erhalten haben 3. Setzen Sie `ANTHROPIC_MODEL` auf ein von Harogo unterstütztes Claude-Modell, zum Beispiel `claude-sonnet-5`. > [tab] macOS > > 1. Führen Sie im Terminal den folgenden Befehl aus, um Ihre Standard-Shell zu ermitteln. > > ```shellscript theme={null} > echo $SHELL > ``` > > 2. Setzen Sie die Umgebungsvariablen passend zu Ihrer Shell: > > ```shellscript Zsh theme={null} > # Ersetzen Sie durch den echten Key von Ihrer Harogo-Plattform > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.zshrc > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.zshrc > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.zshrc > ``` > > ```shellscript Bash theme={null} > # Ersetzen Sie durch den echten Key von Ihrer Harogo-Plattform > echo 'export ANTHROPIC_BASE_URL="https://api.harogo.ai"' >> ~/.bash_profile > echo 'export ANTHROPIC_AUTH_TOKEN=""' >> ~/.bash_profile > echo 'export ANTHROPIC_MODEL="claude-sonnet-5"' >> ~/.bash_profile > ``` > > 3. Führen Sie im Terminal den folgenden Befehl aus, damit die Umgebungsvariablen wirksam werden. > > ```shellscript Zsh theme={null} > source ~/.zshrc > ``` > > ```shellscript Bash theme={null} > source ~/.bash_profile > ``` > > 4. Öffnen Sie ein neues Terminal und führen Sie die folgenden Befehle aus, um zu prüfen, ob die Umgebungsvariablen wirksam sind. > > ```shellscript theme={null} > echo $ANTHROPIC_BASE_URL > test -n "$ANTHROPIC_AUTH_TOKEN" && echo "ANTHROPIC_AUTH_TOKEN is set" > echo $ANTHROPIC_MODEL > ``` > [tab] Windows > > Unter Windows können Sie die Base-URL und den [API-Key](https://console.harogo.ai/keys) von Harogo per CMD oder PowerShell als Umgebungsvariablen setzen. > > > [tab] CMD > > > > 1. Führen Sie in CMD den folgenden Befehl aus, um die Umgebungsvariablen zu setzen. > > > > ```shellscript theme={null} > > REM Ersetzen Sie durch den echten Key von Ihrer Harogo-Plattform > > setx ANTHROPIC_AUTH_TOKEN "" > > setx ANTHROPIC_BASE_URL "https://api.harogo.ai" > > setx ANTHROPIC_MODEL "claude-sonnet-5" > > ``` > > > > 2. Öffnen Sie ein neues CMD-Fenster und führen Sie die folgenden Befehle aus, um zu prüfen, ob die Umgebungsvariablen wirksam sind. > > > > ```shellscript theme={null} > > if defined ANTHROPIC_AUTH_TOKEN echo ANTHROPIC_AUTH_TOKEN is set > > echo %ANTHROPIC_BASE_URL% > > echo %ANTHROPIC_MODEL% > > ``` > > > [tab] PowerShell > > > > 1. Führen Sie in PowerShell den folgenden Befehl aus, um die Umgebungsvariablen zu setzen. > > > > ```shellscript theme={null} > > # Ersetzen Sie durch den echten Key von Ihrer Harogo-Plattform > > [Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.harogo.ai", [EnvironmentVariableTarget]::User) > > [Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-5", [EnvironmentVariableTarget]::User) > > ``` > > > > 2. Öffnen Sie ein neues PowerShell-Fenster und führen Sie die folgenden Befehle aus, um zu prüfen, ob die Umgebungsvariablen wirksam sind. > > > > ```shellscript theme={null} > > if ($env:ANTHROPIC_AUTH_TOKEN) { "ANTHROPIC_AUTH_TOKEN is set" } > > echo $env:ANTHROPIC_BASE_URL > > echo $env:ANTHROPIC_MODEL > > ``` > [!NOTE] > > Wenn Sie Claude Code über CC Switch verwalten möchten, empfehlen wir, nicht zusätzlich globale Werte für `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` oder `ANTHROPIC_MODEL` zu setzen. Umgebungsvariablen auf System- oder Benutzerebene können die von CC Switch geschriebene Anbieterkonfiguration überschreiben. Dann zeigt die Oberfläche zwar den richtigen Anbieter als ausgewählt an, Claude Code läuft aber tatsächlich noch mit einem alten Key oder Modell. ### 3. Konfiguration prüfen Senden Sie nach dem Einrichten der Umgebungsvariablen oder von CC Switch zuerst eine minimale Anfrage, um zu bestätigen, dass Key, Modell und Anthropic-kompatibler Endpoint funktionieren, bevor Sie eine längere Sitzung starten. ```bash macOS/Linux theme={null} curl https://api.harogo.ai/v1/messages \ -H "content-type: application/json" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" \ -d '{ "model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "1+1, output only the answer"}] }' ``` ```powershell Windows theme={null} curl.exe https://api.harogo.ai/v1/messages ` -H "content-type: application/json" ` -H "anthropic-version: 2023-06-01" ` -H "x-api-key: $env:ANTHROPIC_AUTH_TOKEN" ` -d "{\"model\":\"claude-sonnet-5\",\"max_tokens\":16,\"messages\":[{\"role\":\"user\",\"content\":\"1+1, output only the answer\"}]}" ``` ### 4. Claude Code verwenden Wechseln Sie nach der Konfiguration in Ihr Arbeitsverzeichnis und führen Sie im Terminal den Befehl `claude` aus. ```bash theme={null} $ cd /path/your-project > claude ``` Wenn beim Start `Not logged in · Please run /login` erscheint oder Sie im Anthropic-Login landen, hat Claude Code in der Regel keine funktionierende Harogo-Konfiguration übernommen, oder das Onboarding beim ersten Start wurde noch nicht abgeschlossen. Prüfen Sie zuerst, ob die minimale Anfrage aus dem vorherigen Schritt `2` zurückgibt, und ob `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` oder `ANTHROPIC_MODEL` durch alte globale Umgebungsvariablen überschrieben werden. Wenn der Key nachweislich funktioniert und Sie trotzdem zum Login weitergeleitet werden, können Sie das Onboarding mit den folgenden Schritten überspringen: ![Terminal mit der Abfrage „Anmelden oder fortfahren“ beim ersten Start von Claude Code](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/cc-7.avif?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=80bd9b41f8af28fa7679659117d6266c) 1. Suchen Sie die Datei `.claude.json` in Ihrem Home-Verzeichnis: * macOS / Linux: `~/.claude.json` * Windows: `C:\Users\%USERNAME%\.claude.json` 2. Setzen Sie das Feld `hasCompletedOnboarding` auf `true` ```json theme={null} { "hasCompletedOnboarding": true } ``` 3. Speichern Sie die Datei und führen Sie `claude` im Terminal erneut aus. #### (Optional) Weitere Möglichkeiten zur Modellkonfiguration Claude Code unterstützt die folgenden Wege, das Modell zu konfigurieren, **absteigend nach Priorität sortiert**. Eine Einstellung mit höherer Priorität überschreibt eine mit niedrigerer. 1. **Während einer Unterhaltung:** Wechseln Sie das Modell mit dem Befehl `/model `. Geeignet für einen einmaligen Wechsel. ```text theme={null} /model claude-sonnet-5 ``` 2. **Beim Start von Claude Code:** Geben Sie mit `claude --model ` ein Modell an. Geeignet für eine einzelne Sitzung. ```text theme={null} claude --model claude-sonnet-5 ``` 3. **Umgebungsvariablen setzen:** Konfigurieren Sie Modelle in verschiedenen Stufen je nach Aufgabenkomplexität. Claude Code wählt dann automatisch das passende Modell für die Aufgabe. Gilt global. ```shellscript theme={null} export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5" export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5" export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-5-5" ``` Dabei gilt: * `ANTHROPIC_DEFAULT_OPUS_MODEL`: für komplexes Reasoning, Architekturentwurf und andere anspruchsvolle Aufgaben. * `ANTHROPIC_DEFAULT_SONNET_MODEL`: für das Schreiben von Code, die Umsetzung von Features und andere alltägliche Aufgaben. * `ANTHROPIC_DEFAULT_HAIKU_MODEL`: für Syntaxprüfungen, Dateisuche und andere einfache Aufgaben. 4. **Dauerhaft in settings.json festlegen:** Schreiben Sie die Modellkonfiguration in die Benutzerkonfigurationsdatei von Claude Code (z. B. `~/.claude/settings.json` bzw. unter Windows `C:\Users\%USERNAME%\.claude\settings.json`) oder in eine Projektkonfiguration, um sie dauerhaft auf Benutzer- oder Projektebene festzulegen. ## Konfiguration über CC Switch 1. Starten Sie CC Switch, wählen Sie links **Claude Code** aus und klicken Sie auf „Anbieter hinzufügen“ (Add Provider). ![Einstieg „Anbieter hinzufügen“ auf dem Startbildschirm von CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/1.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=3a0a45652c18bbabd158f7e3a17a8dce) 2. Wählen Sie in der Vorlagenliste „Benutzerdefinierte Konfiguration“ (Custom Configuration) als Anbieter aus. ![Auswahl von Custom Configuration in der Anbieter-Vorlagenliste von CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.51.01.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=2d63af589968a3f94173587919cbf9a2) 3. Tragen Sie Anbietername, API-Key, Endpoint ([https://api.harogo.ai](https://api.harogo.ai)) usw. ein. Wenn alles ausgefüllt ist, klicken Sie auf „Hinzufügen“ (Add). ![Eingabe des API-Keys im Anbieter-Konfigurationsformular von CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_16.55.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=37caaae4e1ccd895dbe089f656e55751) 4. Wählen Sie auf dem Startbildschirm in der Anbieterliste „harogo“ aus und klicken Sie auf „Verwenden“ (Use). ![Auswahl von harogo und Klick auf Use auf dem Startbildschirm von CC Switch](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.00.16.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=78acb5f499057ae22c6e97c4d770f499) > ![Prüfen der Modellkonfiguration mit den Befehlen status und models im Claude-Code-Terminal](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.03.17.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=192f4da074881e069682f2c9da8b3cd9) > > ![I Shot 2026 08 07 17 04 52](https://mintcdn.com/harogo-7197ea09/rMeOx--1khpclmo0/images/iShot_2026-08-07_17.04.52.png?fit=max\&auto=format\&n=rMeOx--1khpclmo0\&q=85\&s=a8f4c213e6115c8c874979a1d7b0c388) > > Tipp: Wenn Claude Code im Terminal geöffnet ist, geben Sie /status ein, um die Modell-ID zu prüfen, oder /models, um ein anderes konfiguriertes Modell auszuwählen. > [!WARNING] > > Wenn CC Switch „Konflikt mit Systemumgebungsvariablen erkannt“ (System environment variable conflict detected) meldet, kümmern Sie sich zuerst um `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL` und `ANTHROPIC_MODEL`. Diese globalen Variablen überschreiben die aktuelle Anbieterkonfiguration. Ein Platzhalterwert wie `ANTHROPIC_AUTH_TOKEN=` führt direkt zu einem Authentifizierungsfehler. Wenn Sie sicher sind, dass Sie die globalen Variablen nicht mehr benötigen, entfernen Sie die konfliktverursachenden Einträge in CC Switch oder löschen Sie die System- bzw. Benutzerumgebungsvariablen manuell und starten Sie Ihr Terminal neu. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.