Codex CLI の実際のコスト
プランログイン vs API キー、自動キャッシュ、エージェント セッションのトークン数学——OpenAI のコーディング エージェントのコスト全景。
Codex CLI ユーザーは二派に分かれます：ChatGPT プランでログインして token 数を見たことがない派と、API キーで token 数しか見ない派。両派とも当てずっぽう——プラン派はメーターが見えず、API 派はモデルの挙動が見えません。本稿は Codex CLI のコスト全景です：どのモードで何が課金され、トークンがどこへ行き、エージェント セッションがチャットとどう違うか。
最初に開示します：私は Codex CLI と Claude Code を OpenAI 互換 + Anthropic プロトコルで提供するゲートウェイ Teapot Router を運営しています。以下の仕組みはどの OpenAI 互換エンドポイントにも当てはまります。
2 つのモード、2 つの課金現実
Codex CLI には課金の土台が根本的に違う 2 モードがあります。プランログイン：使用量は ChatGPT サブスクに上限まで含まれ、請求書ではなくクォータ表示——安いが壁に当たると制限。API キーモード：全トークンがモデル単価で計量され、コスト問題はここにしかありません。仕事のコストを見たいチームは API キー、とにかく作業が欲しいチームはプラン。自分がどちらかを知ることが Codex コスト会話の第一歩です。
エージェント セッションでトークンはどこへ
Codex セッションはチャットではなく、ツール呼び出し・ファイル読取・編集のループで、毎ターン作業コンテキストを再送します。請求はあらゆるコーディング エージェントと同じ 3 変数で決まります：
- タスクあたりのターン数——エージェントは反復する。リファクタは 1 回のプロンプトではなく数十回の課金往復。
- コンテキスト成長——読んだファイルとツール結果が以降のターンに乗る。20 番目のメッセージは 1〜19 番目を再支払い。
- キャッシュ挙動——OpenAI は反復する安定プレフィックスを自動割引。設定不要だが、セッション形状が割引比率を決める。
自動キャッシュがする取引
OpenAI のプロンプト キャッシュは設定ゼロ：安定した反復プレフィックスは命中で割引されます。代償は制御権——セッション形状がたまたまキャッシュ友好なときだけ割引を受けられ、Anthropic 式キャッシュのようなタグ付け・誘導はできません。実際的な帰結：セッション規律（タスク分割、新規セッション、退屈で安定なプレフィックス）はモデル選択より実効レートを動かし、カオスなコンテキストを補うノブは存在しません。
Codex をゲートウェイ経由にする
API キーモードはルーティング可能なモードでもあります：base_url を一つ変えれば Codex はどの OpenAI 互換エンドポイントにも向きます。チームがここにゲートウェイを置く理由——開発者ごとのキーではなく共有プール、月次の謎ではなくリクエスト毎の計量（モデル/トークン/キャッシュ/費用）、組織レベルの集計。計量こそが要点です：プランは仕事のコストを隠し、計量ゲートウェイはタスク毎・キー毎・プロジェクト毎に示します。
モードを意図的に選ぶ：プラン=込みで不透明、API キー=計量され監査可能。その上で API 請求を決める 3 変数——ターン数、コンテキスト成長、キャッシュ友好なセッション形状——を管理してください。エージェント コーディングではそれらが他のすべてを圧倒します。
よくある質問
ChatGPT プランなら Codex CLI は無料？
使用量は上限までプランに含まれ、token 課金ではなくサブスク料金です。超過は請求ではなく制限。重いワークロードは最終的に API キーモードへ行きます。
Codex セッションにプロンプト キャッシュは効く？
効きます——OpenAI 端点は反復する安定プレフィックスを自動割引。設定不要。セッション形状（タスク分割、安定コンテキスト）が割引比率を決めます。
Codex CLI を自分の端点に向けられる？
はい——base URL を任意の OpenAI 互換端点に設定。ゲートウェイはその上にリクエスト毎計量とチーム共有プールを追加します。プロトコルは同じ。