Codex verwenden — von der Installation bis zum Betrieb mit API-Schlüssel ohne Abonnement

Codex ist ein Coding-Agent von OpenAI. Für die grundlegende Nutzung installieren Sie Codex CLI, das im Terminal ausgeführt wird (npm install -g @openai/codex), starten codex im gewünschten Repository und formulieren Ihre Anfrage auf Japanisch. Es gibt zwei Möglichkeiten, zu beginnen: Sie melden sich mit einem ChatGPT-Plan (Plus, Pro, Business usw.) an und nutzen das enthaltene Kontingent oder führen Codex mit einem API-Schlüssel aus und zahlen nur für die verwendeten Token. Da japanischsprachige Erklärungen fast ausschließlich die erste Möglichkeit behandeln, erläutert diese Seite die zweite — die Einrichtung von Codex CLI ohne Abonnement, die Modellauswahl pro Aufgabe und die tatsächlichen Kosten einer Aufgabe — der Reihe nach.

Codex ist kein Tool, in dessen Chatfenster Sie Code einfügen. Es ist ein Agent, der Dateien im Repository liest und ändert sowie Tests und Befehle ausführt. Wie viel Sie ohne Bestätigung überlassen, legen Sie nach dem Start mit /permissions fest.

Zwei Möglichkeiten, Codex zu verwenden

Bei der Nutzung eines API-Schlüssels wird die Abrechnung getrennt vom Kontingent des OpenAI-Plans erfasst. Sie können einen OpenAI-API-Schlüssel direkt verwenden; diese Seite behandelt jedoch die Weiterleitung an einen Responses-API-kompatiblen Endpunkt. GPT-6 Astra bis GPT-5.6 Terra lassen sich mit demselben Schlüssel wechseln. Beispielsweise kostet GPT-5.6 Sol pro 1 Mio. Token $2.00 / $12.00 gegenüber dem OpenAI-Listenpreis von $5.00 / $30.00(OpenAI bietet das Modell derzeit zum Aktionspreis von $4.00 / $20.00 an. Laut Preisseite gilt dieser mindestens bis 21. November 2026) (die Tarife werden direkt aus dem Katalog geladen).

Installation — npm oder Homebrew

# npm（Node.js が入っていれば macOS / Linux / Windows 共通）
npm install -g @openai/codex

# Homebrew（macOS）
brew install --cask codex

Beide Methoden sind in der offiziellen README von OpenAI aufgeführt. Unter Windows kann die Installation ebenfalls mit dem npm-Befehl erfolgen. Geben Sie nach der Installation codex im Verzeichnis des Repositorys ein, an dem Sie arbeiten möchten, um das Programm zu starten. Wenn Sie sich mit ChatGPT anmelden, sind Sie damit fertig; die folgenden Einstellungen sind nicht erforderlich.

Mit einem API-Schlüssel ausführen — ein Block in config.toml

Erstellen Sie zunächst ein Konto, laden Sie ab 10 $ Guthaben auf und erstellen Sie unter API-Schlüssel einen Schlüssel. Der Schlüssel wird nur einmal angezeigt; notieren Sie ihn daher sofort. Schreiben Sie anschließend einen Anbieterblock in die Konfigurationsdatei von Codex.

# ~/.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 leichtesten zu verwechseln ist hier env_key. Einzutragen ist nicht der Schlüssel selbst, sondern der Name der Umgebungsvariable, in der der Schlüssel hinterlegt wird. Da der Schlüssel nicht in die Konfigurationsdatei gelangt, kann config.toml unverändert committet oder in einer Frage eingefügt werden, ohne dass dies ein Sicherheitsrisiko darstellt.

# env_key で指定した名前の変数にキーを入れる（キーは sk-kn- で始まる）
export KUNAVO_API_KEY="sk-kn-..."

# 毎回 export しないよう、使っているシェルの設定ファイルに追記しておく
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Führen Sie unter Windows PowerShell setx KUNAVO_API_KEY sk-kn-... aus und öffnen Sie anschließend ein neues Terminal. Der Speicherort der Konfigurationsdatei ist %USERPROFILE%\.codex\config.toml. Wenn Sie vor dem Start von Codex mit einer einzigen Anfrage prüfen, ob Schlüssel und Endpunkt korrekt sind, wird die spätere Fehlersuche einfacher.

# Codex を疑う前に、キーとエンドポイントだけを 1 回で確かめる
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 とだけ返して"}'

Wenn JSON zurückgegeben wird, sind Schlüssel und Endpunkt in Ordnung; falls noch ein Problem besteht, liegt es auf der Seite von config.toml. Details zu den Konfigurationsoptionen finden Sie in der Integrationsdokumentation für die Codex CLI (Englisch). Eine Anleitung, einschließlich der Verwendung von Claude-Modellen über Codex, finden Sie im Leitfaden zur API-Schlüsselkonfiguration der Codex CLI (Englisch).

Erste Aufgabe

# 1. 作業したいリポジトリに入って起動する
cd ~/work/my-app
codex

# 2. AGENTS.md の雛形を作らせる（テストの実行方法や決めごとを書くファイル）
> /init

# 3. あとは日本語で頼む。ファイル名を添えるほど速く、安く終わる
> src/utils/date.test.ts が落ちている。原因を調べて直し、テストが通るのを確認して

Die von /init erstellte AGENTS.md ist eine Datei, in der „Regeln festgehalten werden, die man beim Lesen des Codes nicht erkennen kann“ – etwa wie Tests ausgeführt werden, welche Bibliotheken verwendet werden oder welche Pfade nicht verändert werden dürfen. Sie wird in folgenden Sitzungen automatisch geladen. Der erzeugte Inhalt ist nur ein Entwurf; bearbeiten Sie ihn von Hand.

Die Tipps für gute Anfragen sind dieselben wie bei Claude Code: Fügen Sie Dateiname und Pfad hinzu und senden Sie keine großen Aufgaben auf einmal. Da weniger Tokens für die Erkundung verbraucht werden, sind die Ergebnisse schneller und genauer, und die Rechnung fällt niedriger aus. Die Häufigkeit der Bestätigungsdialoge können Sie mit /permissions anpassen. Die Nutzung von Claude Code ist unter Claude Code verwenden zusammengefasst.

Modell pro Aufgabe auswählen – tatsächliche Kosten einer Aufgabe

Der größte Vorteil der Nutzung mit einem API-Schlüssel besteht darin, dass Sie das Modell an den Umfang der Arbeit anpassen können. model ist lediglich der Modellname am Endpunkt; für den Wechsel sind weder ein weiterer Schlüssel noch zusätzliche Einstellungen erforderlich.

# config.toml の既定（gpt-5-6-sol）はそのまま、この起動だけモデルを変える
codex -m gpt-6-astra     # 原因の見えないバグ、設計をまたぐ変更
codex -m gpt-5-6-terra   # 定型の修正、一括置換、ログの要約などの軽い作業

„Eine Aufgabe“ basiert auf der Annahme, dass das Beheben eines fehlgeschlagenen Tests 20 Schritte umfasst. Ein Schritt besteht aus 25.000 Eingabe-Tokens (System-Prompt + Gesprächsverlauf + gelesene Dateien) und 1.200 Ausgabe-Tokens (eine Bearbeitung oder Erklärung), also 500.000 Eingabe- und 24.000 Ausgabe-Tokens pro Aufgabe. Bei GPT-5.6 Sol sind es $1.29; dieselbe Tokenmenge direkt an OpenAI zu zahlen kostet zum aktuellen Aktionspreis $2.48 (zum regulären Preis $3.22). Bei günstigeren Modellen können durch Nachbesserungen mehr Interaktionsrunden nötig werden. In der Praxis ist es sinnvoll, bei einem nicht erfolgreichen ersten Versuch eine Stufe höher zu gehen.

Diese Berechnung berücksichtigt den Cache nicht. Da Codex den Gesprächsverlauf bei jedem Schritt erneut sendet, werden aus dem Cache gelesene Eingaben zum 0,10-Fachen des Eingabepreises berechnet (bei GPT-5.6 Sol also $0.20 pro 1 Mio. Tokens); neu in den Cache geschriebene Anteile werden zum 1,25-Fachen des Eingabepreises berechnet. Bei GPT-5.6-Modellen und GPT-6 Astra wird eine Anfrage vollständig mit dem Zweifachen für Eingaben und dem 1,5-Fachen für Ausgaben berechnet, sobald ihr Prompt mehr als 272.000 Tokens umfasst. Packen Sie nicht zu viel Arbeit in eine Sitzung, sondern starten Sie pro Aufgabe neu. Denk-Tokens von Reasoning-Modellen werden als Ausgabe berechnet; daher steigt die Ausgabe bei schwierigen Aufgaben ebenfalls. Die tatsächlichen Kosten sehen Sie im Feld usage der Antwort und im Nutzungsverlauf. Die Modellspezifikationen finden Sie auf der Modellseite von GPT-5.6 Sol, die Preise aller Modelle in der Preisliste.

Häufige Fehler

Ehrlich gesagt – wann ein ChatGPT-Tarif günstiger ist

Wenn Sie täglich viele Stunden mit Codex arbeiten und dabei interagieren, ist ein Pauschaltarif meistens günstiger. Bei der nutzungsabhängigen Abrechnung steigen die Kosten direkt mit der Tokenmenge; je größer und regelmäßiger die Nutzung, desto größer der Vorteil eines Pauschaltarifs. Die Kostenschwelle ergibt sich aus „Monatspreis ÷ Preis pro Aufgabe“. Den Break-even mit dem Tarif berechnen wir unter Codex-Preise.

Zwei weitere Punkte sollten Sie kennen. Laut der OpenAI-Dokumentation sind Funktionen, die vom ChatGPT-Arbeitsbereich oder von der Cloud abhängen, bei der Nutzung mit einem API-Schlüssel eingeschränkt oder nicht verfügbar. Außerdem nutzt die Kunavo-Route gemeinsam genutzte Kapazität; es gibt weder ein dediziertes Kontingent noch ein vertragliches SLA. Wenn Sie garantierte Kapazität oder ein SLA benötigen, ist ein direkter Vertrag mit OpenAI geeigneter.

API-Schlüssel eignen sich dagegen für Personen mit stark schwankender Nutzung, für Personen, die das Modell pro Aufgabe auswählen möchten, für Teams, die Limits und Nutzungshistorien nach Schlüssel trennen möchten, sowie für alle, die nur an Tagen weiterarbeiten möchten, an denen das Tarifkontingent erschöpft ist. Beides lässt sich kombinieren. Wenn Sie die Zeile model_provider aus config.toml löschen, kehren Sie zur Anmeldung bei ChatGPT zurück. Wenn Sie bei jedem Start wechseln möchten, können Sie --profile in Codex verwenden.

Die Zahlung erfolgt per Karte (einschließlich JCB), Apple Pay, Google Pay und anderen Methoden; das Guthaben verfällt nicht. Zahlungen in Convenience Stores und PayPay werden nicht unterstützt. Fehlgeschlagene Requests werden nicht berechnet. Wenn Sie zwischen Codex und Claude Code wählen, lesen Sie den Vergleich von Codex und Claude Code.

Häufig gestellte Fragen