Codex verwenden — von der Installation bis zur Nutzung mit API-Schlüssel ohne Abonnement, einschließlich der tatsächlichen Kosten einer Aufgabe

Codex (Codex) ist der Coding-Agent von OpenAI. Für die grundlegende Nutzung installieren Sie die im Terminal ausgeführte Codex CLI (npm install -g @openai/codex), führen anschließend codex im zu bearbeitenden Repository aus und stellen Ihre Anfrage auf Koreanisch. Für den Einstieg gibt es zwei Möglichkeiten: Sie melden sich mit einem ChatGPT-Tarif (Plus · Pro · Business usw.) an und nutzen Codex innerhalb des Nutzungslimits, oder Sie führen Codex mit einem API-Schlüssel aus und zahlen nur für die verbrauchten Token. Da fast alle koreanischen Anleitungen nur die erste Möglichkeit behandeln, erklärt dieser Artikel die zweite: die Konfiguration der Codex CLI ohne Abonnement, die Auswahl eines Modells pro Aufgabe und die tatsächlichen Kosten einer einzelnen Aufgabe. Limits nach Tarif und Optionen nach Erreichen des Limits sind separat unter Codex-Nutzungslimits zusammengefasst.

Codex ist kein Tool, in das man Code in ein Chatfenster einfügt. Es ist ein Agent, der im Repository Dateien liest und ändert sowie Tests und Befehle ausführt. Nach dem Start können Sie unter /permissions festlegen, was ohne Bestätigung ausgeführt werden darf.

Zwei Möglichkeiten, Codex zu verwenden

Bei Nutzung eines API-Schlüssels wird die Abrechnung getrennt von der Nutzung Ihres ChatGPT-Tarifs berechnet. Sie können einen OpenAI-API-Schlüssel unverändert verwenden; dieser Artikel beschreibt jedoch die Verbindung über einen Responses-API-kompatiblen Endpunkt. Mit demselben Schlüssel können Sie zwischen GPT-6 Astra und GPT-5.6 Terra wechseln. Beispielsweise kostet GPT-5.6 Sol pro 1M Token $2.00 / $12.00 gegenüber dem OpenAI-Listenpreis von $5.00 / $30.00(OpenAI berechnet derzeit einen Aktionspreis von $4.00 / $20.00; laut Preisseite bleibt dieser mindestens bis 21. November 2026 bestehen) (die Preise werden direkt aus dem Katalog gelesen).

Codex installieren – npm oder Homebrew

# npm (Node.js만 있으면 macOS / Linux / Windows 공통)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

Beide Methoden entsprechen den Installationsanweisungen in der offiziellen OpenAI-README. Unter Windows kann die Installation ebenfalls mit dem npm-Befehl erfolgen. Nach der Installation geben Sie im Verzeichnis des zu bearbeitenden Repositorys codex ein, um Codex zu starten. Wenn Sie Codex mit ChatGPT verwenden möchten, sind Sie hier fertig; die folgenden Einstellungen benötigen Sie nicht.

Codex-API-Schlüssel erhalten und konfigurieren – ein Block in config.toml

Erstellen Sie zunächst ein Konto, laden Sie ab $10 auf und erstellen Sie anschließend unter API-Schlüssel einen Schlüssel. Der Schlüssel wird nur einmal angezeigt, speichern Sie ihn daher sofort. Fügen Sie anschließend Ihrer Codex-Konfigurationsdatei einen Provider-Block 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 konfiguriert. Hier gehört nicht der Schlüssel selbst, sondern der Name der Umgebungsvariable, die den Schlüssel enthält, hinein. Da der Schlüssel nicht in der Konfigurationsdatei steht, können Sie config.toml gefahrlos committen oder in einen Supportbeitrag einfügen.

# env_key에 적은 이름의 변수에 키를 넣습니다 (키는 sk-kn-으로 시작)
export KUNAVO_API_KEY="sk-kn-..."

# 매번 export하지 않도록, 쓰는 셸의 설정 파일에 추가해 둡니다
echo 'export KUNAVO_API_KEY="sk-kn-..."' >> ~/.zshrc

Führen Sie in Windows PowerShell setx KUNAVO_API_KEY sk-kn-... aus und öffnen Sie anschließend ein neues Terminal. Die Konfigurationsdatei befindet sich unter %USERPROFILE%\.codex\config.toml. Wenn Sie Schlüssel und Endpunkt vor dem Start von Codex mit einer Anfrage überprüfen, lässt sich das Problem leichter eingrenzen.

# 코덱스를 의심하기 전에, 키와 엔드포인트만 요청 한 번으로 확인합니다
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 korrekt; das verbleibende Problem liegt auf der Seite von config.toml. Die Konfigurationselemente finden Sie in der Codex-CLI-Integrationsdokumentation (Englisch); eine Erklärung, die auch den Aufruf von Claude-Modellen aus Codex behandelt, in Codex-CLI-API-Schlüssel-Leitfaden (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 stehen, die man durch Lesen des Codes nicht erkennen kann“, etwa wie Tests ausgeführt werden, welche Bibliotheken verwendet werden und welche Pfade nicht verändert werden dürfen. Sie wird in späteren Sitzungen automatisch gelesen. Der generierte Inhalt ist ein Entwurf; überarbeiten Sie ihn manuell.

Die Vorgehensweise bei Anfragen ist dieselbe wie bei Claude Code: Fügen Sie Dateipfade ein und geben Sie keine großen Aufgaben auf einmal vor. Dadurch sinkt die Zahl der für die Erkundung benötigten Token, die Ergebnisse werden schneller und präziser und die Rechnung fällt niedriger aus. Die Betriebsweise von Claude Code ist unter Claude Code verwenden zusammengefasst.

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

Der größte Vorteil der Nutzung mit einem API-Schlüssel besteht darin, dass Sie das Modell an den Umfang der Aufgabe anpassen können. model ist lediglich der Modellname des Endpunkts; für einen Wechsel benötigen Sie keinen neuen Schlüssel und keine zusätzlichen Einstellungen.

# config.toml의 기본값(gpt-5-6-sol)은 그대로 두고, 이번 실행만 모델을 바꿉니다
codex -m gpt-6-astra     # 원인을 모르는 버그, 여러 모듈에 걸친 변경
codex -m gpt-5-6-terra   # 정형화된 수정, 일괄 치환, 로그 요약 같은 가벼운 작업

Für „eine Aufgabe“ wird berechnet, dass ein fehlgeschlagener Test in 20 Schritten behoben wird. Ein Schritt umfasst 25.000 Eingabetoken (System-Prompt + Gesprächsverlauf + gelesene Dateien) und 1.200 Ausgabetoken (eine Änderung oder Erklärung), also insgesamt 500.000 Eingabe- und 24.000 Ausgabetoken pro Aufgabe. Bei GPT-5.6 Sol ergibt das $1.29, wenn Sie dieselben Token direkt an OpenAI senden, kostet dies zum aktuellen Aktionspreis $2.48 (zum Listenpreis $3.22). Bei günstigeren Modellen können mehr Hin-und-her-Schritte erforderlich sein, weil Korrekturen wiederholt werden müssen. Wenn es nicht in einem Durchlauf klappt, ist ein Upgrade um eine Stufe realistisch. Mit dem Kostenrechner können Sie Ihre eigene Tokenmenge direkt einsetzen.

Diese Berechnung berücksichtigt Caching nicht. Codex sendet den Gesprächsverlauf in jedem Schritt erneut. Im Cache gespeicherte Eingaben werden mit dem 0,10-Fachen des Eingabepreises berechnet (bei GPT-5.6 Sol sind das $0.20 pro 1M Token); neu in den Cache geschriebene Daten kosten das 1,25-Fache des Eingabepreises. Außerdem wird bei GPT-5.6-Modellen und GPT-6 Astra die gesamte Anfrage mit dem 2-Fachen für Eingaben und dem 1,5-Fachen für Ausgaben berechnet, wenn der Prompt einer Anfrage 272K Token überschreitet. Packen Sie nicht zu viele Aufgaben in eine Sitzung; sicherer ist es, jede Aufgabe in einer neuen Ausführung zu starten. Bei Reasoning-Modellen werden Thinking-Token als Ausgabe berechnet, daher steigt die Ausgabe bei schwierigen Aufgaben ebenfalls. Den tatsächlichen Betrag finden Sie im Feld usage der Antwort und im Nutzungsverlauf. Modellspezifikationen stehen auf der Modellseite für GPT-5.6 Sol, die vollständigen Preise in der Preistabelle. Eine Tabelle zum direkten Vergleich der Tokenpreise der von Codex verwendeten GPT-Modelle finden Sie unter GPT API Preise.

Häufige Fehler

Ehrlich gesagt – wann der ChatGPT-Tarif besser ist

Wenn Sie täglich mehrere Stunden mit Codex arbeiten, ist ein Pauschaltarif im Allgemeinen günstiger. Bei verbrauchsbasierten Tarifen steigen die Kosten direkt mit der Tokenmenge. Je höher und regelmäßiger die Nutzung, desto größer der Vorteil der Pauschale. Als Maßstab gilt „Monatliche Pauschale ÷ Preis pro Aufgabe“; den Break-even-Point gegenüber den Tarifen haben wir unter Codex-Preise berechnet.

Zwei weitere Punkte sollten Sie kennen. Laut OpenAI-Dokumentation sind Funktionen, die auf ChatGPT-Arbeitsbereiche oder die Cloud angewiesen sind, bei Verwendung eines API-Schlüssels eingeschränkt oder nicht verfügbar. Außerdem ist der Kunavo-Weg ein gemeinsam genutztes Kontingent ohne dediziertes Kontingent und ohne vertragliches SLA. Wenn Sie garantierte Limits oder ein SLA benötigen, sollten Sie direkt mit OpenAI einen Vertrag abschließen.

Ein API-Schlüssel passt dagegen zu Personen, deren Nutzung zwischen Arbeitstagen und freien Tagen stark schwankt, die das Modell pro Aufgabe auswählen möchten, die in einem Team Limits und Nutzungsverlauf pro Schlüssel trennen möchten oder die nur an Tagen weiterarbeiten wollen, an denen das Tariflimit aufgebraucht ist. Beide Methoden können parallel verwendet werden. Löschen Sie die Zeile model_provider in config.toml, um zur ChatGPT-Anmeldung zurückzukehren; wenn Sie bei jedem Start wechseln möchten, verwenden Sie --profile von Codex.

Kunavo wird unter anderem mit Karten, Apple Pay und Google Pay aufgeladen. Wenn das Zahlungsfenster in Won angezeigt wird, erscheinen auch Kakao Pay, Naver Pay, PAYCO, Samsung Pay und inländische Karten (einschließlich Karten, für die Auslandszahlungen nicht aktiviert sind). Toss wird nicht unterstützt. Das Guthaben hat kein Ablaufdatum, und fehlgeschlagene Anfragen werden nicht berechnet. Wenn Sie zwischen Codex und Claude Code abwägen, lesen Sie Codex vs. Claude Code.

Häufig gestellte Fragen