APIキーでCodexを使う入口の選び方と確認手順を迷わないために

APIキーでCodexを使う前に三つの入口を分ける

「CodexをAPIキーで使う」という言い方には、少なくとも三つの利用形態が含まれる。Codex CLIを自分の端末で開き、ファイルを読み書きしながら対話する形。自分のアプリからResponses APIを呼び、入力されたコードやエラーを処理する形。そしてAgents APIでCodexの実行基盤、セッション、環境を組み合わせる形だ。前者は作業者が画面を見ながら進めるのに向き、中者は処理の一部を組み込むのに向き、後者は継続する作業や複数の道具を扱うのに向く。

APIキーを作っただけで三つが同じ状態になるわけではない。APIのキーは請求先となるプロジェクトや利用上限に結び付き、CLIのサインインはクライアントの認証状態に結び付く。Agents APIではさらに、アプリが送り込む入力、OpenAIが管理するセッション、コードを動かす環境を切り分ける必要がある。まず表のどの行を使うのかを決め、それからキーの準備へ進むのが安全だ。

2026年9月にAPIキーを見直す理由

APIキーの解説は、キーを作って環境変数へ入れるだけで終わりがちだ。しかし2026年9月30日時点では、Codexを使う面がCLI、IDE、Web、モバイル、APIへ広がっている。入口が増えるほど、同じ「コードを直す」という目的でも、結果の保存場所、使用量、モデルの指定、確認を挟む箇所が変わる。今の時点で違いを整理しておくと、サインインできたのにAPIから呼べない、API料金を想定していたのにクラウド環境の費用が増える、といった混同を減らせる。

9月10日のAgents API公開ベータ

OpenAIは9月10日、Codexを支える実行基盤をAPIから利用するAgents APIを公開ベータとして案内した。公式説明では、アプリが入力を送り、管理されたセッションが状態を持ち、必要に応じてサンドボックスやツールを使う構成になっている。ここでのAPIキーは単なる文章生成の合図ではなく、セッションを作り、選んだモデルを使い、環境との接続を許可する入口になる。詳細はOpenAIの発表とAgents API公式概要を分けて読むとよい。

9月29日のCodex Cloud更新

9月29日に更新されたCodex Cloudの公式ヘルプでは、準備した環境をデスクトップやWebで作り、モバイルから同じクラウド作業を続ける使い方が示されている。これは自分のアプリがAPIキーでモデルを直接呼ぶ形とは違い、OpenAI側の作業環境とCodexのセッションを利用する形だ。キーを環境へ渡して似た操作を再現しようとするより、まずCloudで足りるか、APIとして組み込む必要があるかを決める方が整理しやすい。最新の範囲はCodex Cloudの公式ヘルプで確認できる。

10月14日のGPT-5.5終了告知

OpenAIのリリースノートでは、GPT-5.5が2026年10月14日にChatGPT、ChatGPT Work、Codexから終了し、APIには適用されないという案内が出ている。APIキー利用では、キーそのものだけでなく、アプリや設定ファイルに残したモデル名も点検対象になる。Codex側で保存したモデル設定と、API側のモデルIDを同じものとして扱わず、実際に選べるモデルと価格を別々に確認する必要がある。移行日と対象範囲はOpenAI公式リリースノートを基準にしたい。

ChatGPTのサインインとAPIキーは同じではない

Codex CLIを初めて起動したとき、ブラウザーでChatGPTに入る道が表示されることがある。この体験が簡単なので、「ChatGPTに入れたならAPIキーも使える」「APIキーを作ればCLIの画面にも同じ履歴が出る」と考えやすい。しかし実際には、アカウントでクライアントへ入る方法と、APIリクエストにキーを付けて利用量を計上する方法は別の層だ。プラン、組織、プロジェクト、モデルの利用条件が同じとは限らない。

Codex CLIを対話的に使う場合

手元のフォルダーを読み、変更前後の差分を見ながら作業したいなら、まずCodex CLIの公式案内に従ってサインイン方式を選ぶ。ChatGPTでのサインインを使う場合は、CLIが表示する認証画面と現在の公式手順を基準にし、APIキーを無理に貼り付けない。反対にAPI課金で使う必要がある場合は、CLIの版と利用方式がAPIキーに対応しているかを先に確認する。古い記事のコマンドをそのまま使わず、Codex CLIの公式ドキュメントとサインイン方式の公式ヘルプを照合するのが確実だ。

アプリからOpenAI APIを呼ぶ場合

自分のツールに「この関数の不具合を説明して」「この差分のテスト案を出して」といった機能を組み込むなら、APIキーはアプリ側の設定として扱う。リクエストにはモデルと入力を渡し、返ってきたテキストや構造化された出力をアプリで表示する。ここではCodex CLIのセッションを起動するのではなく、Responses APIの呼び出しを設計する。キーの作成、SDKの導入、環境変数の扱いは公式SDK案内を出発点にし、モデルごとの入力形式や料金はコード生成ガイドで確認する。

Agents APIで長い作業を扱う場合

ファイルを置く場所、使えるツール、途中経過、続きの入力まで一つの作業として保持したい場合は、直接のResponses APIよりAgents APIが適することがある。Agents APIでは、アプリのキー、エージェントの設定、セッション、実行環境を分けて考える。キーが有効でも、対象プロジェクトに必要なAPI権限がなければセッションを作れない。またセッションを作れても、環境にファイルやツールがなければコード作業は進まない。最初から複雑にせず、Agents API概要の基本概念を読み、最小のセッションから確認する。

APIキーを用意する前に決めること

キーは便利だが、作成前に「誰が使うか」「どのプロジェクトの費用にするか」「どのモデルを選ぶか」「どの環境へ渡すか」を決めておく必要がある。個人の検証なら専用のプロジェクトを一つ用意し、用途を短く記録したキーを一つだけ使う。チームのアプリなら、個人のキーを共有せず、管理者が定めたプロジェクトと権限を使う。キーの数を増やすことより、停止・交換・利用量の確認を誰が担当するかを先に決める方が重要だ。

この順序を決めてから設定に進めば、後でキーを増やしたり認証方法を戻したりする作業を減らせる。

手元のコードを確認しながら進めるなら

ローカルのリポジトリを読み、編集結果を自分で確かめるなら、Codex CLIやIDEのサインインが最も分かりやすい。APIキーを用意しても、ファイルの読み書き範囲や承認の画面まで同じになるわけではない。最初の目的が「APIから生成結果を受け取る」ではなく「自分の作業場所でCodexに相談する」なら、APIキーの作成を後回しにしてもよい。

自分のアプリにコード処理を組み込むなら

入力を受けて説明、修正案、テスト案を返す機能を作るなら、APIキーとResponses APIを組み合わせる。ここではコードを直接変更させるのではなく、まず読み取り専用の入力と短い応答から始めると、モデルの出力、料金、エラーを観察しやすい。生成結果をそのまま採用せず、人が差分やテストを確認する画面を用意すると、キーの利用範囲と結果の責任範囲を分けられる。

継続するセッションや環境が必要なら

何度も入力を送り、途中のファイルや調査結果を引き継ぎたいならAgents APIを検討する。作業を続けられることは便利だが、セッションの保存期間、環境の初期状態、許可するツール、利用量を一度に決める必要がある。単純なコード説明までAgents APIに寄せると構成が重くなるため、短い応答はResponses API、状態を保つ必要があるものだけAgents APIという境界を置くと判断しやすい。

WindowsでAPIキーを準備する手順

Windowsでは、現在のPowerShellだけにキーを置くのか、新しく開いたPowerShellでも使える利用者環境変数に置くのかを最初に決める。公式のSDK案内にはPowerShellの例としてsetx OPENAI_API_KEYが載っているが、setxを実行した現在のウィンドウには直ちに反映されない。新しいウィンドウを開くこと、値そのものを画面へ表示しないこと、対象プロジェクトと利用上限を記録することが準備の要点になる。

1. OpenAIのAPIダッシュボードで、用途が分かるプロジェクトを選び、APIキーを作成する。個人の検証とチームのアプリで同じキーを使い回さず、後から停止や交換を判断できる名前を付ける。
2. キーを作成した直後に表示される値を安全な場所へ一度だけ移し、PowerShellでsetx OPENAI_API_KEY "ここに自分のキー"を実行する。記事やソースコードへ値を貼り付けない。
3. PowerShellをいったん閉じて新しく開き、$env:OPENAI_API_KEYが空でないことだけを確認する。確認のためにキー全文を表示したり、ログへ出力したりしない。
4. APIを呼ぶアプリでは、公式SDKを導入し、まず短い入力で1回だけ応答を取得する。モデル名、応答時間、利用量、エラーの有無を記録し、いきなり大きなリポジトリを送らない。
5. 利用量と支出上限をダッシュボードで確認し、必要ならキーを交換する。動作確認が終わった後も、使わないキーを残さず、作業の終了時点を記録する。

キーを画面やファイルに残さない

APIキーはパスワードと同じように、チャット、スクリーンショット、公開リポジトリ、共有ログへ書かない。PowerShellの履歴やエラー出力へ値が混ざらないよう、確認コマンドは値の有無だけを返す形にする。アプリへ渡す場合も、ソースコードに直接書かず、実行時に参照できる環境変数や管理者が定めた保管場所から読み込む。もし表示・共有してしまったら、値を隠すだけで済ませず、ダッシュボードで直ちに無効化して新しいキーへ交換する。詳しい注意点はOpenAI APIの本番運用ガイドを確認したい。

APIキーで最初の1回を確認する

準備が終わったら、いきなり複雑なコード修正を依頼せず、認証、モデル、応答、利用量の四つを小さく確認する。ここで大切なのは、成功した文字列だけを見るのではなく、どのプロジェクトで、どのモデルを使い、どの入口から呼び出したかを残すことだ。APIのレスポンスが返っても、Codex CLIのセッションやCloudのファイルが同じ場所にあるとは限らない。入口ごとに結果を分けて記録する。

1. まず「短いコード片の問題点を一つ説明してください」のような入力を送り、キーが有効かを確かめる。
2. 応答に表示されたモデル名やレスポンス情報を確認し、想定したモデルと一致するかを記録する。
3. 同じ入力を何度も送らず、ダッシュボードで使用量と支出の増え方を見る。料金はモデル、入力・出力トークン、利用するツールによって変わる。
4. 取得した回答を人が読み、コードへ反映する前に、誤った前提や存在しないAPI名がないかを確認する。
5. 確認後はテスト用のキーをそのまま残すか、無効化するかを決め、プロジェクト名・モデル名・確認日を短く記録する。

失敗したときに見る順番

応答が返らないときは、キーの値を何度も貼り直す前に、エラーの種類を分ける。401系ならキーの有効性や参照先、403系ならプロジェクトの権限やモデルの利用可否、429系なら時間あたりの上限や支出制限、400系なら入力形式やモデルIDを確認する。CLIのサインイン画面が出る場合は、APIキーの問題ではなくCLI側の認証方式を見ている可能性もある。エラー本文にキーが含まれていないことを確かめたうえで、公式のAgents API概要やAPIリファレンスに照らし合わせる。

APIキー利用で混同しやすい料金とモデル

APIキーを使えば定額で無制限になるわけではない。APIの利用料は選んだモデル、入力と出力の量、キャッシュの扱い、専用ツールやホスト環境の有無で変わる。Codex CLIやChatGPTのプランに含まれる利用枠と、APIプロジェクトに計上される利用料も同じとは限らない。特にAgents APIはセッションの処理だけでなく、選択したモデルやOpenAIが用意する環境に関わる料金を確認する必要がある。

モデル名は入口ごとに記録する

Codexの画面に表示されるモデル名、APIで指定するモデルID、設定ファイルに残る既定値は、同じ表記になるとは限らない。GPT-5.5の終了告知のように、ある入口だけが対象になる更新もある。記事やSNSに書かれた古いモデル名をそのまま貼らず、APIのモデル一覧、Codexの設定画面、リリースノートの三つを照合する。変更前後でモデル名を記録すれば、品質や料金が変わったときに原因を追いやすい。

利用量は小さな入力から測る

コード全体を毎回送ると、入力トークンが大きくなり、結果の比較もしにくい。最初は短い関数や小さな差分を使い、同じ入力、同じモデル、同じ出力形式で一度だけ測る。そのうえで実際のアプリに近い入力へ段階的に広げる。利用量の表示が遅れて反映される場合もあるため、画面の数字だけで即断せず、請求期間とプロジェクトを確認する。

APIキーでCodexを使う判断表

ここまでの違いを、目的から入口へ戻す形で整理する。手元のコードを開いて人が差分を見ながら進めるなら、APIキーの作成より先にCodex CLIのサインイン方式を選ぶ。入力フォームや社内ツールからコードの説明を呼び出すなら、OpenAI APIとAPIキーを使い、短い応答から料金を測る。ファイルやツールを含む長い処理を同じセッションで続けるなら、Agents APIのセッションと環境を別々に設計する。

迷ったときの基準は、「APIキーが必要か」ではなく「どこに状態を置き、誰が結果を確認するか」だ。状態を持たない短い応答なら直接API、手元の確認を重視するならCLI、状態と実行環境が必要ならAgents APIまたはCloudを選ぶ。選んだ入口と理由を1行で残せば、後から別のモデルや入口へ移るときにも、キーを増やすだけの変更にならない。

まとめ

APIキーでCodexを使うときは、ChatGPTのサインイン、Codex CLI、OpenAI API、Agents API、Codex Cloudを同じものとして扱わないことが出発点になる。2026年9月のAgents API公開ベータとCodex Cloud更新により、コード処理を組み込む道と、環境を含む長い作業を預ける道がはっきり分かれた。まず目的に合う入口を一つ選び、専用プロジェクト、モデル、利用量、確認範囲を小さく試す。APIキーは値を表示・共有せず、使用量と停止方法まで含めて管理すれば、Codexを必要な場所だけで安全に使い始められる。