Codex を API キーで使う手順とChatGPT版との料金の違い

Codex の認証方式は 2 つある

Codex CLI を起動すると、最初に認証を求められる。ここで選べる経路は「ChatGPT アカウントでのサインイン」と「OpenAI API キーの利用」の 2 種類だ。どちらを選ぶかで、使えるモデル・レート上限・課金の仕組みが変わってくる。Codex は同じバイナリのまま、認証情報の渡し方だけで両方をサポートしている。まずはこの 2 経路の性格の違いを理解しておくと、後段の料金比較が腑に落ちる。OpenAI は Codex を「ローカルのターミナルからクラウドのエージェントまで一貫して使えるコーディングエージェント」と位置づけており、認証の選択肢もその思想の延長にある（出典: https://openai.com/index/codex/）。

ChatGPT プランでのサインイン

codex login を実行するとブラウザが開き、ChatGPT アカウントでサインインする経路だ。Plus・Pro・Business・Enterprise の各プランには Codex の利用枠が含まれており、追加の支払い設定なしにそのまま使い始められる。利用量はプランごとに定められたレート上限で管理され、上限に達すると一定時間の待機が必要になる。料金が定額で読みやすいため、個人開発者やチームの日常的な利用にはこの経路が標準的だ。

API キーでの利用

もうひとつが OpenAI の API キーを使う経路だ。platform.openai.com で発行した API キーを Codex に渡すと、ChatGPT プランの枠とは別に、API の従量課金で Codex が動く。レート上限はプランの定額枠ではなく、API アカウントのティアと残高に依存する。大量のタスクをまとめて処理したい場合や、独自のツールへ Codex を組み込みたい場合に適している（出典: https://platform.openai.com/docs/codex）。

API キーで Codex を使う手順

ここからは、API キーを使って Codex を動かすまでの具体的な流れを追う。前提として Codex CLI がインストール済みであること、OpenAI のアカウントで支払い方法が登録済みであることを想定する。手順は次のとおりだ。

1. OpenAI の platform.openai.com にログインし、API キーを 1 本発行する
2. 発行したキーを手元の安全な場所に控える（再表示はできないため）
3. 環境変数 OPENAI_API_KEY にキーを設定するか、codex login --api-key で登録する
4. codex を起動し、API キー経由で認証されていることを確認する
5. 必要に応じて使用モデルを --model または設定ファイルで指定する

環境変数で渡す場合は、シェルの設定ファイルに次のように記述しておくと、起動のたびに入力する手間が省ける。

export OPENAI_API_KEY="sk-..."
codex

環境変数とコマンドのどちらで渡すか

API キーの渡し方には、環境変数 OPENAI_API_KEY を使う方法と、codex login --api-key で Codex 側に保存する方法がある。前者はターミナルのセッションやシステム全体に効くため、複数のツールで同じキーを共有したいときに便利だ。後者は Codex の設定領域にキーを保存するため、その端末で Codex だけに使わせたい場合に向く。チームで端末を共有する環境では、キーが他のプロセスから読めない形で管理されているかを必ず確認しておきたい。

認証が通らないときの確認ポイント

API キーで認証できない場合、原因の多くは「キーの打ち間違い」「支払い方法が未登録」「アカウントのティアが低くレート上限に達している」のいずれかだ。まずは platform.openai.com 側でキーが有効か、使用量と残高に問題がないかを確認する。401 Unauthorized が返る場合はキー自体が無効か失効しており、429 Too Many Requests が返る場合は短時間にリクエストが集中しているか、ティアの上限に達している。エラーコードを切り分けてから対処すると早い。

ChatGPT 版と API キー版の料金の違い

最も気になるのが料金だ。ChatGPT プラン版と API キー版は、課金の考え方そのものが異なる。ChatGPT プラン版は月額の定額制で、決められたレート上限の範囲なら追加課金は発生しない。対して API キー版は、入力トークンと出力トークンの量に応じて課金される従量制で、使えば使うほど料金が積み上がる。つまり前者は「上限はあるが料金は読める」、後者は「上限はないが料金は使用量しだい」という関係になる。実際の単価は OpenAI の料金ページで随時更新されるため、見積もりの際は必ず公式の最新情報を参照したい（出典: https://platform.openai.com/docs/pricing）。

トークン課金を抑える設計

API キー版では、Codex に渡すコンテキストの量が料金に直結する。リポジトリ全体を無条件に読ませるのではなく、関連するファイルやディレクトリに絞って指示することで、入力トークンを節約できる。AGENTS.md に作業範囲やコーディング規約を簡潔にまとめておけば、毎回長い説明を書かずに済み、トークンの無駄を減らせる。出力についても、生成してほしい範囲を具体的に指定することで、不要な長文回答を避けられる。料金最適化はプロンプト設計と表裏一体だと考えるとよい。

どちらを選ぶべきか

判断の目安はシンプルだ。日々のコーディング支援や対話的な開発が中心で、利用量が月のレート上限に収まるなら、料金が読みやすい ChatGPT プラン版が無難だ。一方、夜間にまとめて多数のタスクを処理する、複数リポジトリへ横断的に変更を入れる、社内ツールに Codex を組み込むといった用途では、上限のない API キー版が現実的になる。両者は排他ではないため、普段は ChatGPT プラン、特定の用途だけ API キーという併用も十分にあり得る。

codex exec でスクリプトに組み込む

API キー版の強みが活きるのが、対話せずに 1 コマンドで処理を終える codex exec だ。通常の codex は対話的なセッションを開くが、codex exec はプロンプトを引数で渡し、結果を標準出力に返して終了する。これにより、Codex をシェルスクリプトやバッチ処理の一部として呼び出せる。たとえば、複数のリポジトリに対して同じ修正指示を順番に流す、といった機械的な処理を組み立てやすくなる。対話を介さないぶん、レビュー前提の使い方や検証用途では入力プロンプトを明確に書く必要がある（出典: https://github.com/openai/codex）。

codex exec "README の見出し構成を整理し、目次を追加してください"

非対話実行での注意点

codex exec は人の確認を挟まずに進むため、変更内容のレビューを後工程に置く設計が前提になる。意図しない大規模な変更を避けるには、プロンプトで対象範囲を限定し、変更後は差分を必ず人が確認する運用にしておきたい。また、従量課金の API キー版でまとまった件数を流すと、その分だけトークン消費が積み上がる。試験的に小さく流して 1 件あたりの消費量を把握してから、対象件数を広げると安全だ。

モデル選択と設定ファイル

API キー版では、使用するモデルを明示的に指定できる。最新の GPT-5.3-Codex を含め、用途に応じてモデルを切り替えられるのが特徴だ。コマンドラインで指定する場合は --model を使い、恒久的に固定したい場合は設定ファイル ~/.codex/config.toml に記述する。軽いタスクには応答の速いモデル、難度の高いリファクタリングには推論力の高いモデル、といった使い分けをすると、品質と料金のバランスを取りやすい。

# ~/.codex/config.toml
model = "gpt-5.3-codex"

モデルを使い分ける考え方

モデルの選択は、料金と品質のトレードオフそのものだ。高性能なモデルほど 1 トークンあたりの単価は上がる傾向にあるため、すべてのタスクを最上位モデルで処理すると料金がかさむ。定型的な編集や軽微な修正は標準的なモデルに任せ、設計を伴う複雑な変更だけ上位モデルに切り替えると、全体のコストを抑えられる。Codex はタスクごとにモデルを指定できるため、案件の難度に応じた割り当てを習慣にしておくとよい。

よくある疑問

Q: ChatGPT プランと API キーは同時に使えるか？

A: 使い分けは可能だ。普段は codex login の ChatGPT プランで運用し、特定の用途だけ環境変数 OPENAI_API_KEY を設定して API キー版を使う、といった併用ができる。認証情報をどちらに切り替えているかを把握しておけば、意図せず従量課金が発生する事態を防げる。

Q: API キー版に無料枠はあるか？

A: API キー版は基本的に従量課金で、使った分だけ請求される。無料枠や価格の詳細は時期によって変わるため、最新の条件は OpenAI の料金ページで確認するのが確実だ（出典: https://platform.openai.com/docs/pricing）。

Q: 料金が想定より高くなる主な原因は？

A: 多くはコンテキストの渡しすぎだ。大きなファイルやリポジトリ全体を毎回読ませると入力トークンが膨らむ。対象を絞り、AGENTS.md に前提を集約し、出力範囲を具体的に指定することで、消費トークンを抑えられる。

Q: API キーが漏れたらどうすればよいか？

A: ただちに platform.openai.com で該当キーを失効させ、新しいキーを発行して差し替える。キーは画面に再表示されないため、発行時に安全な場所へ控え、共有リポジトリや公開される場所に書き込まないことが原則だ。

まとめ

Codex を API キーで使う際の要点を整理する。

1. Codex の認証は「ChatGPT プランでのサインイン」と「API キーでの従量課金」の 2 経路
2. API キー版は OPENAI_API_KEY の設定か codex login --api-key で利用でき、上限のない従量制
3. 料金は ChatGPT プラン版が定額・レート上限あり、API キー版がトークン従量という根本的な違いがある
4. codex exec を使えば対話なしで処理を完結でき、スクリプトやバッチ処理に組み込める
5. モデルは --model や ~/.codex/config.toml で指定でき、難度に応じた使い分けが料金最適化につながる

日常的な開発なら ChatGPT プラン、機械的な大量処理や独自ツールへの組み込みなら API キー——この軸で選べば、用途と料金のミスマッチを避けられる。まずは小さく試して 1 件あたりのトークン消費を把握し、そこから対象を広げていくのが、Codex を API キーで安全に使いこなす近道だ（出典: https://github.com/openai/codex）。