Tool Integrations29. Juni 2026Flatkey

Claude Code API-Router-Setup: Base URL, Modelle und Nutzungsprotokolle

Ein Claude Code API-Router-Setup ist nicht dasselbe wie das Ändern einer OpenAI SDK Base URL. Claude Code verwendet das Format des Anthropic Messages Gateways. Wichtige Prüfungen sind daher der Router-Root, der Credential-Header, der von Claude Code gesendete Modellname und die Nutzungsprotokolle, die den Eingang von Anfragen bestätigen.

Ein Claude-Code-API-Router-Setup ist nicht dasselbe wie das Ändern einer OpenAI-SDK-Basis-URL. Claude Code spricht die Gateway-Form von Anthropic Messages, daher sind die wichtigen Prüfungen der Router-Root, der Anmeldeinformations-Header, der Modellname, den Claude Code senden wird, und die Nutzungsaufzeichnungen, die beweisen, dass Anfragen das richtige Konto erreichen.

Dieser Leitfaden bietet ein produktionsorientiertes Flatkey-Setup für Entwickler, KI-Produktteams, Automatisierungsentwickler, Plattform-Ingenieure, Finanzverantwortliche und Beschaffungsprüfer. Er behandelt die Basis-URL, den Ein-Token-Preflight, Modellnamen, die Gateway-Modellerkennung, Nutzungsprotokolle und Fehlermodi, bevor Sie die tägliche Programmierarbeit auf einen Claude-Code-API-Router umstellen.

Quellenhinweis: Dies wurde am 29. Juni 2026 mit der offiziellen Claude Code LLM-Gateways-Dokumentation, der Claude Code Gateway-Verbindungsanleitung, der Gateway-Protokollreferenz, der Modellkonfigurationsdokumentation, der Überwachungsdokumentation und den aktuellen öffentlichen Flatkey-Seiten abgeglichen. Für einen Live-Smoke-Test von Claude Code wurde kein kontospezifischer Flatkey-Schlüssel verwendet, daher sind die folgenden Snippets Vorlagen, die Sie mit Ihrem eigenen Schlüssel und einem genehmigten Modell ausführen können.

Schnelle Antwort: Claude-Code-API-Router-Setup

Für ein Claude-Code-API-Router-Setup mit Flatkey konfigurieren Sie Claude Code mit dem Flatkey-Claude-Code-Router-Root, einem Flatkey-Schlüssel und einem exakten Claude-Modellnamen, den Ihr Konto aufrufen kann. Testen Sie dann den Anthropic-Messages-Endpunkt, bevor Sie eine lange Programmiersitzung beginnen.

Einrichtungsfeld	Flatkey-Wert oder -Prüfung	Warum es wichtig ist
Basis-URL	`https://router.flatkey.ai` für den Claude-Code-Anwendungsfall, es sei denn, Ihr Flatkey-Konto zeigt einen neueren, Claude-Code-spezifischen Wert an	Claude Code hängt `/v1/messages` an. Fügen Sie keine OpenAI-SDK-Basis ein, die auf `/v1` endet, es sei denn, Ihr Test bestätigt, dass dadurch nicht `/v1/v1/messages` erstellt wird.
Anmeldeinformation	`ANTHROPIC_AUTH_TOKEN` für Bearer-Token-Routing oder `ANTHROPIC_API_KEY`, wenn das Gateway `x-api-key` erwartet	Die offiziellen Claude-Code-Dokumente ordnen jede Variable einem anderen HTTP-Header zu. Ein funktionierender Schlüssel in der falschen Variable gibt immer noch `401` zurück.
Endpunkt-Preflight	`$ANTHROPIC_BASE_URL/v1/messages`	Die aktuelle Preisseite von Flatkey listet `/v1/messages` in der Endpunkt-Map auf, was der Pfad ist, den Claude Code für den Anthropic-Messages-Verkehr benötigt.
Modell	Verwenden Sie eine exakte Claude-Modell-ID oder einen Claude-Code-Alias, der zu einer aktivierten Flatkey-Route aufgelöst wird	Die Modellauswahl ist vom Basis-URL-Routing getrennt. Der Router entscheidet, wohin der Verkehr geleitet wird; Claude Code sendet weiterhin einen Modellnamen.
Nutzungsnachweis	Überprüfen Sie die Flatkey-Nutzung und die Claude-Code-Telemetrie nach dem ersten Prompt	Eine erfolgreiche Ausgabe reicht nicht aus. Teams benötigen Nachweise für Schlüssel, Modell, Zeitstempel, Sitzung, Kosten und Token.

Das ist die Kurzversion. Der Rest dieses Claude-Code-API-Router-Leitfadens verwandelt diese Felder in ein wiederholbares Setup-Runbook.

Was die offiziellen Claude-Code-Gateway-Dokumente bestätigen

Die offizielle Claude-Code-Gateway-Übersicht definiert ein LLM-Gateway als einen Proxy zwischen Claude Code und einem Modellanbieter. Claude Code sendet API-Verkehr an das Gateway, und das Gateway leitet ihn mit einer vom Unternehmen kontrollierten Anbieter-Anmeldeinformation weiter. Dieselbe Seite listet Gateway-Vorteile wie zentralisierte Anmeldeinformationen, Nutzungsverfolgung, Kostenkontrollen, Audit-Protokollierung und Anbieterwechsel auf.

Die Basis-URL-Regel ist spezifisch. Normalerweise sendet Claude Code Anfragen an die API von Anthropic, aber das Setzen von ANTHROPIC_BASE_URL leitet diese Anfragen stattdessen an das Gateway. Die Verbindungsanleitung verifiziert dann die Route durch einen POST-Request an $ANTHROPIC_BASE_URL/v1/messages mit anthropic-version: 2023-06-01.

Die Gateway-Protokollreferenz fügt die betreiberseitigen Details hinzu. Für das Anthropic-Messages-Format muss ein über ANTHROPIC_BASE_URL ausgewähltes Gateway /v1/messages und optional /v1/messages/count_tokens bedienen. Es besagt auch, dass Inferenz-Antworten gestreamt werden müssen, da Claude Code Server-Sent Events bei ihrem Eintreffen konsumiert.

Für einen Claude-Code-API-Router bedeutet das, dass Sie den Anthropic-Messages-Pfad validieren sollten, nicht nur einen OpenAI-kompatiblen Chat-Completions-Pfad. Eine OpenAI-Route kann für andere Tools funktionieren, während Claude Code immer noch fehlschlägt, wenn /v1/messages, Streaming oder erforderliche Anthropic-Header fehlen.

Für dieses Setup verifizierte Flatkey-Werte

Die am 29. Juni 2026 überprüfte Homepage von Flatkey hat den Titel One API gateway for production AI teams und eine Meta-Beschreibung, die besagt, dass Flatkey den Modellzugriff, das Routing, die Abrechnung, die Nutzungsanalyse und die betrieblichen Kontrollen vereinheitlicht. Dieselbe Homepage zeigt immer noch Beispiele im OpenAI-Stil, die https://console.flatkey.ai/v1 und /v1/chat/completions verwenden, was für OpenAI-kompatible Tools nützlich ist, aber nicht dem Basis-URL-Muster von Claude Code entspricht.

Auf der aktuellen Anwendungsseite für Flatkey Claude Code steht, dass Claude Code mit https://router.flatkey.ai und einem Flatkey-API-Schlüssel konfiguriert wird. Außerdem werden Benutzer angewiesen, den Schlüssel unter https://console.flatkey.ai/keys zu erstellen oder zu kopieren, bevor sie das Installationsprogramm ausführen. Verwenden Sie diesen Claude-Code-spezifischen Router-Root für die manuelle Einrichtung unten, es sei denn, Ihr Flatkey-Konto gibt Ihnen einen neueren Wert an.

Die am 29. Juni 2026 überprüfte Preisseite von Flatkey veröffentlicht serverseitig gerenderte Preise für 635 KI-Modelle von 23 Anbietern. Die Endpunkt-Map enthält /v1/messages, /v1/chat/completions, /v1/responses, /v1/images/generations, /v1/video/generations und /v1beta/models/{model}:generateContent. Dieser Artikel behandelt dies als veralteten öffentlichen Nachweis für die Endpunktabdeckung, nicht als Garantie dafür, dass jedes Konto jedes Modell aufrufen kann.

Schritt-für-Schritt-Einrichtung mit Flatkey

Erstellen oder wählen Sie einen Flatkey-Schlüssel. Verwenden Sie einen Schlüssel, der der richtigen Person, dem richtigen Team oder der richtigen Umgebung gehört. Halten Sie ihn von Screenshots, Prompts, Repos und Issue-Kommentaren fern.
Beginnen Sie mit Shell-Exporten. Speichern Sie die Einstellungen erst dauerhaft, wenn der One-Token-Preflight funktioniert.
Verwenden Sie den Claude Code Router-Root. Für die aktuelle Flatkey Claude Code-Seite lautet dieser Wert https://router.flatkey.ai.
Wählen Sie die Anmeldeinformationsvariable. Verwenden Sie ANTHROPIC_AUTH_TOKEN, wenn der Schlüssel als Authorization: Bearer gesendet werden soll. Verwenden Sie ANTHROPIC_API_KEY nur, wenn das Gateway x-api-key erwartet.
Legen Sie ein Modell für den ersten Test fest. Verwenden Sie eine aktuelle Claude-Modell-ID, die für Ihr Flatkey-Konto aktiviert ist. Wenn das Modell in der Auswahl von Claude Code nicht sichtbar ist, verwenden Sie die Gateway-Erkennung oder fügen Sie eine benutzerdefinierte Modelloption hinzu, nachdem der Preflight funktioniert.
Führen Sie den curl-Preflight aus. Eine One-Token-Anfrage trennt das Flatkey-Routing vom UI-Status von Claude Code.
Starten Sie Claude Code aus derselben Shell. Dadurch erbt die CLI die Variablen, die Sie gerade getestet haben.
Führen Sie /status aus. Bestätigen Sie, dass die Zeile mit der Anthropic-Basis-URL den Flatkey-Router anzeigt und die Zeile mit den Anmeldeinformationen die von Ihnen festgelegte Variable benennt.
Senden Sie einen kleinen Prompt. Überprüfen Sie dann die Flatkey-Nutzung und die von Ihnen aktivierte Claude-Code-Telemetrie.

Shell-Einrichtung

export ANTHROPIC_BASE_URL="https://router.flatkey.ai"
export ANTHROPIC_AUTH_TOKEN="fk_replace_with_your_flatkey_key"
export ANTHROPIC_MODEL="claude-sonnet-4-6"

Wenn in Ihren Gateway-Anweisungen ausdrücklich x-api-key steht, tauschen Sie ANTHROPIC_AUTH_TOKEN gegen ANTHROPIC_API_KEY aus und aktualisieren Sie den Preflight-Header. Legen Sie für den ersten Test nicht beide fest; gemischte Anmeldeinformationsquellen erschweren die Isolierung von Fehlern.

Dauerhafte Einstellungen nach bestandenem Test

Nachdem der Shell-Test funktioniert, können Sie dieselben Variablen im env-Block von ~/.claude/settings.json platzieren. Legen Sie keine Anmeldeinformationen in einer committeten Projekt-Datei .claude/settings.json ab.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://router.flatkey.ai",
    "ANTHROPIC_AUTH_TOKEN": "fk_replace_with_your_flatkey_key",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6"
  }
}

Preflight der Messages-Route vor dem Start von Claude Code

Die schnellste Überprüfung des Claude Code API-Routers ist eine One-Token-Messages-Anfrage. Wenn dies fehlschlägt, korrigieren Sie den Flatkey-Schlüssel, die Basis-URL, den Netzwerkpfad oder das Modell, bevor Sie die Claude-Code-Einstellungen ändern.

curl -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1,
    "messages": [
      {"role": "user", "content": "."}
    ]
  }'

Eine JSON-Antwort, die mit einer Nachrichten-ID beginnt und ein Inhaltsfeld enthält, bedeutet, dass die Route und die Anmeldeinformationen funktionieren. Die offizielle Dokumentation weist auch darauf hin, dass ein Fehler wegen eines unbekannten Modells immer noch beweist, dass das Gateway die Anfrage authentifiziert hat, bevor es den Modellnamen zurückwies. Ein 401 bedeutet, dass die Anmeldeinformationen zurückgewiesen oder im falschen Header gesendet wurden.

Achten Sie sorgfältig auf die aufgelöste URL. Mit ANTHROPIC_BASE_URL=https://router.flatkey.ai erreicht der Test https://router.flatkey.ai/v1/messages. Wenn Ihr Befehl /v1/v1/messages erstellt, haben Sie eine Client-SDK-Basis-URL in ein Claude-Code-Gateway-Feld kopiert.

Modellnamen: Aliase, Erkennung und benutzerdefinierte Einträge

Modellnamen sind die zweithäufigste Ursache für Fehler beim Claude Code API-Router. Die Basis-URL sendet den Datenverkehr an Flatkey, aber Claude Code benötigt immer noch einen Modellwert, der in der Anfrage gesendet wird.

Die Dokumentation zur Modellkonfiguration besagt, dass Claude Code integrierte Modelleinstellungen wie default, best, sonnet, opus, haiku und Varianten mit langem Kontext wie sonnet[1m] und opus[1m] unterstützt. Dieselbe Dokumentation besagt, dass ANTHROPIC_MODEL nur für die Sitzung gilt, mit der Sie es starten, während /model eine interaktive Auswahl für spätere Sitzungen speichern kann.

Für eine Flatkey-Route lautet die sichere Regel, mit einer vollständigen Claude-Modell-ID zu beginnen, die Flatkey für Ihren Schlüssel aktiviert hat, und dann zu entscheiden, ob sie in der Auswahl angezeigt werden soll. Gehen Sie nicht davon aus, dass ein generischer Familienname, eine Marketingbezeichnung oder ein Titel einer Anbieterzeile als Anfragemodell-ID akzeptiert wird.

Anforderung an die Modelleinrichtung	Claude Code-Mechanismus	Flatkey-Prüfung
Test für eine einzelne Sitzung	`ANTHROPIC_MODEL` oder `claude --model`	Verwenden Sie eine Flatkey-fähige Claude-Modell-ID und halten Sie den Test klein.
Interaktive Auswahl	`/model`	Bestätigen Sie, dass der ausgewählte Name die tatsächliche ID ist, die Flatkey erwartet.
Vom Gateway bereitgestellte Modellliste	`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`	Das Gateway muss `/v1/models` unter der konfigurierten Basis-URL schnell bereitstellen.
Manuelle Eingabe im Picker	`ANTHROPIC_CUSTOM_MODEL_OPTION`	Verwenden Sie dies, wenn die Erkennung deaktiviert ist oder das benötigte Modell nicht zurückgibt.
Verfügbarkeits-Fallback	`--fallback-model` oder `fallbackModel`	Der Fallback behebt keine Fehler bei der Authentifizierung, Abrechnung, Ratenbegrenzung, Anforderungsgröße oder beim Transport.

Gateway-Modellerkennung

Claude Code kann beim Start den /v1/models-Endpunkt eines Gateways abfragen, wenn ANTHROPIC_BASE_URL auf ein Anthropic Messages-Gateway verweist und die Erkennung aktiviert ist. Die Protokolldokumentation besagt, dass die Anfrage GET /v1/models?limit=1000 mit einem 3-Sekunden-Timeout ist und Claude Code id sowie optional display_name aus der Antwort liest.

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1
claude --debug

Die Erkennung ist standardmäßig deaktiviert, damit ein gemeinsam genutzter Schlüssel nicht jedes erreichbare Modell jedem Benutzer zugänglich macht. Wenn die Erkennung fehlschlägt, greift Claude Code auf den zwischengespeicherten oder integrierten Picker zurück. Wenn Ihr Flatkey-Konto ein Modell unter einem Alias bereitstellt, den die Erkennung nicht anzeigt, fügen Sie stattdessen eine benutzerdefinierte Option hinzu.

Benutzerdefinierte Modelloption

export ANTHROPIC_CUSTOM_MODEL_OPTION="claude-sonnet-4-6"
export ANTHROPIC_CUSTOM_MODEL_OPTION_NAME="Sonnet via Flatkey"
export ANTHROPIC_CUSTOM_MODEL_OPTION_DESCRIPTION="Claude model routed through the Flatkey API router"

Die benutzerdefinierte Modelloption überspringt die clientseitige Validierung für diese Modell-ID und ist daher für einen kontrollierten Pilotversuch nützlich. Sie ist kein Ersatz für die Preflight-Anfrage. Wenn eine Organisations-Allowlist aktiv ist, fügen Sie die benutzerdefinierte Modell-ID auch dort hinzu.

Nutzungsprotokolle: Was nach der ersten Eingabe zu prüfen ist

Ein zuverlässiges Claude Code API-Router-Setup endet mit einem Nutzungsnachweis, nicht nur mit einer erfolgreichen Antwort. Laut der öffentlichen Positionierung von Flatkey werden Abrechnung, Nutzungsanalysen und Betriebskontrollen vereinheitlicht; die Claude Code Gateway-Dokumentation beschreibt ebenfalls die Nutzungsverfolgung und Kostenkontrolle als Vorteile des Gateways. Nutzen Sie beide Ebenen bewusst.

Protokollquelle	Was zu überprüfen ist	Warum es wichtig ist
Flatkey-Nutzung	Schlüsselinhaber, Zeitstempel, Modell, Endpunktfamilie, Token-Nutzung und Kostendatensatz, sofern verfügbar	Bestätigt, dass die Anfrage das beabsichtigte Gateway-Konto erreicht hat und von der Betriebs- oder Finanzabteilung abgeglichen werden kann.
Claude Code `/status`	Anthropic-Basis-URL und aktive Anmeldeinformationsquelle	Bestätigt, dass die laufende Sitzung die Flatkey-Route anstelle eines gespeicherten claude.ai-Logins verwendet.
OpenTelemetry-Metriken	`claude_code.cost.usage`, `claude_code.token.usage`, Sitzungsanzahl, aktive Zeit und Einstiegspunkt	Schafft Beobachtbarkeit auf Teamebene für Claude Code-Sitzungen.
OpenTelemetry-Protokolle/Ereignisse	Prompt-Ereignisse, Werkzeugergebnisse, API-Fehler und Kostenfelder, wenn konfiguriert	Hilft bei der Fehlersuche bei Fehlern auf Anforderungsebene, muss aber kontrolliert werden, da detaillierte Protokolle sensible Inhalte preisgeben können.
Gateway-Header	`x-claude-code-session-id`, Agenten-IDs und benutzerdefinierte Routing-Header	Ermöglicht die Gruppierung von Anfragen nach Sitzung oder Subagent, ohne die vollständigen Anforderungstexte zu parsen.

Für die Telemetrie von Claude Code aktivieren Sie OpenTelemetry nur mit einer bewussten Datenschutzeinstellung. Die Überwachungsdokumentation besagt, dass der Prompt-Text standardmäßig geschwärzt wird, während Einstellungen wie OTEL_LOG_USER_PROMPTS=1, OTEL_LOG_TOOL_DETAILS=1 und OTEL_LOG_RAW_API_BODIES sensible Details hinzufügen. Verzichten Sie auf die Protokollierung von rohen Body-Inhalten in der Standard-Entwicklerkonfiguration, es sei denn, Ihre Sicherheitsüberprüfung genehmigt dies.

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_RESOURCE_ATTRIBUTES="department=engineering,team.id=platform,cost_center=eng-123"

Verwenden Sie OTEL_RESOURCE_ATTRIBUTES für Felder mit geringer Kardinalität, die die Zuständigkeit angeben, wie Abteilung, Team-ID oder Kostenstelle. Vermeiden Sie vom Benutzer eingegebene Projektnamen oder Ticket-IDs als Labels, es sei denn, Ihr Observability-Backend kann die Kardinalität und die Auswirkungen auf den Datenschutz bewältigen.

Fehlermodi, die zuerst zu debuggen sind

Symptom	Wahrscheinliche Ursache	Erste Lösung
`401` oder ungültiges Token	Der Schlüssel wurde abgelehnt, ist abgelaufen, wurde in die falsche Variable kopiert oder in einem Header gesendet, den das Gateway nicht liest.	Wechseln Sie zwischen `ANTHROPIC_AUTH_TOKEN` und `ANTHROPIC_API_KEY` erst, nachdem Sie bestätigt haben, welchen Header Flatkey erwartet.
Verbindung abgelehnt oder Zeitüberschreitung	Falsche Basis-URL, blockierter Netzwerkpfad, VPN-Problem oder ein Router-Endpunkt, der vom Entwicklercomputer aus nicht erreichbar ist.	Führen Sie den curl-Preflight-Check durch und überprüfen Sie die URL anhand der Anweisungen Ihres Flatkey-Kontos.
Fehlerhafte Antwort mit HTTP 200	Eine Proxy- oder Anmeldeseite hat HTML anstelle von API-JSON zurückgegeben.	Überprüfen Sie den Antwortkörper des Preflight-Checks und korrigieren Sie die Gateway-Route, die nicht-JSON zurückgibt.
`400` mit Nennung von `context_management` oder zusätzlichen Feldern	Das Gateway hat Anfragefelder im Anthropic-Format an ein Upstream weitergeleitet, das diese ablehnt.	Leiten Sie das Beta-Header/Body-Paar korrekt weiter oder setzen Sie `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` als vorübergehende Maßnahme.
`400` mit Nennung von `thinking` oder `adaptive`	Der Upstream-Modell-Build akzeptiert kein adaptives Reasoning, das für neuere Claude-Modelle angefordert wird.	Aktualisieren Sie die Upstream-Route oder verwenden Sie das dokumentierte Flag zum Deaktivieren des adaptiven Denkens nur dort, wo es zutrifft.
Modell fehlt in `/model`	Das Modell ist nicht in der integrierten Auswahl von Claude Code enthalten und die Erkennung ist deaktiviert oder schlägt fehl.	Aktivieren Sie die Gateway-Modellerkennung oder fügen Sie `ANTHROPIC_CUSTOM_MODEL_OPTION` hinzu.
Claude Code fragt nach der Anmeldung, nachdem curl erfolgreich war	Die CLI hat keine Anmeldeinformationen erhalten, wo die Ersteinrichtung sie lesen kann.	Legen Sie die Anmeldeinformationen vor dem Start in der Shell, in `~/.claude/settings.json` oder in den verwalteten Einstellungen fest.
Nutzung kann nicht abgeglichen werden	Im Setup fehlen Schlüsselbesitzer, Modellname, Umgebung, Sitzungs-ID oder Telemetrie-Labels.	Fügen Sie eine Runbook-Zeile hinzu, bevor weitere Entwickler die Route verwenden.

Checkliste für die Produktion für Teams

Bevor Sie einen Claude Code API-Router teamweit standardisieren, dokumentieren Sie die betrieblichen Fakten, die für eine zukünftige Störungs- oder Finanzprüfung benötigt werden.

Checklistenpunkt	Dies aufzeichnen
Basis-URL	Der genaue Wert, der in der Shell, den verwalteten Einstellungen, den VS Code-Einstellungen, CI oder der Agent SDK-Konfiguration gespeichert ist.
Quelle der Anmeldeinformationen	Flatkey-Schlüsselbesitzer, Umgebung, Rotationsverantwortlicher und ob er statisch ist oder von einem `apiKeyHelper` stammt.
Modellnamen	Angeforderte Modell-ID, Auswahlbezeichnung, Fallback-Kette, Whitelist-Regel und Testdatum.
Endpunktnachweis	Ein-Token-Ergebnis von `/v1/messages`, Anforderungszeitstempel und jede vom Gateway zurückgegebene Anforderungs-ID.
Nutzungsüberprüfung	Flatkey-Nutzungsansicht, Claude Code-Telemetrie-Backend, Labels und Dashboard-Besitzer.
Datenschutz-Gates	Ob Prompts, Werkzeugdetails, rohe API-Bodys oder Werkzeuginhalte in der Telemetrie erlaubt sind.
Rollback	Vorheriger Claude Code-Login oder Anbieterpfad, vorheriges Modell und wer die Gateway-Variablen zurücksetzen kann.

Interner Migrationspfad

Wenn Flatkey zur gemeinsamen Route für mehrere Entwicklerwerkzeuge wird, halten Sie das Claude Code-Setup auf den Rest des Integrationsclusters abgestimmt. Verwenden Sie den Leitfaden zur Migration von OpenAI-kompatiblen APIs für SDK-Basis-URL-Muster, aber denken Sie daran, dass Claude Code die Anthropic Messages-Route anstelle von /v1/chat/completions verwendet.

Für das Desktop-Client-Setup vergleichen Sie den Cherry Studio API-Setup-Leitfaden. Für Routing-Muster auf Entwicklermaschinen, die an Claude Code angrenzen, siehe das cc-switch Claude Code-Setup. Nachdem der erste Prompt funktioniert, überprüfen Sie die Flatkey-Modellpreise und holen Sie sich einen Schlüssel für jede zusätzliche Umgebung, die eine separate Anmeldeinformationsgrenze benötigt.

FAQ

Welche Basis-URL sollte ich für einen Claude Code API-Router mit Flatkey verwenden?

Verwenden Sie den für Ihr Konto angezeigten Claude Code-spezifischen Flatkey-Router-Root. Am 29. Juni 2026 stand auf der Anwendungsseite von Flatkey für Claude Code, dass Claude Code mit https://router.flatkey.ai konfiguriert ist. Der Preflight-Check sollte genau einen /v1/messages-Pfad erreichen.

Sollte ich `ANTHROPIC_AUTH_TOKEN` oder `ANTHROPIC_API_KEY` verwenden?

Verwenden Sie ANTHROPIC_AUTH_TOKEN, wenn das Gateway ein Bearer-Token im Authorization-Header erwartet. Verwenden Sie ANTHROPIC_API_KEY, wenn es x-api-key erwartet. Wenn Sie geraten haben und einen 401-Fehler erhalten, tauschen Sie die Variablen aus und testen Sie erneut.

Kann ich eine OpenAI-kompatible Flatkey-Basis-URL für Claude Code verwenden?

Nicht direkt als kopiertes Feld. OpenAI-kompatible Tools verwenden oft eine Basis-URL, die auf /v1 endet, während Claude Code /v1/messages an ANTHROPIC_BASE_URL anhängt. Verwenden Sie den Flatkey Claude Code-Router-Wert und überprüfen Sie die endgültige URL.

Wie füge ich Flatkey-Modelle zur Modellauswahl von Claude Code hinzu?

Aktivieren Sie CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1, wenn das Gateway /v1/models bereitstellt, oder fügen Sie eine manuelle Auswahlzeile mit ANTHROPIC_CUSTOM_MODEL_OPTION hinzu. Bestätigen Sie in beiden Fällen, dass die genaue Modell-ID für Ihren Flatkey-Schlüssel aktiviert ist.

Welche Nutzungsprotokolle sollte ich nach der Einrichtung überprüfen?

Überprüfen Sie die Flatkey-Nutzung auf Schlüssel, Modell, Endpunktfamilie, Zeitstempel, Token und Kosten, sofern verfügbar. Verwenden Sie auch Claude Code /status und OpenTelemetry-Metriken wie claude_code.cost.usage und claude_code.token.usage, wenn die Organisationstelemetrie aktiviert ist.

Fazit

Ein zuverlässiges Claude Code API-Router-Setup hat vier Prüfpunkte: die Flatkey Claude Code-Basis-URL, den korrekten Anmeldeinformations-Header, einen getesteten Modellnamen und einen Nutzungspfad, den Finanz- und Plattformteams überprüfen können. Beginnen Sie mit einem Preflight von /v1/messages mit einem Token, bestätigen Sie /status und skalieren Sie die Route erst, nachdem Protokolle und Rollback dokumentiert sind. Wenn Sie bereit sind, Claude Code über ein gemeinsames Gateway zu leiten, holen Sie sich einen Schlüssel und testen Sie zuerst den kleinsten Prompt.