Zum Hauptinhalt springen
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.

1. Claude Code installieren

Lokale Installation

Installation über npm

Erfordert Node.js 18 oder neuer

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 erhalten haben
  3. Setzen Sie ANTHROPIC_MODEL auf ein von Harogo unterstütztes Claude-Modell, zum Beispiel claude-sonnet-5.
  1. Führen Sie im Terminal den folgenden Befehl aus, um Ihre Standard-Shell zu ermitteln.
  1. Setzen Sie die Umgebungsvariablen passend zu Ihrer Shell:
  1. Führen Sie im Terminal den folgenden Befehl aus, damit die Umgebungsvariablen wirksam werden.
  1. Öffnen Sie ein neues Terminal und führen Sie die folgenden Befehle aus, um zu prüfen, ob die Umgebungsvariablen wirksam sind.
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.

4. Claude Code verwenden

Wechseln Sie nach der Konfiguration in Ihr Arbeitsverzeichnis und führen Sie im Terminal den Befehl claude aus.
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 Terminal mit der Abfrage „Anmelden oder fortfahren“ beim ersten Start von Claude Code
  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
  1. 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 <model-name>. Geeignet für einen einmaligen Wechsel.
  1. Beim Start von Claude Code: Geben Sie mit claude --model <model-name> ein Modell an. Geeignet für eine einzelne Sitzung.
  1. 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.
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.
  1. 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 Einstieg „Anbieter hinzufügen“ auf dem Startbildschirm von CC Switch
  1. Wählen Sie in der Vorlagenliste „Benutzerdefinierte Konfiguration“ (Custom Configuration) als Anbieter aus.
Auswahl von Custom Configuration in der Anbieter-Vorlagenliste von CC Switch Auswahl von Custom Configuration in der Anbieter-Vorlagenliste von CC Switch
  1. Tragen Sie Anbietername, API-Key, Endpoint (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 Eingabe des API-Keys im Anbieter-Konfigurationsformular von CC Switch
  1. 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 Auswahl von harogo und Klick auf Use auf dem Startbildschirm von CC Switch
Prüfen der Modellkonfiguration mit den Befehlen status und models im Claude-Code-TerminalPrüfen der Modellkonfiguration mit den Befehlen status und models im Claude-Code-Terminal
I Shot 2026 08 07 17 04 52
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.
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=<HAROGO_API_KEY> 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.