Codexチュートリアル — Codex CLIのインストール、サブスクリプションなしでAPIキーを使う方法、タスク1件の費用

CodexはOpenAIのAIコーディングエージェントです。最も基本的な使い方は、ターミナルで動くCodex CLI（npm install -g @openai/codex）をインストールし、作業するプロジェクトフォルダでcodexを実行して、中国語で指示することです。始め方は2通りあります。ChatGPTプラン（Plus、Pro、Businessなど）でログインしてプランの利用枠内で使う方法と、APIキーで実行して使ったtoken分だけ支払う方法です。中国語の解説はほぼ前者だけなので、この記事では後者——購読なしでCodex CLIを動かす設定、タスクに応じたモデル選び、1タスクに実際にかかる費用——を補足します。

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 tokenあたり$2.00 / $12.00です（料金は当サイトのカタログから直接取得しており、手入力ではありません）。

Codex CLIをインストール——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でログインする場合はここで完了し、以下の設定は不要です。

APIキーで実行——config.tomlに1ブロック追加

まずアカウントを登録し、$10以上をチャージしてからAPIキーのページでキーを作成します。キーは一度しか表示されないため、すぐに保存してください。次に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"        # 唯一有效的值，省略也一樣

最も間違えやすいのはenv_keyです。ここに入力するのはキーそのものではなく、キーを保存した環境変数の名前です。キーは設定ファイルに現れないため、config.tomlは安心してgitにコミットしたり、フォーラムで質問するために貼り付けたりできます。

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

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

WindowsのPowerShellではsetx KUNAVO_API_KEY sk-kn-...を実行し、その後ターミナルを開き直します。設定ファイルの場所は%USERPROFILE%\.codex\config.tomlです。Codexを起動する前に、まず1件リクエストしてキーとエンドポイントが正常か確認すると、後でエラーが起きた際に原因を切り分けやすくなります。

# 懷疑 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"}'

JSONが返ればキーとエンドポイントは正常で、残る問題はconfig.tomlにあります。各設定項目の説明はCodex CLI統合ドキュメント（英語）に、CodexからClaudeモデルを呼び出す方法はCodex CLI APIキーガイド（英語）に記載されています。

最初のタスク

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

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

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

/initが生成するAGENTS.mdは、「コードを見ただけでは分からないルール」を記述するファイルです——テストの実行方法、使用するライブラリ、変更してはいけないパスなど——以後、各セッションで自動的に読み込まれます。生成内容はあくまで下書きなので、必ず自分で一度編集してください。

指示のコツはClaude Codeと同じです。ファイル名とパスを添えること、大きなタスクを一度に渡さないことです。探索に使うtokenが減り、結果が速く正確になり、請求額も下がります。

タスクに応じてモデルを選ぶ——1タスクの実費

APIキーで実行する最大の利点は、作業の重さに応じてモデルを選べることです。modelはエンドポイント上のモデル名にすぎず、モデル変更に新しいキーや追加設定は不要です。

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

「1タスク」は、失敗したテストを修正する作業を20ステップとして計算しています。各ステップは入力25,000 token（システムプロンプト＋会話履歴＋読み込んだファイル）、出力1,200 token（1回の変更または説明）なので、1タスクは入力500,000、出力24,000 tokenです。GPT-5.6 Solを使うと約$1.29；同じtoken数をOpenAIに直接支払う場合、現在のプロモーション価格では$2.48（定価では$3.22）です。安価なモデルほど、正しく直すまでに何度も往復する可能性があるため、実際には1回で解決しなければ1段階上のモデルに切り替えます。

この計算にはキャッシュを含めていません。Codexは各ステップで会話履歴を再送し、キャッシュヒットした入力は入力単価の0.10倍（GPT-5.6 Solでは1M tokenあたり$0.20）、新たにキャッシュへ書き込む部分は入力単価の1.25倍で課金されます。また、GPT-5.6シリーズとGPT-6 Astraでは、単一リクエストのプロンプトが272K tokenを超えると、リクエスト全体が入力2倍・出力1.5倍で課金されます。1つのセッションに作業を詰め込みすぎず、1タスクごとに再起動する方が安全です。推論モデルの思考tokenは出力料金で課金され、難しい問題ほど出力が増えます。実際の金額はレスポンス内のusageと使用量記録を確認してください。モデル仕様はGPT-5.6 Solモデルページ、全モデルの料金は料金表にあります。

よくあるエラー

率直に言うと——ChatGPTプランが得になるのはいつか

毎日数時間Codexと往復するなら、固定月額のプランが通常は安くなります。従量課金はtoken使用量に比例するため、利用量が多く安定しているほど月額プランが有利です。分岐点は「月額料金÷1タスクの単価」で、プラン間の損益分岐点はCodex料金ページで計算済みです。

先に知っておくべきことが2つあります。OpenAIのドキュメントによれば、ChatGPTワークスペースやクラウドサービスに依存する機能は、APIキー使用時に制限されるか利用できません。また、Kunavoは共有容量で、専用割当も契約上保証されたSLAもありません。容量やSLAの保証が必要なら、OpenAIと直接契約する方が適しています。

逆にAPIキーが適しているのは、利用量が変動する人、タスクごとにモデルを選びたい人、チーム内でキー別に上限と使用量記録を分けたい人、そしてプランの利用枠を使い切った日も作業を続けたい人です。両方を併用できます。config.toml内のmodel_provider行を削除すればChatGPTログインに戻ります。起動ごとに切り替えたい場合はCodexの--profileを使います。

国際クレジットカード（JCBを含む）、Apple Pay、またはGoogle Payでお支払いいただけます。台湾には現地決済手段がなく、JKO PayとLINE Payはいずれも利用可能な決済方法に含まれていません。前払い制ではチャージ時に一度だけカードへ請求され、残高に有効期限はありません。失敗したリクエストには課金されません。CodexとClaude Codeのどちらにするか迷っている場合は、Claude Code vs Codex CLI（英語）をご覧ください。Claude Codeの料金についてはClaude Codeの料金をご覧ください。

よくある質問