Claude Code verwendet nicht den OpenAI-Chat-Endpunkt. Es sendet Anthropic-Messages-Anfragen an /v1/messages, daher müssen Basis-URL und Zugangsdaten die Anthropic-Einstellungen von Claude Code verwenden. GetVibe unterstützt das Messages-Format für bestimmte Katalogmodelle; GPT-6 Luna, GPT-6 Sol und GPT-6.1 Sol sind mit diesem CLI-Pfad nicht kompatibel. Dieser Leitfaden folgt der Claude-Code-Einrichtung von GetVibe und der bestehenden Referenz für benutzerdefinierte Endpunkte.
Claude Code installieren und konfigurieren
Installieren Sie das CLI mit Node.js 22 oder höher:
npm install -g @anthropic-ai/claude-code
mkdir -p ~/.claudeBearbeiten Sie ~/.claude/settings.json und verwenden Sie die folgenden exakten Felder. Die Basis-URL enthält absichtlich kein /v1; Claude Code hängt /v1/messages an. Der leere Wert von ANTHROPIC_API_KEY ist wichtig: Ohne ihn kann Claude Code die normale direkte Anthropic-Authentifizierung bevorzugen, anstatt den benutzerdefinierten Endpunkt zu verwenden.
{
"apiKeyHelper": "echo $GETVIBE_API_KEY",
"env": {
"ANTHROPIC_BASE_URL": "https://getvibeapi.com",
"ANTHROPIC_API_KEY": "",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
}
}Setzen Sie den Schlüssel in der Shell, bevor Sie Claude Code starten: export GETVIBE_API_KEY='your-dashboard-key'. Dies ist die von den Integrationsdateien von GetVibe verwendete Umgebungsvariable. Die Einstellungsdatei verweist auf die Variable; sie sollte nicht den tatsächlichen Schlüssel enthalten. Vermeiden Sie es, in diesem Profil direkte Anthropic-Zugangsdaten zu hinterlegen, da die Priorität von Zugangsdaten den benutzerdefinierten Endpunkt umgehen kann.
Überprüfen Sie den Endpunkt, bevor Sie Schreibzugriff gewähren
Starten Sie claude in einem temporären Repository und führen Sie /status aus. Als Anthropic-Basis-URL sollte https://getvibeapi.com angezeigt werden. Stellen Sie zunächst eine schreibgeschützte Frage und fordern Sie anschließend eine kleine Änderung an, deren Diff Sie überprüfen. Wenn die Anfrage weiterhin direkt an Anthropic gesendet wird, überprüfen Sie, dass ANTHROPIC_API_KEY eine leere Zeichenfolge ist und dass der Helper GETVIBE_API_KEY lesen kann. Wenn Sie ein doppeltes /v1/v1/messages sehen, entfernen Sie /v1 aus der Basis-URL.
Welche Modelle funktionieren über Messages?
Der aktuelle Integrationsleitfaden von GetVibe führt Claude Opus 5.5, Claude Sonnet 5, DeepSeek V4.1 Flash, Gemini 3.8 Flash, GLM-5.3 und Kimi K3 als Beispiele für Modelle auf, die über die Anthropic-Messages-Route unterstützt werden. Prüfen Sie den aktuellen Modellkatalog, bevor Sie einen Slot ändern; die Protokollunterstützung ist modellspezifisch. GPT-6 Luna, GPT-6 Sol und GPT-6.1 Sol funktionieren nicht über den Messages-Endpunkt von Claude Code. Verwenden Sie stattdessen Codex CLI für diese Responses-kompatiblen Modelle. Der am 3. Oktober 2026 geprüfte öffentliche Katalog-Snapshot zeigt für Sonnet 5.5 $0.168 Eingabe · $0.84 Ausgabe pro 1 Mio. Tokens pro Million Tokens; der angezeigte Preis bleibt aktuell.
Weisen Sie die Modell-Slots bewusst zu
Claude Code unterstützt Opus-, Sonnet- und Haiku-Slots. Das Einstellungsbeispiel von GetVibe wählt aktuelle IDs für diese Slots und verwendet CLAUDE_CODE_SUBAGENT_MODEL für Subagent-Aufgaben. Ändern Sie jeweils nur einen Slot. Fragen Sie nach dem Neustart des CLI mit /status, welches Modell aktiv ist, und führen Sie einen harmlosen Test-Prompt aus. Gehen Sie nicht davon aus, dass ein OpenAI-Modell in einen Claude-Slot gehört: Protokoll und Verarbeitung der Modellfamilie unterscheiden sich.
Vergleichen Sie für die Kosten Sonnet und Opus bei derselben Aufgabe, demselben Repository-Snapshot, denselben Berechtigungen und derselben Ausgabeanforderung. Erfassen Sie alle Agent-Runden und Reparaturschritte. Der aktuelle Preis für Sonnet 5.5 wird mit $0.168 Eingabe · $0.84 Ausgabe pro 1 Mio. Tokens pro Million Eingabe- und Ausgabetokens angegeben. Das Datum des Katalog-Snapshots ist der 3. Oktober 2026; verwenden Sie beim Budgetieren einer neuen Sitzung die verlinkte Modellseite.
Halten Sie lange Sitzungen unter Kontrolle
Agent-Sitzungen erzeugen wiederholten Kontext. Halten Sie Anweisungen prägnant, schließen Sie Build-Artefakte und vendored Verzeichnisse aus und bitten Sie den Agenten nicht, große Dateien erneut zu lesen, wenn eine fokussierte Dateiliste ausreicht. Claude-Anfragen können Cache-Breakpoints verwenden; GetVibe dokumentiert das Caching-Verhalten in der Caching-Dokumentation. Halten Sie den Präfix stabil und prüfen Sie die Nutzungsfelder, um festzustellen, ob gecachter Input tatsächlich gemeldet wird. Betrachten Sie eine niedrigere theoretische Cache-Rate nicht als Einsparung, bevor die Sitzung Cache-Lesevorgänge zeigt.
Legen Sie eine klare Aufgabengrenze fest, verwenden Sie normale Berechtigungsabfragen und überprüfen Sie Befehle und Diffs. Ein niedriger Tokenpreis macht einen unsicheren Shell-Befehl nicht sicher. Verwenden Sie für wiederholbare Benchmark-Vergleiche für jedes Modell denselben Berechtigungsmodus und denselben Toolzugriff.
Häufige Fehler bei der Einrichtung
- 401: Überprüfen Sie
GETVIBE_API_KEY, die Ausgabe des Helpers und den leeren Wert vonANTHROPIC_API_KEY. - Der Datenverkehr umgeht GetVibe: Überprüfen Sie die Zugangsdaten in Ihrem Shell-Profil und verifizieren Sie die Basis-URL mit
/status. - Modell nicht verfügbar: Kopieren Sie eine exakt aktuelle ID und überprüfen Sie die Messages-Kompatibilität auf der Modellseite.
- Fehlerhafte URL: Setzen Sie die Root-Domain ohne
/v1; Claude Code fügt das Routen-Suffix hinzu.
Erstellen Sie eine Kostenbasis
Führen Sie vor dem Rollout eine kurze Aufgabe und eine realistische Änderung an mehreren Dateien aus. Erfassen Sie die Modell-ID, die Input- und Output-Nutzung, gegebenenfalls Cache-Lesevorgänge, die verstrichene Zeit und ob die Tests erfolgreich sind. Bewahren Sie den Schlüssel in einem Secret Manager auf und richten Sie einen internen Alarm ein. Diese Beobachtungen liefern dem Team eine tatsächliche Kostenbasis pro Änderung, statt anzunehmen, dass jede Coding-Sitzung denselben Kontext verbraucht. Der aktuelle Preis kann auf der Modellseite von Sonnet 5.5 überprüft werden.
Halten Sie die Modell-Slots explizit
Claude Code verfügt über Opus-, Sonnet- und Haiku-Slots. Konfigurieren Sie nur die Slots, die Ihr Team verwenden möchte, und bestätigen Sie nach einer Änderung der Einstellungen mit /status die aktive Auswahl. Der Name eines Claude-Slots ist kein Protokolladapter: Ein ausschließlich für OpenAI verfügbares Modell wird nicht Messages-kompatibel, nur weil es dem Sonnet-Slot zugewiesen wird.
Messen Sie das Caching in einer echten Sitzung
Führen Sie eine kurze Aufgabe und eine Aufgabe mit mehreren Dateien unter Verwendung derselben stabilen Anweisungen aus. Vergleichen Sie die Cache-Read-Nutzung in späteren Runden und erfassen Sie die Gesamtkosten der Sitzung. Behalten Sie Berechtigungen, Repository-Snapshot und Modell-Slot zwischen wiederholten Versuchen unverändert bei; andernfalls lässt sich anhand des Vergleichs nicht feststellen, ob ein Kostenunterschied durch Caching, zusätzliche Tool-Aufrufe oder eine andere Aufgabe entstanden ist.
Schützen Sie Änderungen und Zugangsdaten
Verwenden Sie für die erste Aufgabe mit Schreibzugriff einen temporären Worktree, überprüfen Sie Befehle und Diffs und bewahren Sie Zugangsdaten in einem von der Shell verwalteten Secret auf. Wenn ein Schlüssel in der Terminalhistorie oder einer gemeinsam genutzten Einstellungsdatei landet, ersetzen Sie ihn. Diese einfachen Grenzen ermöglichen es Entwicklern, den Agenten zu erkunden, ohne jedem Prompt Zugriff auf Produktionsdaten oder einen nicht überprüften Arbeitsbaum zu geben.