Codex-Anleitung – Codex CLI installieren, ohne Abo mit API-Schlüssel arbeiten und was eine Aufgabe kostet

Codex ist OpenAIs KI-Programmieragent (coding agent). Die grundlegendste Nutzung besteht darin, die im Terminal ausgeführte Codex CLI zu installieren (npm install -g @openai/codex), sie im zu bearbeitenden Projektordner mit codex zu starten und anschließend auf Deutsch zu beschreiben, was sie tun soll. Es gibt zwei Wege: Anmeldung mit einem ChatGPT-Tarif (Plus, Pro, Business usw.) und Nutzung innerhalb des Tarifkontingents oder Ausführung mit einem API-Key und Zahlung nach Token. Anleitungen auf Deutsch beschreiben fast immer nur den ersten Weg; dieser Artikel ergänzt den zweiten – die Konfiguration für Codex CLI ohne Abonnement, die Modellauswahl nach Aufgabe und die tatsächlichen Kosten einer Aufgabe.

Codex ist kein Werkzeug, in das man Code in ein Chatfenster einfügt, sondern ein Agent, der im Projekt Dateien liest und ändert sowie Tests und Befehle ausführt. Welche Aktionen ohne Bestätigung ausgeführt werden dürfen, legen Sie nach dem Start mit /permissions fest.

Die zwei Möglichkeiten, Codex zu verwenden

Bei der Nutzung mit einem API-Key werden die Kosten getrennt vom ChatGPT-Tarifkontingent berechnet. Sie können direkt einen OpenAI-API-Key verwenden; hier geht es jedoch um einen Responses-API-kompatiblen Endpunkt. Mit demselben Key können Sie zwischen GPT-6 Astra und GPT-5.6 Terra wechseln. Zum Beispiel beträgt der offizielle OpenAI-Preis für GPT-5.6 Sol $5.00 / $30.00(OpenAI bietet das Modell derzeit zum Aktionspreis von $4.00 / $20.00 an; auf der offiziellen Preisseite steht, dass dieser mindestens bis 21. November 2026 gilt); hier kostet es pro 1M Token $2.00 / $12.00 (der Tarif wird direkt aus dem Katalog dieser Website ausgelesen und nicht manuell eingetragen).

Codex CLI installieren – npm oder Homebrew

# npm（有 Node.js 就能用，macOS / Linux / Windows 通用）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Beide Varianten sind in der offiziellen OpenAI-README als Installationswege aufgeführt; unter Windows funktioniert ebenfalls derselbe npm-Befehl. Nach der Installation starten Sie Codex im Projektordner mit codex. Wenn Sie sich über ChatGPT anmelden möchten, ist die Einrichtung hier abgeschlossen und Sie können die folgenden Schritte überspringen.

Mit API-Key ausführen – einen Block in config.toml hinzufügen

Registrieren Sie zunächst ein Konto, laden Sie mindestens $10 auf und erstellen Sie anschließend unter API-Key-Seite einen Key. Der Key wird nur einmal angezeigt, speichern Sie ihn daher sofort. Fügen Sie danach in der Codex-Konfigurationsdatei einen Anbieterblock hinzu:

# ~/.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"        # 唯一有效的值，省略也一樣

Am häufigsten wird env_key falsch eingetragen: Hier gehört nicht der Key selbst, sondern der Name der Umgebungsvariable hinein, in der der Key gespeichert ist. Der Key erscheint nicht in der Konfigurationsdatei, daher können Sie config.toml problemlos in git einchecken oder in einem Forum posten, um eine Frage zu stellen.

# 把金鑰放進 env_key 指定名稱的變數（金鑰以 sk-kn- 開頭）
export KUNAVO_API_KEY="sk-kn-..."

# 寫進 shell 的設定檔，就不必每次都 export
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

In Windows PowerShell können Sie setx KUNAVO_API_KEY sk-kn-... ausführen und anschließend ein neues Terminal öffnen; die Konfigurationsdatei befindet sich unter %USERPROFILE%\.codex\config.toml. Senden Sie vor dem Start von Codex zunächst eine Anfrage, um Key und Endpunkt zu überprüfen. Wenn später ein Fehler auftritt, lässt sich die Ursache so leichter eingrenzen.

# 懷疑 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": "只回 OK"}'

Eine zurückgegebene JSON-Antwort bedeutet, dass Key und Endpunkt funktionieren; das verbleibende Problem liegt in config.toml. Die Beschreibung der einzelnen Konfigurationsfelder finden Sie in der Codex-CLI-Integrationsdokumentation (Englisch); auch der Aufruf von Claude-Modellen in Codex wird im Leitfaden für API-Keys der Codex CLI (Englisch) beschrieben.

Die erste Aufgabe

# 1. 進到要處理的專案資料夾，啟動 Codex
cd ~/work/my-app
codex

# 2. 讓它產生 AGENTS.md 草稿（寫測試怎麼跑、專案規則的檔案）
> /init

# 3. 之後直接用中文交代。附上檔名，做得更快也更省
> src/utils/date.test.ts 一直失敗，找出原因修好，並確認測試通過

Das von /init erzeugte AGENTS.md ist eine Datei für Regeln, die man beim Lesen des Codes nicht erkennen kann – wie Tests ausgeführt werden, welche Bibliotheken verwendet werden und welche Pfade nicht verändert werden dürfen. Sie wird in jeder späteren Sitzung automatisch gelesen. Der erzeugte Inhalt ist nur ein Entwurf; überarbeiten Sie ihn selbst.

Die Tipps für Anweisungen sind dieselben wie bei Claude Code: Geben Sie Dateinamen und Pfade an und übergeben Sie große Aufgaben nicht auf einmal. Weniger für die Erkundung verwendete Token bedeuten schnellere und präzisere Ergebnisse und eine niedrigere Rechnung.

Modell nach Aufgabe auswählen – die tatsächlichen Kosten einer Aufgabe

Der größte Vorteil der Nutzung mit einem API-Key ist, dass Sie das Modell passend zum Arbeitsaufwand auswählen können. model ist lediglich der Modellname am Endpunkt; ein Modellwechsel erfordert weder einen neuen Key noch zusätzliche Konfiguration.

# config.toml 的預設（gpt-5-6-sol）不動，只有這次啟動換模型
codex -m gpt-6-astra     # 找不到原因的 bug、跨模組的修改
codex -m gpt-5-6-terra   # 例行修改、大量取代、整理日誌這類輕量工作

Für die Berechnung einer „Aufgabe“ wird angenommen, dass ein fehlgeschlagener Test in 20 Schritten behoben wird. Jeder Schritt umfasst 25.000 Eingabe-Token (System-Prompt + Dialogverlauf + eingelesene Dateien) und 1.200 Ausgabe-Token (eine Änderung oder Erklärung); eine Aufgabe umfasst daher 500.000 Eingabe- und 24.000 Ausgabe-Token. Mit GPT-5.6 Sol kostet das etwa $1.29; dieselbe Tokenmenge direkt an OpenAI bezahlt kostet zum aktuellen Aktionspreis $2.48 (zum Listenpreis $3.22). Je günstiger das Modell, desto wahrscheinlicher sind mehrere Korrekturrunden; in der Praxis wechseln Sie daher eine Stufe nach oben, wenn der Fehler beim ersten Versuch nicht behoben wird.

Diese Berechnung berücksichtigt den Cache nicht. Codex sendet den Dialogverlauf in jedem Schritt erneut; Treffer im Cache werden mit dem 0,10-Fachen des Eingabepreises berechnet (GPT-5.6 Sol kostet pro 1M Token $0.20), neu in den Cache geschriebene Inhalte mit dem 1,25-Fachen des Eingabepreises. Außerdem wird bei GPT-5.6-Modellen und GPT-6 Astra bei Prompts über 272K Token in einer einzelnen Anfrage die gesamte Anfrage mit dem 2-Fachen für Eingaben und dem 1,5-Fachen für Ausgaben berechnet. Packen Sie daher nicht zu viel Arbeit in dieselbe Sitzung; es ist sicherer, für jede Aufgabe eine neue Sitzung zu starten. Die Denktoken von Reasoning-Modellen werden zum Ausgabepreis abgerechnet; je schwieriger die Aufgabe, desto mehr Ausgabe entsteht. Die tatsächlichen Kosten finden Sie im Feld usage der Antwort und im Nutzungsprotokoll. Die Modellspezifikationen stehen auf der Modellseite von GPT-5.6 Sol, die Preise aller Modelle in der Preisliste.

Häufige Fehler

Ehrlich gesagt – wann sich ein ChatGPT-Tarif eher lohnt

Wenn du täglich mehrere Stunden mit Codex hin und her arbeitest, ist ein Tarif mit fester Monatsgebühr normalerweise günstiger. Die nutzungsabhängige Abrechnung ist proportional zum Tokenverbrauch: Je mehr und regelmäßiger du nutzt, desto größer der Vorteil der Monatsgebühr. Der Schwellenwert ist „Monatsgebühr ÷ Preis einer Aufgabe“; den Break-even-Punkt zwischen den Tarifen haben wir auf der Seite Codex-Kosten berechnet.

Zwei weitere Dinge solltest du vorher wissen. Laut der Dokumentation von OpenAI sind Funktionen, die vom ChatGPT-Arbeitsbereich oder von Cloud-Diensten abhängen, bei Verwendung eines API-Schlüssels eingeschränkt oder nicht verfügbar. Außerdem nutzt dieser Weg über Kunavo gemeinsam genutzte Kapazität: Es gibt kein dediziertes Kontingent und keine vertraglich garantierte SLA. Wenn du ein garantiertes Kontingent oder eine SLA brauchst, ist ein direkter Vertrag mit OpenAI besser geeignet.

Für API-Schlüssel eignen sich dagegen Personen mit schwankender Nutzung, die je nach Aufgabe ein Modell auswählen möchten, Teams, die Limits und Nutzungsaufzeichnungen nach Schlüssel trennen wollen, sowie alle, die am Tag des Verbrauchs ihres Tarifkontingents weiterarbeiten möchten. Beides lässt sich kombinieren: Lösche die Zeile model_provider in config.toml, um zur ChatGPT-Anmeldung zurückzukehren. Zum Wechseln bei jedem Start kannst du --profile von Codex verwenden.

Für Zahlungen können Sie eine internationale Kreditkarte (einschließlich JCB), Apple Pay oder Google Pay verwenden; in Taiwan gibt es keine lokale Zahlungsmethode – JKoPay und LINE Pay sind nicht in der Liste der verfügbaren Methoden enthalten. Beim Prepaid-Modell wird die Karte nur beim Aufladen einmal belastet, das Guthaben verfällt nicht und fehlgeschlagene Anfragen werden nicht berechnet. Wenn Sie zwischen Codex und Claude Code schwanken, lesen Sie Claude Code vs Codex CLI (Englisch); wie die Kosten bei Claude Code berechnet werden, erfahren Sie unter Claude-Code-Kosten.

Häufig gestellte Fragen