Codex CLI mit API-Schlüssel – Konfiguration, Modelle und Sitzungskosten

Das Codex CLI ist der Open-Source-Coding-Agent der OpenAI für das Terminal und funktioniert sowohl mit einer ChatGPT-Anmeldung als auch mit einem API-Schlüssel. Der API-Schlüssel-Weg ist der wichtige Teil: Er wird pro Token ohne Monatsgebühr abgerechnet und ist der einzige Weg, die CLI auf einen anderen Anbieter — oder eine andere Modellfamilie — zu richten. Dieser Leitfaden enthält die funktionierende Konfiguration, die Voraussetzung, an der die meisten Gateways scheitern, die Kosten einer Sitzung und wie du aus Brasilien per Pix bezahlst.

Die einzige Voraussetzung, die zählt

Das Codex CLI spricht die Responses-API von OpenAI, und nur diese: Der Block model_providers akzeptiert ausschließlich wire_api = "responses". Ein Gateway, das nur /v1/chat/completions anbietet, kann schlicht nicht konfiguriert werden — deshalb scheitern viele „OpenAI-kompatible“ Endpunkte hier. Kunavo stellt POST /v1/responses zusammen mit dem Chat-Endpunkt bereit, daher funktioniert der folgende Block ohne Anpassung.

Die Konfiguration

# ~/.codex/config.toml
model          = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"
wire_api = "responses"

env_key ist der Name der Umgebungsvariable, nicht der Schlüssel: Codex speichert den Schlüssel niemals in der Konfigurationsdatei.

# O Codex lê a chave da variável indicada em env_key.
export KUNAVO_API_KEY="sk-kn-..."     # crie em kunavo.com/app/keys

# Deixe persistente (escolha o arquivo que o seu shell realmente carrega):
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

codex "explique a estrutura deste repositório"

Erstelle den Schlüssel im Dashboard, nachdem du dich registriert und $10 aufgeladen hast — er wird nur einmal angezeigt.

Aus Brasilien bezahlen — Pix ohne internationale Karte

Für brasilianische Entwickler ist selten die TOML-Datei das Hindernis, sondern die Zahlungsmethode. Die direkte Bezahlung der OpenAI-API erfordert eine für internationale Käufe freigeschaltete internationale Kreditkarte. Bei Kunavo wird der Checkout von Stripe verarbeitet, und Pix wird für Zahlungen aus Brasilien als Zahlungsmethode angezeigt – Betrag in Real und sofortige Gutschrift. Internationale Karten (Visa, Mastercard, American Express), Apple Pay und Google Pay bleiben für alle verfügbar, die diese bevorzugen.

Die Preise pro Token sind in USD angegeben: Bei Pix zeigt Stripe die Umrechnung in Reais zum Zahlungszeitpunkt an; bei Kartenzahlung richtet sich die Umrechnung nach dem Kurs des Kartenherausgebers (prüfen Sie IOF und die Gebühr für internationale Transaktionen in der Banking-App) — die Schritt-für-Schritt-Anleitung zum Aufladen per Pix finden Sie im Leitfaden zur Bezahlung der API mit Pix. Das Guthaben ist vorausbezahlt — Mindestaufladung von $10, ohne Abonnement und ohne automatische Verlängerung, mit einem Guthaben, das niemals verfällt.

Welches Modell sollte ich verwenden?

gpt-5-6-sol ist das für Code optimierte GPT und der natürliche Standard dieser CLI, $2.00 / $12.00 pro 1 Mio. Token gegenüber $5.00 / $30.00 zum Listenpreis von OpenAI — das heute den Aktionspreis von $4.00 / $20.00 berechnet, der laut Preisseite mindestens bis 21. November 2026 verfügbar ist. Die vollständigen Preise finden Sie auf der Preisseite.

Claude-Modelle in der Codex CLI ausführen

Das ist oft überraschend: Die Codex CLI ist an das Protokoll, nicht an das Modell gebunden. Sie verwendet das Responses-Format, und jedes Chatmodell hinter diesem Endpunkt kann antworten. Verweisen Sie auf claude-opus-5, und es läuft vollständig durch — einschließlich Tool-Aufrufen, sodass der Agent weiterhin Dateien liest, Bearbeitungen vorschlägt und Befehle ausführt.

# Mesmo bloco de provider, outro modelo — sem chave nova, sem config nova.
model          = "claude-opus-5"
model_provider = "kunavo"

[model_providers.kunavo]
name     = "kunavo"
base_url = "https://api.kunavo.com/v1"
env_key  = "KUNAVO_API_KEY"
wire_api = "responses"

Das Gateway übersetzt die Responses-Anfrage in die native Anthropic-Messages-API und die Antwort zurück in das Responses-Format. Eine ehrliche Einschränkung: Codex sendet undurchsichtige reasoning-Elemente, die nur ein natives Responses-Modell verarbeiten kann; auf dem Weg zu einem Upstream, der nicht GPT ist, werden sie verworfen. Das Modell verliert den privaten Entwurf des vorherigen Turns; die sichtbare Transkription, von der es ausgeht, bleibt vollständig erhalten. In der Praxis kostet das bei langen Schlussfolgerungsketten etwas Kontinuität, bei den üblichen Schleifen aus Bearbeiten, Ausführen und Korrigieren jedoch nichts.

Wenn Sie ausdrücklich Claude möchten, wurde Claude Code dafür entwickelt und übergibt cache_control ohne Übersetzung. Wenn Sie jedoch die Sandbox der Codex CLI bevorzugen und Claude dahinter einsetzen möchten, ist diese Kombination möglich.

Was kostet eine Sitzung?

Agentische CLIs senden den System-Prompt, den Aufgabenverlauf und den Dateikontext bei jedem Schritt erneut, sodass sich die Token schneller summieren, als die Anzahl der Schritte vermuten lässt. Ein typischer Schritt umfasst etwa 25.000 Input- und 1.200 Output-Token:

Das bedeutet: Eine Pix-Aufladung von $10 deckt etwa 8 agentische Aufgaben mit 20 Schritten ab. Fehlgeschlagene Anfragen werden außerdem nicht berechnet — ein 5xx-Fehler mitten in einer Sitzung erscheint nicht als Rechnungsposition.

Wenn etwas nicht funktioniert

Bevor Sie Codex die Schuld geben, prüfen Sie, ob Schlüssel und Endpunkt antworten:

# Confirme a chave e o endpoint antes de culpar o Codex.
curl https://api.kunavo.com/v1/responses \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5-6-sol",
    "input": "Responda OK e nada mais."
  }'

• 404 — der Anbieter implementiert /v1/responses nicht, oder base_url enthält bereits /responses. Codex ergänzt den Pfad selbst: Die Basis-URL endet mit /v1.
• 401 — die in env_key angegebene Variable ist in der Shell leer, aus der Codex gestartet wurde. Prüfen Sie dies mit echo $KUNAVO_API_KEY im selben Terminal.
• 402 — unzureichendes Guthaben: Laden Sie unter billing Guthaben auf (Pix wird sofort gutgeschrieben).
• model_not_found — der Modell-Slug ist im Katalog nicht vorhanden; prüfen Sie /models.

Häufig gestellte Fragen