Codexの使い方 — インストールからサブスクリプションなしでAPIキーを使う方法、タスク1件の実際の費用まで

コーデックス（Codex）はOpenAIのコーディングエージェントです。基本的な使い方は、ターミナルで動作するCodex CLIをインストールし（npm install -g @openai/codex）、作業するリポジトリでcodexを実行してから、韓国語で依頼することです。 始め方は2つあります。ChatGPTプラン（Plus・Pro・Businessなど）でログインして使用量上限の範囲で使う方法と、APIキーで動かして使ったトークン分だけ支払う方法です。韓国内向けの使い方記事のほとんどは前者だけを扱っているため、この記事では後者、つまりサブスクリプションなしでCodex CLIを動かす設定、タスクごとにモデルを選ぶ方法、1つのタスクの実際のコストを順に説明します。プラン別の上限と、上限を使い切った場合の選択肢はCodexの使用量上限に別途まとめています。

Codexはチャット画面にコードを貼り付けるツールではなく、リポジトリ内のファイルを読み取り、変更し、テストやコマンドを実行するエージェントです。何を確認なしで任せるかは、実行後に/permissionsで決められます。

Codexを使う2つの方法

APIキーで実行する場合、請求はChatGPTプランの使用量とは別に計算されます。OpenAI APIキーをそのまま使うこともできますが、この記事ではResponses API互換エンドポイントに接続する方法を扱います。同じキーでGPT-6 AstraからGPT-5.6 Terraまで切り替えて使えます。たとえばGPT-5.6 Solは、OpenAIの公式価格$5.00 / $30.00（OpenAIは現在プロモーション価格 $4.00 / $20.00 で提供しており、料金ページによると少なくとも2026年11月21日まで維持されます） に対して、1Mトークンあたり$2.00 / $12.00です（料金はカタログから直接読み取ります）。

Codexのインストール — npmまたはHomebrew

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

# Homebrew (macOS)
brew install --cask codex

どちらの方法もOpenAI公式READMEに記載されたインストール方法です。Windowsでもnpmコマンドでインストールできます。インストール後、作業するリポジトリのディレクトリでcodexと入力すると起動します。ChatGPTでログインして使う場合はここで完了し、以下の設定は不要です。

Codex APIキーの取得と設定 — config.tomlに1ブロック

まず登録して$10からチャージし、APIキー画面でキーを作成します。キーは一度しか表示されないため、すぐに保存してください。次に、Codexの設定ファイルへプロバイダーブロックを1つ追加します。

# ~/.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です。ここに記述するのは、キーそのものではなく、キーを格納する環境変数の名前です。キーが設定ファイルに入らないため、config.tomlはコミットしたり質問投稿に貼り付けたりしても安全です。

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

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

Windows PowerShellの場合はsetx KUNAVO_API_KEY sk-kn-...を実行してから、新しいターミナルを開いてください。設定ファイルの場所は%USERPROFILE%\.codex\config.tomlです。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라고만 답해줘"}'

JSONが返れば、キーとエンドポイントは正常で、残る問題はconfig.toml側です。設定項目はCodex CLI連携ドキュメント（英語）に、CodexでClaudeモデルを呼び出す方法まで含む解説はCodex CLI APIキーガイド（英語）にあります。

最初の作業

# 1. 작업할 저장소로 들어가 실행합니다
cd ~/work/my-app
codex

# 2. AGENTS.md 초안을 만들게 합니다 (테스트 실행법이나 규칙을 적는 파일)
> /init

# 3. 이후엔 한국어로 요청합니다. 파일 경로를 붙일수록 빠르고 싸게 끝납니다
> src/utils/date.test.ts가 실패해. 원인을 찾아서 고치고 테스트가 통과하는지 확인해줘

/initが作成するAGENTS.mdは、テストの実行方法、使用するライブラリ、触れてはいけないパスなど、「コードを読んでも分からないルール」を記録するファイルで、以後のセッションで自動的に読み込まれます。生成された内容は下書きなので、手作業で整えてください。

依頼のコツはClaude Codeと同じです。ファイルパスを添え、大きな作業を一度に投げないこと。探索に使うトークンが減るため、結果が速く正確になり、請求額も下がります。Claude Codeの運用方法はClaude Codeの使い方にまとめています。

作業ごとにモデルを選ぶ — 1つの作業にかかる実際の費用

APIキーで実行する最大の利点は、作業の重さに合わせてモデルを選べることです。modelはエンドポイントのモデル名にすぎないため、変更に新しいキーや追加設定は必要ありません。

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

「1つの作業」は、失敗するテスト1つを修正する作業を20ステップとして計算しています。1ステップは入力25,000トークン（システムプロンプト + 会話履歴 + 読み込んだファイル）と出力1,200トークン（1回の修正または説明）なので、1つの作業では入力500,000・出力24,000トークンです。GPT-5.6 Solなら$1.29、同じトークンをOpenAIに直接送ると、現在のプロモーション価格で$2.48（通常価格では$3.22）です。安いモデルほど、修正して再修正する往復が増える可能性があるため、一度で終わらなければ1段階上のモデルにする方法が現実的です。自分のトークン数を直接入力してみるには、料金計算機を使ってください。

この計算にはキャッシュを反映していません。Codexはステップごとに会話履歴を再送するため、キャッシュに保存された入力は入力単価の0.10倍（GPT-5.6 Solの場合、100万トークンあたり$0.20）で請求され、新たにキャッシュへ書き込まれる分量は入力単価の1.25倍です。また、GPT-5.6系とGPT-6 Astraでは、1回のリクエストのプロンプトが272Kトークンを超えると、そのリクエスト全体が入力2倍・出力1.5倍で請求されます。1つのセッションに作業を詰め込みすぎず、作業ごとに新しく実行する方が安全です。推論モデルの思考トークンは出力として請求されるため、難しい作業ほど出力も増えます。実際の金額は、レスポンスのusageと使用状況で確認してください。モデル仕様はGPT-5.6 Solモデルページ、全体の料金は料金表にあり、Codexが使用するGPTモデルのトークン料金を並べて比較した表はGPT API価格にあります。

よくあるエラー

率直に言うと — ChatGPTプランの方がよい場合

毎日数時間Codexと会話しながら作業するなら、定額プランの方が概して安くなります。従量課金はトークン量にそのまま比例するため、使用量が多く継続的であるほど定額プランのメリットが大きくなります。基準は「月額料金 ÷ 1作業あたりの単価」で、プランとの損益分岐点はCodexの料金で計算しています。

さらに知っておくべき点が2つあります。OpenAIのドキュメントによると、ChatGPTワークスペースやクラウドに依存する機能は、APIキーで使用する場合に制限されるか、利用できません。また、Kunavoの経路は共有容量であり、専用クォータも契約上のSLAもありません。保証された上限やSLAが必要なら、OpenAIと直接契約するのが適切です。

逆にAPIキーが向いているのは、使う日と使わない日の差が大きい人、作業ごとにモデルを選びたい人、チームでキーごとに上限と使用状況を分けたい人、そしてプランの上限を使い切った日にだけ作業を続けたい人です。両方を併用することもできます。config.tomlのmodel_provider行を削除すればChatGPTログインに戻り、実行のたびに切り替えたい場合はCodexの--profileを使えます。

Kunavoのチャージはカード、Apple Pay、Google Payなどで行い、決済画面がウォン表示の場合はカカオペイ、ネイバーペイ、PAYCO、Samsung Pay、国内カード（海外決済が有効でないカードを含む）も表示されます。Tossには対応していません。残高に有効期限はなく、失敗したリクエストには課金されません。CodexとClaude Codeのどちらにするか迷っている場合は、Codex vs Claude Codeをご覧ください。

よくある質問