Claude Code und Codex APIs: Protokoll, Einrichtung und erster Test

Ein Label wie „OpenAI-compatible“ genügt nicht für beide Tools. Claude Code erwartet den Anthropic-Messages-Vertrag; ein eigener Codex-Provider verwendet die OpenAI Responses API. Prüfen Sie daher erst Dokumentation, Base URL, Authentifizierung und aktuelle Model ID – erst danach Preise.

Für einen Test mit BetterToken nutzen Sie die aktuelle Claude-Code-Anleitung oder Codex-Anleitung. Die beiden Wege verwenden getrennte, protokollspezifische Endpunkte und einen API Key aus Ihrem eigenen Konto. Nach einem kurzen Request lassen sich Status, Modell, Input-/Output-/Cache-Token und Belastung in Dashboard kontrollieren.

Zwei unterschiedliche Konfigurationsverträge

Tool	Erforderlicher Vertrag	Bei BetterToken prüfen
Claude Code	Anthropic-kompatible Messages und dokumentierte Zugangsdaten	https://bettertoken.ai; der Client ergänzt /v1/messages
Codex CLI/App	Custom Provider für Responses, nicht nur Chat Completions	https://www.bettertoken.ai/v1 mit wire_api = "responses"

Claude Code verwendet laut aktueller Anleitung ANTHROPIC_BASE_URL und ANTHROPIC_AUTH_TOKEN. Hängen Sie kein /v1 an: Claude Code ergänzt den Messages-Pfad selbst. Codex liest einen Custom Provider aus ~/.codex/config.toml und den Key aus BETTERTOKEN_API_KEY.

Die OpenAI-Referenz zur Codex-Konfiguration sowie die Claude-Code-Dokumentation sind die Primärquellen für die Clients. Die konkreten Provider-Werte müssen immer in dessen aktueller Anleitung geprüft werden.

Minimale Prüfung

model_provider = "custom"
model = "YOUR_MODEL_ID"

[model_providers.custom]
base_url = "https://www.bettertoken.ai/v1"
env_key = "BETTERTOKEN_API_KEY"
wire_api = "responses"
requires_openai_auth = false

YOUR_MODEL_ID bleibt bewusst ein Platzhalter: Modellverfügbarkeit und IDs ändern sich. Kopieren Sie eine vollständige aktuelle ID aus Setup-Dialog oder Modellkatalog und legen Sie keinen Custom-Provider-Key in ~/.codex/auth.json ab.

Für Claude Code prüfen Sie stattdessen diese Protokollwerte:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://bettertoken.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
  }
}

Der Speicherort und optionale Felder gehören in die aktuelle Claude-Code-Anleitung. API Keys gehören nie in Prompts, Issues, Screenshots oder Repositories.

Erst kurz testen

1. Öffnen Sie die aktuelle Anleitung für Ihre Client-Version.
2. Erzeugen Sie einen eigenen Test-Key, keinen geteilten Zugang.
3. Übernehmen Sie Base URL und Model ID aus aktueller Dokumentation oder Dashboard.
4. Prüfen Sie bei Claude Code Route und Authentifizierung, bei Codex Provider, Umgebungsvariable und wire_api = "responses".
5. Starten Sie in einem leeren Repository ohne Produktionsgeheimnisse.
6. Senden Sie eine kleine, begrenzte Aufgabe.
7. Notieren Sie Status, Modell, Token, sichtbare Wiederholungen und Endbetrag. Wiederholen Sie danach dieselbe repräsentative Aufgabe unter gleichen Bedingungen.

Kosten und erste Fehler

Ein Input-Token-Preis ist nicht die Kosten einer Agent-Aufgabe. Projektkontext, Tool-Ausgaben, Cache, Wiederholungen und Output ändern die Rechnung. Pro Kandidat gehören Model ID, Input-/Output-/Cache-Token, Request-Anzahl, Fehler, Wiederholungen und Endbetrag in dasselbe Testprotokoll. Live-Daten von BetterToken stehen auf der Preisseite; alte Preislisten sind nur historisch.

Symptom	Zuerst prüfen
401	Key, Feldname und unerwünschte Leerzeichen
404 / Verbindungsfehler	Base URL passend zum Protokoll, kein vollständiger Request-Pfad
model not found	Vollständige aktuelle Model ID desselben Providers und derselben Key-Gruppe
Codex API-Mode-Fehler	wire_api = "responses", nicht nur Chat Completions
429	Endpoint-Limit, Retry-After und sichere Wiederholung
Streaming-Abbruch	Streaming-Support, Netzwerk und Request-Status
Unklare Belastung	Modell, Token-Aufzeichnung und Wiederholungen

Ändern Sie nur einen Parameter je Test. Das ergibt eine Diagnose statt eines unklaren Komplettwechsels.

Entscheidung anhand von Aufzeichnungen

Die Checkliste ist kein Ranking für Geschwindigkeit, Stabilität oder den niedrigsten Preis. Sie prüft zwei verschiedene Client-Verträge. Lesen Sie die aktuelle Dokumentation am Testtag und entscheiden Sie nach einer gleichen Repository-Aufgabe anhand von Ergebnis, Fehlern, Token-Aufzeichnung und Endbetrag.

Öffnen Sie dafür die BetterToken-Claude-Code-Anleitung oder Codex-Anleitung, erstellen Sie einen separaten Key und prüfen Sie den ersten Request in Dashboard, bevor produktive Arbeit folgt.