Codex CLI：決定版テクニカルリファレンス

要約： Codex は、複数のサーフェスで動作するコーディングエージェントです。コードベースを読み取り、OS レベルのサンドボックスでコマンドを実行し、ファイルへパッチを適用して、タスクをクラウドに委任します。config.toml、サンドボックス／承認モデル、AGENTS.md、MCP、skills という5つの仕組みを習得すれば、Codex は大きな力を発揮します。モデルの選び方： OpenAI のモデルドキュメントでは現在、複雑なコーディングやエージェント型の作業には GPT-6.1 Sol（gpt-6.1-sol、v0.159.1 以降における CLI の標準搭載モデル）、最難関のエンドツーエンド作業には GPT-6-Astra、焦点が明確で反復可能なタスクには GPT-6 Luna を推奨しています。利用可否はプラン、クライアント、ワークスペース設定によって異なります。GPT-6 Sol と GPT-5.6 モデルは引き続きモデル選択画面に表示されますが、ChatGPT サインインで利用する GPT-5.5 は、2026年10月14日に Codex での提供を終了します。^146171178 初めての方は、インストールとクイックスタートから始めてください。リリースを追っている方へ：最新の安定版は v0.160.1（2026年10月5日）です。これは、デフォルト設定を変更しなかった v0.160.0 に、リモート MCP の修正を加えたものです。リリースハイライトでは、まず現在の状態（デフォルトで有効な機能と、まだ実験段階にある機能）をまとめ、その後に各バージョンを解説しています。変更履歴には、このガイドのすべての更新が記載されています。^116178182183

Codex は、コードを書くチャットボットではなく、複数のサーフェスで動作するコーディングエージェントです。 CLI はコードベースを読み取り、サンドボックス内でコマンドを実行し、ファイルへパッチを適用します。さらに、MCP を介して外部サービスに接続し、長時間実行されるタスクをクラウドへ委任できます。ローカルで動作しながら、全体を見渡して判断します。作業スタイルに応じて、同じ知能を5つの異なるサーフェスで利用できます。その1つがブラウザー拡張機能で、Chrome、Edge、Brave、Opera、Vivaldi に対応し、ブラウザーを乗っ取ることなく、その中で Codex を実行します。⁹⁰¹²⁷

Codex を気軽に使うだけで終わるか、効果的に活用できるかは、5つの中核システムを理解しているかどうかで決まります。 これらを習得すれば、Codex は大きな力を発揮します。

1. 設定システム：config.toml を通じて動作を制御します
2. サンドボックスと承認モデル：Codex に許可する操作を制御します
3. AGENTS.md：プロジェクトレベルの運用ルールを定義します
4. MCP プロトコル：外部サービスと連携して機能を拡張します
5. Skills システム：再利用可能な専門知識をパッケージ化します

私は数か月にわたり、本番環境のコードベース、CI/CD パイプライン、チームのワークフローで、Codex と Claude Code を併用してきました。このガイドには、その経験を凝縮し、使い始めた当時に欲しかった完全なリファレンスとしてまとめています。すべての機能について、実際の構文、実用的な設定例、そして経験豊富なユーザーでもつまずきやすいエッジケースを掲載しています。

主なポイント

• 5つのインターフェース、1つの頭脳：CLI、デスクトップアプリ、IDE拡張機能、クラウドタスク、ブラウザー拡張機能（Chrome、Edge、Brave、Opera、Vivaldi）は、いずれも同じモデルファミリーを共有しています。ワークフローに合ったインターフェースを選びましょう。⁹⁰
• OSレベルのサンドボックス化：Codexは、コンテナ内ではなくカーネルレベル（macOSではSeatbelt、LinuxではLandlock + seccomp）でファイルシステムとネットワークの制限を適用します。
• AGENTS.mdは複数のツールで利用可能：プロジェクトの指示は、Codex、Cursor、Copilot、Amp、Jules、Gemini CLI、Windsurf、Cline、Aider、Zed、および60,000以上のオープンソースプロジェクトで機能します。一度書けば、どこでも利用できます。
• プロファイルでコンテキスト切り替えの負担を軽減：名前付きの設定プリセット（fast、careful、auto）を定義し、--profileで切り替えられます。
• コンテキスト管理が重要：Codexに組み込まれたカタログでは、GPT-6.1 Sol、GPT-6 Astra、Sol、Luna、およびGPT-5.6ファミリーのコンテキストウィンドウは272Kです（APIでは、GPT-6.1 Sol、GPT-6 Sol、Lunaは1.05Mと記載されています）。GPT-5.5は、2026年10月14日にCodexで提供終了となるまで、400Kを利用できます。/compact、焦点を絞ったプロンプト、@file参照を活用し、トークン予算を先回りして管理しましょう。^83112178

このガイドの使い方

これは3,300行を超えるリファレンスです。経験レベルに合った箇所から始めましょう。

末尾のクイックリファレンスカードでは、主要なコマンドをひと目で確認できるようにまとめています。

リリースハイライト：最近の変更点

Codex のリリース履歴を追う読者向けに、バージョンごとの記録を新しい順で掲載します。初めての方は「クイックスタート」まで進んでください。以下の内容を読まなくても、すぐに使い始められます。検証の詳細（比較、コミット一覧、ドキュメントの確認）は脚注に記載しています。

現在の状況

2026年10月6日時点の Codex CLI

• 安定版： v0.160.1（10月5日、npm latest）は、リモート MCP の修正版です。これは、オプトインの Guardian 機能を追加しつつデフォルトを変更していない v0.160.0（10月1日）と、v0.159.3（9月30日）に続くリリースです。
• アルファ版： npm alpha は 0.162.0-alpha.16 です。0.161 系の安定版はリリースされていません。
• v0.159.1以降のデフォルトモデル： GPT-6-Astra に代わって GPT-6.1 Sol がデフォルトとなり、Amazon Bedrock でも同様です。別のモデルを維持するには、config.toml で model を設定してください。
• v0.158.0以降デフォルトで有効： 権限昇格されたターミナルへの入力時の承認（[features] で write_stdin_approval = false にすると無効化）、およびフルスクリーン TUI での選択時コピーと右クリックによる貼り付け（[tui] で copy_on_select = "never"、right_click_paste = "off" にすると無効化）。Guardian のスレッドコンテキストは常に有効で、thread_context は無視されます。
• v0.157.0以降デフォルトで有効： フルスクリーンのトランスクリプト（[tui] で fullscreen_transcript = false にすると無効化）とバックグラウンドサーバーの自動起動（[features] で daemon_auto_start = false にするか、--no-daemon を指定）。
• v0.156.0以降デフォルトで有効： /voice、管理対象の worktrees、Guardian による親コンパクションの再利用。
• オプトインまたは実験的機能： Codex Cloud、コードモード、instant_interrupt、Guardian の履歴取得（guardian_conversation_history_tools、v0.160.0）。実験的なコンテキスト管理は現在利用できません。
• モデル： 複雑なコーディングには GPT-6.1 Sol、最も難しい作業には GPT-6-Astra、反復可能なタスクには GPT-6 Luna を使用します。GPT-6 Sol と Luna は Fast（クレジット消費量2.5倍）で開始しますが、GPT-6.1 Sol は対象外です。GPT-5.5 は2026年10月14日に Codex から提供終了となります。
• バージョンの固定： npm install -g @openai/codex@0.160.1 を実行してから、codex --version を実行します。^{176178182183185}

v0.160.1（2026年10月5日）

Windows 上のリモート MCP サーバーに関する修正です。 macOS または Linux ホスト上の Codex からリモートの Windows 実行環境で stdio MCP サーバーを起動し、そのサーバーの設定でリモート環境変数を明示的に指定している場合、SYSTEMROOT、TEMP、TMP も渡されるようになりました。これにより、Windows プロセスの起動に必要な環境が維持されます。シークレットを含め、要求していない変数は引き続き除外されます。このリリースは v0.160.0 に1件のバックポートを加えたもので、デフォルト、設定キー、モデルに変更はありません。

対応：Unix ホストから Windows 実行環境上のリモート stdio MCP サーバーを実行している場合は、アップグレードしてください。¹⁸³

v0.160.0（2026年10月1日）

0.160 系の安定版で、0.160.0-alpha.6.1 に1件のバックポートを加えてリリースされました。デフォルトの変更はありません。 このタグに同梱されているモデルカタログは、v0.159.1およびv0.159.2とバイト単位で同一です。そのため、GPT-6.1 Sol が引き続きデフォルトとなり、2つの新しい機能フラグは無効な状態で提供されます。バックポート（#49763）により、v0.159.1より前に分岐して凍結されていた0.160のリリース候補へ、0.159メンテナンス系の変更が取り込まれました。対象は、同梱版および Amazon Bedrock 向けの GPT-6.1 Sol カタログと、v0.159.3のアカウントセキュリティ通知です。このバックポートがなければ、0.160には GPT-6.1 Sol が含まれないままリリースされていました。

オプトインの Guardian 追加機能（いずれも開発中で、デフォルトでは無効）：

• Guardian が過去のユーザーメッセージを参照できます。 [features] で guardian_conversation_history_tools = true を設定します。Apps が有効な場合、レビュー担当は親セッション自身の Apps 接続を通じて user_message.search_messages と user_message.read_messages を利用できます。これにより、副作用を伴う操作を承認する前に、以前の指示、制限、取り消された権限を確認できます。呼び出しのたびに、親セッションの現在のアプリおよびツールポリシーが再確認されます。レスポンスは、デフォルトで推定4,000トークンに制限されます（auto_review.conversation_history_max_output_tokens）。また、auto_review.experimental_conversation_history_prompt を指定すると、組み込みの取得指示が置き換えられます。
• 引き継ぎを考慮したルートコンテキスト（guardian_root_handoff_context）：Guardian がワーカーエージェントの操作をレビューするとき、そのワーカーまたは祖先への各引き継ぎ直前にある3件のルートメッセージと、最新のルートメッセージ3件を選択します。これにより、直近のキャンセル指示を見落としません。

常に有効：暗号化されたエージェントメッセージが破棄されず、順番どおりに Guardian のトランスクリプトへ表示されるようになりました。

TUI の変更：プロジェクト設定も保存済みの信頼判断もないフォルダーでは、新しいセッションを workspace-write 権限と細かな承認設定で開始できるようになりました。ただし、ローカル実行、ユーザー設定、管理ポリシーのすべてで許可されている場合に限ります。再開したセッションでは、上書きしない限り保存済みの権限が復元されます。また、/cd では「現在のディレクトリを維持」オプションとともに、フォルダーを信頼するか確認できます。エージェントコマンドセンターには「さらに表示」行が追加され、古いタスクを一度に10件ずつ読み込めます。ローカルの Linux X11 ターミナル（Wayland、SSH、tmux、WSL、VS Code は対象外）では、フルスクリーンのトランスクリプトで選択した内容がプライマリセレクションに格納され、中央クリックでコンポーザーに貼り付けられます。表示スペースがある場合、フルスクリーンのステータス行に Plan mode (shift+tab to cycle) と表示されます。/status と分析画面では、Pro プランの表記が「Pro 100」「Pro 200」「Pro 500」になりました。起動時のヒントには、プランや Fast モードの案内ではなく、使用中のプラットフォーム向けデスクトップアプリが表示されます。また、未送信のキューメッセージは、再接続後に重複することなく送信が再開されます。

プロバイダーと接続：TUI でアプリサーバーのプロバイダー、推論サマリー、詳細度の設定が維持され、再開およびフォーク履歴に適切なセッションが表示されるようになりました。サーバー接続では、/status の推論サマリー設定が非表示になります。モデルカタログ（model_catalog_url）を明示的に指定したプロバイダーでは、そのカタログのみが使用されるようになりました。同梱モデルは統合されず、メタデータは正確なモデル ID と一致します。更新に失敗した場合、キャッシュ済みのエントリは再利用されず破棄されます。利用可能なモデルがない状態で起動すると、model が設定されていない限り、設定エラーが報告されます。コンテンツフィルターによってレスポンスが停止された場合、再試行時には制限について説明し、許可される代替案を提示したうえで、ほかの作業を続行するようモデルに指示します。

修正：Windows サンドボックスでの PowerShell フォールバック、長いランタイムパスに対する ACL 修復、バックグラウンドヘルパーによるコンソールウィンドウ表示の抑制に対応しました。サブエージェントは、起動途中の環境も維持します。SQLite は接続設定時に停止しなくなり、タイムアウトではなく初期化エラーを報告します。ログデータベースはバックグラウンドで未使用領域を回収し、プラグインの読み込みでは解析済みマニフェストをキャッシュして HTTP 接続を再利用します。プロバイダーのドキュメントには、requires_openai_auth の認証情報が cli_auth_credentials_store で選択したバックエンドを使用することと、env_key が API キーを保持する環境変数の名前であることが明記されました。

対応：アップグレードしてください。カスタムプロバイダーで model_catalog_url を設定している場合は、選択するすべてのモデルがそのカタログに含まれていることを確認してください。¹⁸²

v0.159.3（2026年9月30日）

オプションのアカウントセキュリティ通知です。 OpenAI プロバイダーで ChatGPT にサインインしているローカル TUI セッションでは、アカウントのセキュリティ設定を完了するよう促す、閉じることのできるバナーが表示される場合があります。バナーには chatgpt.com を開くボタンもあります。表示対象はサーバーが決定します。CLI はターンを妨げることなくバックグラウンドで通知を取得し、状態が不明な場合は何も表示しません。リモートワークスペースと FedRAMP アカウントは対象外で、閉じた状態はスレッドをまたいだ場合や再接続後も維持されます。使用量に関するバナーが優先されます。これがこのリリース唯一の変更で、v0.160.0にも同じコードが含まれています。

対応：何もする必要はありません。この通知への対応は任意です。¹⁸⁴

v0.159.2（2026年9月29日）

コンソールウィンドウの点滅に関する Windows 向け修正です。 Windows では、Codex がバックグラウンドプロセスを開始するたびにコンソールウィンドウが開かなくなりました。対象には、シェルツールのコマンド、hooks、Git と npm の呼び出し、ターミナルを使わずに実行される Amazon Bedrock の認証情報更新、doctor チェック、サンドボックス設定の更新、従来の Windows サンドボックス内のコマンドが含まれます。ターミナルを必要とするコマンドは、引き続きそのコンソールを継承します。このリリースは、main から2件の修正を1件としてバックポートしたもので、v0.159.1の約3時間半後に公開されました。デフォルト、設定キー、モデルに変更はなく、新しい起動ヘルパーも macOS と Linux では従来どおり動作します。

対応：Windows で Codex の動作中にコンソールウィンドウが点滅する場合、特にバックグラウンドサーバーをインストールしている場合は、アップグレードしてください。¹⁸⁰

v0.159.1（2026年9月29日）

GPT-6.1 Sol がデフォルトモデルになりました。 config.toml でモデルを設定していない場合、CLI は GPT-6-Astra ではなく GPT-6.1 Sol（gpt-6.1-sol）で起動するようになりました。また、Amazon Bedrock の Mantle および Runtime カタログでも、GPT-6 Sol に代わって GPT-6.1 Sol がデフォルトになりました。/model の選択画面では、GPT-6.1 Sol が「コーディングや日常業務向けの最新の主力モデル」として先頭に表示され、続いて GPT-6-Astra、GPT-6 Sol（現在は「前世代の主力モデル」）、GPT-6 Luna、旧モデルの順に並びます。保存済みの選択内容は移行されません。gpt-6-sol または gpt-6-astra を指定した設定では、そのモデルが引き続き使用されます。また、以前の GPT-5 を選択している場合の移行プロンプトでは、引き続き GPT-6 Sol または GPT-6 Luna が案内されます。 OpenAI のドキュメントでも同日にこのモデルが追加され、複雑なコーディングやエージェント型ワークフロー向けとして推奨されています。「複雑な作業で Astra に近い性能を、Astra より低いコストで実現する」モデルです。料金は入力トークン 100万あたり 50クレジット（キャッシュ済み入力は 2.5、出力は 250）で、Plus の利用枠は 15〜160メッセージです。カタログ上、GPT-6 Sol とは2つの違いがあります。デフォルトのサービスタイアがないため、セッションは Fast ではなく Standard の速度で始まります。また、デフォルトの推論レベルは medium ではなく low です。リリース時の提供対象は Plus、Pro、Business、Enterprise、Edu です。Enterprise と Edu では管理者が有効にするまで無効のままとなり、Free と Go はリリース時点では対象外です。

対応方法：アップグレード後、/status でモデルを確認してください。アカウントで GPT-6.1 Sol をまだ利用できない場合は、利用可能なモデルを config.toml の model または -m で固定します。¹⁷⁸

v0.159.0（2026年9月29日）

0.158.0-alpha.13 を基に、v0.158.0 の約27時間後にリリースされました。リリースノートに記載された項目のうち、Windows のコンソールウィンドウとランチャーの修正、Markdown を保持するコピー、ウェルカム画面とターンのヒント、サインインの修正は、バックポートとして v0.158.0 ですでに提供されていました。削除された設定としてノートに記載されている tui.prompt_suggestions は、安定版には一度も登場していません。

このリリースの新機能：

• instant_interrupt（オプトイン、開発中）：新しい入力によってモデルの応答を中断したり、長時間実行されているコードモードの呼び出しを譲らせたりできます。試すには、[features] で instant_interrupt = true を設定します。
• 警告ビューアーを閉じると、確認済みの警告が消去されます。後で確認できるよう残すには k を押してください。
• プランを実装するか判断している間も、トランスクリプトをスクロールできます。
• Mermaid レンダリングで、より多くのフローチャートのエッジ、ラベル、ノードグループを処理できるようになりました。
• 空のセッションでは、タスクを切り替えても下書きが保持され、最初のターンの前でもスレッドをアーカイブできます。
• /status が枠線なしで表示され、長い値は折り返されます。
• App-server クライアントでは、指定した項目からスレッド履歴をページ単位で取得できます。

サンドボックスの変更点：承認済みのコマンドでも、明示的なファイルシステム拒否ルールが維持されます。書き込み可能なルート配下の .aws ディレクトリはデフォルトで保護されますが、明示的なルールは引き続き優先されます。ネットワークが有効な macOS サンドボックスでは TLS の信頼性評価が許可され、プロキシが必要な実行環境にはプロキシが設定されるようになりました。同梱されていた plugin-creator skill は削除されています。

対応方法：サンドボックス化されたタスクが .aws 配下へ書き込む場合、明示的なルールを追加しない限りブロックされます。¹⁷⁷

v0.158.0（2026年9月28日）

0.158 系列の安定版で、0.158.0-alpha.15.4 を基にリリースされました。alpha.15 に、v0.157.1 の4件の Windows 修正を含む16件のバックポートを加えたものです。v0.157.0 より207コミット進んでいます。

変更されたデフォルト：

• ターミナル入力の承認が有効になりました。 Codex が昇格された権限（追加の権限付与、サンドボックスのバイパス、またはコマンド開始後に変更されたポリシー）を持つ実行中のコマンドへ入力を送る場合、先に承認が必要です。プラグインがメトリクスに使用するような実行時のみの権限付与では、レビューが発生しなくなりました。無効にするには、[features] で write_stdin_approval = false を設定します。
• フルスクリーンのトランスクリプトで選択時のコピーが有効になりました。マウスで選択した内容は、ボタンを放した時点でコピーされます。デフォルトの auto では、独自のコピーショートカットを転送する直接接続のターミナル（Ghostty 1.2 以降、macOS 上の Kitty、Windows Terminal、Windows 上の VS Code）では実行されません。コピー時には Markdown の書式が保持されます。[tui] で copy_on_select = "never"（または "always"）を設定できます。
• Windows、WSL、Linux のフルスクリーン TUI で右クリックによる貼り付けが有効になりました。[tui] で right_click_paste = "off" を設定すると無効にでき、"on" にすると macOS でも有効になります。
• Guardian のスレッドコンテキストが常時有効になりました。 v0.157.0 の無効化設定は廃止されました。プロファイルを含め、[features.guardianv2] の thread_context は無視され、Codex には削除を促す通知が表示されます。

モデルとプラン：GPT-5.4 は同梱カタログと Bedrock カタログから削除され、保存済みの GPT-5.4 の選択には引き続き GPT-6 Sol への移行を促すメッセージが表示されます。Codex が Pro Max プランを認識し、Pro の各ティアを「Pro」「Pro (More)」「Pro (Max)」と表示するようになりました。推論ショートカットでは Max まで選択できます。

さらに追加された機能：事前登録済みの OAuth クライアントシークレットを必要とする MCP servers（codex mcp add --oauth-client-secret）、exec-server の WebSocket 接続用ベアラートークン、生成画像の透明な背景、/ps での複数行コマンドプレビューです。修正内容には、Windows のサンドボックス障害（通常の Windows 10 パス、拒否された保存済み認証情報、大規模な権限ポリシー）、書き込み可能なルートが入れ子になっている場合の Linux サンドボックス起動、書き込み可能なルートをまたぐ Git メタデータの保護、パッチ承認での macOS パスエイリアスが含まれます。また、レビュー中にメッセージを送信した場合、Guardian のレビューが中止されず再試行されるようになりました。

対応方法：自動化によって昇格されたコマンドへキー入力を送信する場合は、承認プロンプトが表示されることを想定するか、この機能を無効にしてください。また、設定から thread_context を削除します。¹⁷⁶

v0.157.1（2026年9月26日）

main からバックポートされた4件の修正を含む Windows 向けパッチです。Codex がコードモードのホストやローカルの stdio MCP server を起動する際、コンソールウィンドウが開かなくなりました。Windows によってプロセスが外側のジョブオブジェクト内に残されている場合でも、バックグラウンドサーバーを起動できます。また、切り離されたバックグラウンドサーバーがランチャーの出力パイプを開いたままにしなくなりました。これまでは、ランチャーの終了後も呼び出し元のコマンドが待機し続けることがありました。GitHub のリリースノートと変更履歴には、ハイライトを「特定できなかった」としか記載されていません。上記の一覧は、このリリースのコミットに基づいています。

対応方法：Windows で Codex を実行している場合はアップグレードしてください。4件の修正はすべて Windows のみが対象です。¹⁷⁴

v0.157.0（2026年9月25日）

さらに3つのデフォルトを切り替えるリリースです。

• フルスクリーンのトランスクリプトがデフォルトで有効になりました。 v0.156.0 では /tui から利用できたフルスクリーン UI が、セッション起動時のデフォルトになりました。設定に [tui] セクションがない場合も同様です。ターミナルのスクロールバックを維持するには、/tui で Scrollback を選ぶか、[tui] で fullscreen_transcript = false を設定します。--no-alt-screen と tui.alternate_screen = "never" は引き続き優先されます。Shift キーを押しながらクリックすると、トランスクリプトの選択範囲を拡張できるようになりました。
• 対象となる対話型起動では、バックグラウンドサーバーが自動的に起動します。 このオプションは /experimental から外れました。--no-daemon、--oss、--profile、または大半の -c オーバーライドを指定した起動では使用されません。実行中のサーバー設定がセッションと一致しない場合、Codex はサーバーを使わずに実行する、必要な設定で再起動する、またはキャンセルする（デフォルト）という選択肢を提示します。自動起動を無効にするには、[features] で daemon_auto_start = false を設定します。
• Guardian のスレッドコンテキストがデフォルトで有効になりました。 同期レビューと非同期レビューの両方が対象で、Guardian v2 の enabled トグルとは独立しています。無効にするには、[features.guardianv2] で thread_context = false を設定します。

モデル：v0.156.1 で初めて提供された GPT-6 Sol と Luna は、このリリースにも含まれています。Amazon Bedrock のカタログにも追加され、Bedrock のデフォルトは GPT-5.6 Sol から GPT-6 Sol に置き換わりました。GPT-5.6 Sol では ultrafast サービスタイアが廃止され、Fast のみが残ります。同梱カタログでは、GPT-6-Astra が実験的なコンテキスト管理に対応しているという表記が削除されました（コンテキスト管理を参照）。

さらに追加された機能：別のアプリで開いている会話をフォークできる f ショートカットです。下書きとキューに入ったプロンプトも保持されます。/import はリモートセッションとバックグラウンドサーバーのセッションでも動作するようになりました。ターミナルでは Unicode の箇条書き、チェックボックス、位置を揃えた数式をレンダリングできます。修正により、スレッドを切り替えても音声会話が継続し、ターン終了時に未送信の回答が復元され、tmux のマウス設定が尊重されるようになりました。また、リアルタイム接続と単独のウェブ検索が設定済みプロキシを経由し、一時的に失敗したファイルアップロードは5分のタイムアウトで再試行されます。リダイレクト、オープンな HTTP 接続、WebSocket 接続にもネットワーク制限が適用されます。Windows では、サンドボックスオブジェクトへのアクセスがランナーのログオンセッションに限定されます。¹⁷⁴

v0.156.1（2026年9月23日）

安定版 CLI に GPT-6 Sol と GPT-6 Luna を追加する、変更点が1つだけのパッチです。どちらも /model の選択画面で GPT-6-Astra の下に表示されるようになりました。GPT-6-Astra は引き続き先頭に表示され、config.toml でモデルが設定されていない場合の同梱デフォルトでもあります。選択画面では GPT-5.6 ファミリーが旧モデルとして再分類され（GPT-5.6 Sol は「複雑な作業向けの旧世代コーディングモデル」と表示）、GPT-5.5 は「レガシーコーディングモデル」と表示されます。レート制限に近づいた際の切り替えメッセージでは、gpt-5.6-luna ではなく gpt-6-luna が提案されるようになりました。

設定で旧モデルを指定している場合は、移行を促すメッセージが一度だけ表示されます。保存済みの gpt-5.6-sol、gpt-5.6-terra、gpt-5.5、gpt-5.4 の選択は GPT-6 Sol を指し、gpt-5.6-luna と gpt-5.4-mini は GPT-6 Luna を指すようになります。このリリースでは Amazon Bedrock のカタログに変更はありません。GPT-6 Sol と Luna は含まれず、GPT-5.6 Sol が引き続き Bedrock のデフォルトです。

ドキュメントに記載されていないコスト上の注意点が1つあります。同梱カタログでは GPT-6 Sol と Luna のデフォルトのサービスタイアが Fast（priority）に設定されています。そのため、service_tier が未設定の TUI セッションは Fast モードで始まる場合があり、ChatGPT サインインでは Standard の2.5倍のクレジットが請求されます。/fast status で確認でき、/fast off で Standard に切り替えられます。 対応方法：アップグレード後、使い慣れたタスクで codex -m gpt-6-sol を試してください。利用可否は、プラン、ワークスペースの設定、ロールアウト状況によって異なります。Enterprise 管理者は、まず新しいモデルを有効にする必要があります。¹⁷¹

v0.156.0（2026年9月22日）

3つのデフォルト設定が一度に切り替わったリリースです。ドキュメントの変更履歴では、同日に最初の2つが発表されました。

• Voice がデフォルトで有効になりました。 対応ビルドでは、/experimental を開かなくても /voice からライブ会話を開始できます。さらに、設定可能な F8 トグル、今後の会話で使用する音声を選ぶ /voice settings、Linux および Windows 向けの同梱音声ランタイム、視差効果を減らす設定への対応も追加されました。
• Managed worktrees がデフォルトで有効になりました。 --worktree と /worktree に feature flag は不要です。worktree セッションは既存のローカル daemon に接続でき、agents の概要画面から作成することもできます。
• Guardian の親 compaction 再利用がデフォルトで有効になりました： Guardian がレビューセッションを再起動する際、親スレッドの暗号化された compaction を再利用できます。

それぞれを無効にする方法は、slash commands の表にある /voice と /worktree の行、および Guardian のセクションをご覧ください。

このほか、/tui で選択できるオプションの fullscreen TUI が追加され、トランスクリプト検索、マウスによる選択とコピー、右クリックコピー、クリック可能なリンク、警告ビューアーを利用できます。/theme では6種類の同梱テーマを選べるようになり、/usage 分析ダッシュボード、ターミナル内での Mermaid 図と TeX 数式のレンダリング（それぞれ個別のトグル付き）、/daemon メニュー、--no-daemon flag も追加されました。また、新しい TUI スレッドでは reasoning summaries がデフォルトで無効になりました。セキュリティ修正では、Windows の受信トラフィック、特権ソケット、読み取り専用ファイルハンドルに関する sandbox の不備が解消され、codex doctor のエラーに設定値が表示されなくなりました。バグ修正により、ターンが失敗または中断してもストリーミング済みの回答が保持され、tmux と SSH でのクリップボード転送が修復され、再開時に Plan mode が復元され、システムプロキシ経由でもログインを復旧できるようになりました。¹⁶⁹

v0.155.1（2026年9月18日）

1件の修正のみを含む hotfix です。0.155.0では、設定に model_reasoning_summary がない状態で新しいローカル TUI スレッドを開始すると detailed summaries が要求され、reasoning summaries に対応していないプロバイダーではリクエストが即座に拒否されていました。0.155.1ではフォールバックが none に戻され、キーが未設定なら summaries を要求しなくなりました。明示的に指定した auto、concise、detailed の設定は以前から反映されており、現在も変わりません。同じ1行の変更は main にも取り込まれ、0.156.0にも含まれています。

対応方法：0.155.0の新しい TUI セッションが OpenAI 以外またはセルフホスト型のプロバイダーで失敗していた場合は、アップグレードしてください。summaries が必要なら、キーを明示的に設定します（設定リファレンスを参照）。¹⁵⁸

v0.155.0（2026年9月17日）

Voice が、実験的なオプトイン機能として stable TUI に登場しました。対応ビルドでは /experimental から有効にすると、/voice でストリーミング形式のトランスクリプトとマイク操作を備えたライブ会話を開始できました。ミュート用ショートカットも設定でき、macOS パッケージには署名済みの音声リソースが含まれていました。5日後の v0.156.0 でデフォルト有効になりました。このリリースでは、Managed worktrees はデフォルトで無効のままです。

0.155.0では、ほかにも次の変更があります。

• MCP ユーザー検証： 対応する Mac のローカル TUI セッションで、Secure Enclave によって署名された Touch ID 検証を MCP リクエストに適用します。ワークスペース単位の ID 制限と、MCP ツールの継続処理におけるネイティブ検証にも対応しています。
• Windows の /sandbox-add-read-dir slash command が削除されました。
• Worktree 管理： agents の概要画面で worktree セッションを非表示、アーカイブ、削除できるようになりました。所有権の詳細も確認でき、変更のない managed worktree を削除する前には確認が表示されます。
• ライブ reasoning summaries が TUI のステータス行にストリーミング表示され、完了した処理には完了時刻が付きます。
• Daemon： 更新スケジュールを設定できるほか、codex app-server daemon update コマンドと、daemon 再起動後のスレッド復旧機能が追加されました。
• Amazon Bedrock の AWS 認証情報コマンドと、stable CLI リリースに合わせた Python SDK の公開機能が追加されました。

セキュリティ修正では、WSL interop を介した脱出と、shell snapshot による認証情報の露出が解消されました。Memory v2 はストレージと統合処理の基盤としてのみ導入され、この時点では利用可能な機能ではありません。¹⁵⁶

v0.154.0（2026年9月9日）

このリリースはおおむね 0.154.0-alpha.6 の時点で分岐されたため、alpha.7 で初めて登場したすべての機能（ライブ TUI Voice、MCP ユーザー検証、Memory v2、daemon 自動更新設定、reasoning-effort の固定）は0.155まで見送られました。

削除：codex mcp-server とスタンドアロンの codex-mcp-server バイナリが削除されました。連携機能は app-server プロトコルまたは Claude Code 向け Codex plugin に移行してください。Codex を外部 MCP servers に接続する codex mcp には影響ありません（Running Codex AS an MCP Server を参照）。従来の Guardian approval review 経路も廃止され、新しいユーザー指示によって承認が無効になった場合は、その承認が拒否されるようになりました。

新機能：

• 実験的な managed worktrees： --worktree または /worktree から利用でき、codex exec と TUI の worktree ブラウザーにも対応しています。
• 非同期ユーザーメッセージ： 下書きを失わず、Codex が作業を続けている間にインラインの質問へ回答できます。
• Windows サービス対応： sandbox のプロビジョニング、Windows 上の app-server daemon、管理された daemon 更新に対応しました。
• リモート権限プロファイル： app server から検出され、TUI で名前を指定して選択できます。
• Vim の R 置換モード、リアルタイムの context compaction ステータス、セッション開始時にモデルの対応状況によって有効化される実験的なコンテキスト管理が追加されました。

セキュリティ面では、ワークスペースの信頼が確立される前に PATH ヘルパーが実行されなくなり、macOS sandbox もターミナル入力インジェクションに対して強化されました。MCP 接続は OAuth token の更新を調整し、リモートでの再開と fork では保存済みの権限が維持されます。別のアプリで開いている会話を再開すると、読み取り専用のトランスクリプトが表示されます。Voice はランタイム基盤のみが提供され、Daybreak に関する最初のコード参照も追加されましたが、公開ドキュメントはありませんでした。¹⁵²¹⁵³

v0.153.3 および v0.153.4（2026年9月4日）

GPT-6-Astra の提供開始を CLI に反映した、同日公開のパッチです。v0.153.3では Astra が Amazon Bedrock のカタログに追加され（Bedrock のデフォルトは GPT-5.6 Sol のままです）、Astra の非同期確認に関するガイダンスが修正されました。v0.153.4では Astra がモデルピッカーに追加され、モデルが設定されていない場合の同梱デフォルトになりました。また、非同期質問のガイダンスに、ツールが利用可能な場合という条件が明記されました。

対応方法：Astra は v0.153.1 以降で -m gpt-6-astra を指定すれば利用でき、v0.153.4 以降ではピッカーにも表示されます。CLI の最低バージョンは文書化されていないため、これらを下限として扱ってください。同梱デフォルトで選択されるモデルをアカウントで利用できない場合は、デフォルトに任せず config.toml の model を明示的に設定してください。^145146147148

v0.153.1 および v0.153.2（2026年9月3日）

v0.153.1では、Guardian の computer-use スコアリングがモデル要件に従うようになりました。computer-use 専用のスコアリングと迅速な承認判断は、アクティブなモデルのメタデータで node_repl_auto_review_required が設定されている場合にのみ実行されます。また、スコアリングを省略するモデルに切り替えると、以前のスコアや処理中のスコアは無効になります。そのため、元のモデルへ戻しても古い承認が復活することはありません。リリース本文に記載されているのは、API から設定できる GPT-6-Astra カタログ項目のバックポートのみです。ピッカーとデフォルトが変更されたのは v0.153.4 からでした。v0.153.2では、Astra の Fast tier の説明が「1.5x」から「2x speed, increased usage」に修正されました（表示テキストのみ）。¹⁴²¹⁴³

v0.153.0（2026年9月3日）

• Vim の undo と redo： u と Ctrl+R で、貼り付けた内容や画像添付を含む composer の下書き全体を復元できます。vim_normal.redo は設定可能なキーマップアクションです。
• リモート plugin マーケットプレイス： plugin CLI でリモート plugin の一覧表示、インストール、削除が可能になり、codex plugin list には提供元、バージョン、インストールポリシー、認証ポリシーが表示されます。
• tui.auto_recap = false で自動 recap を無効にできます。手動の /recap は引き続き利用可能です。
• Plus と Team では rate-limit 警告が早めに表示されます。 約5時間の枠で残り許容量が半分を下回ると警告されます。その他のプランでは、従来どおり75%、90%、95%のしきい値が使用されます。
• Guardian の適用範囲が approval mode に連動します： Full Access では確認のみの操作に対する Guardian レビューが省略され、User approval mode ではバックグラウンドのスコアリングと事前ウォームアップが省略されます。
• features.context_management.experimental_mode（デフォルトでは無効）を有効にすると、Codex backend 上の対象となる Plus、Pro、Pro Lite セッションで、トークン予算に基づくコンテキスト、履歴メモ、new_context ツールを利用できます。
• tui.disable_paste_burst がトップレベルのキーを置き換えます。従来のキーもフォールバックとして引き続き機能します。

修正：app-server との接続が切れても、TUI セッションは下書きを保持したまま再接続されるようになりました。Guardian のレビュー履歴は compaction、再起動、fork を経ても維持され、記憶された MCP の承認は選択したアカウントのみに適用されます。¹⁴⁰

v0.152.0 および v0.152.1（2026年9月1日）

update_plan はオプトインに変更： tools.update_plan.enabled のデフォルトは false となり、無効な間は、組み込みの update_plan ガイダンスがモデル、コラボレーションモード、マルチエージェント、コンパクション、事前ウォームアップ、目標継続の各プロンプトから削除されます（「Plan Mode & Collaboration」を参照）。そのほか、/ と ?、さらに n/N を使った Vim 検索が追加され、オペレーターとの組み合わせにも対応しました。新しい下書きは Insert モードで開始されます。また、対処方法が分かるレート制限バナー、Amazon Bedrock の再認証を含む認証情報更新の進行状況、パッケージ形式の MCP サーバー名（:, @, /, . を使用可能）、MCP の openai/elicitation フォームリクエスト、ツールごとの MCP output_token_limit、信頼済みオリジンに限定されたクラウドタスクの認証情報、設定可能な thread/shellCommand タイムアウト、モデルメタデータを通じてデフォルトで有効になるトークン予算管理も追加されています。v0.152.1 では、Guardian の承認レビューが Node REPL ポリシーをモデルメタデータから取得できるようになりました。¹³⁸¹³⁹

v0.151.0（2026年8月29日）

• /recap を使うと、必要なときに会話を要約できます。また、条件を満たす非アクティブでフォーカスされていない会話は、Codex が自動的に要約します。
• コードモードのホストでは WebSocket トランスポートが廃止され、stdio と gRPC のみとなりました。
• 永続スレッドは、ストアが対応している場合、デフォルトでページ分割された履歴を使用します。
• persistent 推論エフォートが、時計ツールおよび組み込みのプロアクティブ動作ガイダンスとともに追加されました。
• Guardian v2 では、画像付きのコンピューター操作レビューがデフォルトになりました。
• Vim に f/F/t/T の検索・直前移動モーションと、gg/G が追加されました。
• 権限昇格したターミナルへの入力に、新たな承認を必須とする設定（write_stdin_approval、デフォルトでは無効）が追加されました。
• 任意の MCP サーバーに設定可能な猶予期間（mcp_optional_startup_grace_ms、デフォルトは1,000ミリ秒）が追加され、拡張機能から MCP ツールの結果を検査または置換できるようになりました。

修正により、/cd を使ってもサンドボックスの制限が弱まらなくなり、権限変更後に古い Guardian の分類によって操作が許可されることもなくなりました。リリース本文に掲載されているのは直近の数件の PR のみです。変更点の全体は比較ページで確認できます。¹³⁴¹³⁵

v0.150.0 および v0.150.1（2026年8月26〜27日）

hooks に Interrupt イベントが追加されました。アクティブな最上位ターンが中断された際に実行されます（デフォルトのタイムアウトは1秒、上限は3秒で、サブエージェントでは実行されません）。/copy では、レスポンス全体、個別のコードブロック、または引用ブロックを選択できるピッカーが開きます。タスクを @ メンションで指定できるようになり、エージェントはタスクの読み取り、作成、メッセージ送信が可能になりました。/rename では編集可能なタイトルが提案されます。Markdown リンクはクリック可能なラベルとして表示され、ショートカットで権限モードを順に切り替えられます。Vim には . による繰り返しが追加され、信頼されていないプロジェクトからは、プロジェクトレベルの AGENTS.md 指示が提供されなくなりました。features.network_proxy.credential_broker と Guardian v2 の review_scope.computer_use_only は、設定可能かつデフォルトでは無効な機能として追加されています。v0.150.1 では、保持された画像がリモートコンパクションのトークン予算に算入されます。¹³²¹³³

v0.149.0 および v0.149.1（2026年8月20〜24日）

untrusted 承認ポリシーは廃止されました。この値を指定している設定は on-request に移行してください。新たに、対話型の codex agents ダッシュボード、/cd、/pwd、/cwd、既存のローカルまたはリモートセッションへメッセージを送る codex queue、さらに多くの Vim 変更モーション、機能を拡充した codex doctor（エンドポイント保護、ネットワークとプロキシの障害、デスクトップアプリの状態、アップデート接続性）が追加されました。SDKs では max/ultra 推論エフォートも利用できます。再開またはフォークされたスレッドでは、権限プロファイルが復元されます。v0.149.1 では、codex exec --thread-source <SOURCE> が追加されました（user、subagent、memory_consolidation、または機能名を指定でき、TypeScript SDK では threadSource を使用します）。

同時期の価格改定として、OpenAI は8月21日から3か月間（少なくとも2026年11月21日まで）、GPT-5.6 Sol の価格を20%以上引き下げました。また、Sol の Codex クレジットレートも、入力、キャッシュ済み入力、出力の各100万トークンあたり125/12.5/750クレジットから100/10/500クレジットへ引き下げられました。^120121126

v0.147.0 および v0.148.0（2026年8月7〜18日）

v0.147.0 では、codex exec --full-auto が削除されました（v0.128 から非推奨）。代わりに、--sandbox workspace-write と承認フラグまたはプロファイルを使用してください。さらに、--approve-for-me、カタログを横断検索できるポータブルな Agent Plugins、オプトインの MCP 2026-07-28 プロトコル、会話セクションも追加されました。v0.148.0 では、Markdown 形式で出力する /export、codex exec fork、/status での推定クレジットまたはコスト表示、組み込みプロバイダーとしての Amazon Bedrock Runtime、非同期および MCP を呼び出す hooks、拒否されたパスや読み取れないパスで安全側に停止するサンドボックス制限が追加されました。¹¹⁶¹¹⁸

以前のリリース（2026年5〜7月）

• v0.146.0 および v0.146.1（7月29日、8月5日）： 設定済みプロキシがすべてのトランスポートを対象とするようになりました。Agent Plugins のマニフェスト、Amazon Bedrock と Claude Code のマーケットプレイス、スレッドのピン留めを伴うセッション命名、エグゼキューター提供の skills、サイバー能力を持つモデル向けに強化された自動レビューデフォルトが追加されました。¹¹⁴¹¹⁵
• v0.145.0（7月21日）： Claude Code に加えて Cursor からの /import に対応しました。音声機能はストリーミングのリアルタイム V3 会話として復活し、オプトインのマルチエージェント v2 エクスペリエンスが安定化されました。試験的なページ分割スレッド履歴と Amazon Bedrock ログインも追加され、組み込みの GPT-5.4 選択肢は GPT-5.6 Terra と Luna に移行しました。v0.144.6 では、GPT-5.6 のコンテキストウィンドウが272,000トークンに設定されました。¹¹¹¹¹²
• v0.140.0（6月15日）： /usage、codex delete と /delete、Claude Code からの /import、統合された @ メンションメニュー、Amazon Bedrock の API キー認証、CLI および MCP OAuth 認証情報の暗号化ローカルストレージが追加されました。従来の /realtime 音声コントロールは削除されました。¹⁰²
• v0.139.0（6月9日）： コードモードからウェブ検索を直接呼び出せるようになり、ツールスキーマで oneOf/allOf が保持されます。codex doctor はエディターとページャーの詳細を報告し、マーケットプレイスのソースが JSON の出力に表示されるようになりました。¹⁶⁵
• v0.138.0（6月8日）： /app で CLI セッションをデスクトップアプリへ引き渡せるようになり、マルチエージェント v2 では親からサブエージェントへ渡すタスクテキストが暗号化されます。¹⁶⁶¹⁰⁸
• v0.137.0（6月4日）： マルチエージェント v2、F13〜F24 の TUI キーバインド、v1 skills 拡張機能が追加されました。¹⁶⁷
• v0.132.0〜v0.135.0（5月20〜28日）： ローカルの会話履歴検索、主要なプロファイル選択方法としての --profile、デフォルトで有効な goals、権限プロファイルの継承と管理対象の requirements.toml、codex remote-control の開始と停止、より詳細になった codex doctor と /status、Vim テキストオブジェクト、/permissions の名前付き権限プロファイル、Python SDK 認証と Sandbox プリセット、codex exec resume --output-schema が追加されました。5月21日のアプリアップデートでは、Appshots、Goal mode の正式提供、オプトインのロック付き Computer Use が追加されました。^{96979899100101186}

従来の --full-auto は v0.147.0 で削除されており、js_repl も引き続き削除されたままです。^86878991116

安定性に関する注意： 安定しており、ドキュメント化されている領域：中核となる CLI と TUI、サンドボックス化と承認ポリシー、config.toml、AGENTS.md、skills、hooks、plugins、マルチエージェントツール、目標、権限プロファイル、/voice と管理対象の worktrees（v0.156.0 以降はデフォルト）、フルスクリーンのトランスクリプトとバックグラウンドサーバーの自動起動（v0.157.0 以降はデフォルト）、およびターミナル入力の承認、選択時のコピー、右クリックでの貼り付け（v0.158.0 以降はデフォルト）。Browser、Computer Use、Appshots はドキュメント化されたユーザー向け機能ですが、利用可否はプラットフォームとプランによって異なります。実験段階または開発中：Codex Cloud、code mode、Memory v2、ローカルエージェントのメッセージボード、instant_interrupt、Guardian の履歴および引き継ぎコンテキストに関するフラグ（v0.160.0）、ならびに本ガイドで [EXPERIMENTAL] と記載されているものや /experimental に掲載されているもの。これらはリリース間で変更される可能性があります。設定リファレンスによると、実験的なコンテキスト管理は「現在利用できません」。削除済み：--full-auto（v0.147.0）、untrusted 承認ポリシー（v0.149.0）、codex mcp-server（v0.154.0）、Guardian の thread_context オプトアウト（v0.158.0）、および js_repl。

Alpha チャンネル： alpha ビルドは1日に数回リリースされ、alpha 系列のリリース本文は簡素な仮内容となっています。また、古いベースから切り出された系列外ビルドも定期的に登場します。npm の alpha タグがそのようなビルドを指したことが少なくとも2回あり、その際は @alpha をインストールすると latest より古いビルドが導入されました。0.158 系列は 0.158.0-alpha.2（9月23日）から alpha.15（9月25日）まで進みました。安定版の v0.158.0（9月28日）は、系列外ビルドの 0.158.0-alpha.15.4、つまり alpha.15 に16件のバックポートを加えたものから切り出され、27時間後に v0.159.0 が公開されるまで npm の latest でした。0.159 系列は alpha.1（9月25日）から alpha.13（9月28日）まで進み、alpha.13 を基に v0.159.0 としてリリースされました。0.160 系列は 0.160.0-alpha.6（9月29日）に到達した後、そこで凍結されました。0.161.0-alpha.1 は alpha.6 からバージョン番号だけを変更したものです。9月30日には、0.160.0-alpha.6.1 で alpha.6 に不足していた v0.159.2 の Windows コンソール修正が1件追加されました。同日、0.159 系列ではさらに1つのパッチ、v0.159.3 がリリースされました。その後、0.160 系列は alpha.6.1 に1件のバックポートを加えた v0.160.0（10月1日）として安定版がリリースされ、続いて v0.160.1（10月5日）が公開されました。0.161 系列では alpha と系列外のバックポート版が作成され、最新版は 0.161.0-alpha.13.1（10月6日）ですが、安定版はありません。これより上位のバージョンも安定版としてリリースされていないため、スキップされたとはみなされません。現在、alpha は 0.162.0-alpha.16 を指しています。alpha を追跡する場合は、npm view @openai/codex dist-tags で確認し、@alpha ではなく正確なバージョンを指定してインストールしてください。^176179181185 最近の alpha 系列がどのように安定版へ移行したかを日付順にまとめた履歴は ¹⁷³ にあります。

Codex の仕組み：メンタルモデル

各機能を詳しく見る前に、Codex のアーキテクチャが日々の操作全体にどう影響するかを理解しておきましょう。このシステムは、共通のインテリジェンス層を基盤とする5つのサーフェスで動作します。

┌─────────────────────────────────────────────────────────┐
│                    CODEX SURFACES                       │
├─────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────┐   │
│  │   CLI    │  │ Desktop  │  │   IDE    │  │ Cloud  │   │
│  │ Terminal │  │   App    │  │Extension │  │  Tasks │   │
│  └──────────┘  └──────────┘  └──────────┘  └────────┘   │
│  Local exec     Multi-task    Editor-native  Async      │
│  + scripting    + worktrees   + inline edits detached   │
│  ┌──────────┐                                           │
│  │ Browser  │  Signed-in browser workflows              │
│  │Extension │  (launched May 2026)                      │
│  └──────────┘                                           │
├─────────────────────────────────────────────────────────┤
│  EXTENSION LAYER                                        │
│  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐     │
│  │   MCP   │  │ Skills  │  │  Apps   │  │  Search │     │
│  └─────────┘  └─────────┘  └─────────┘  └─────────┘     │
│  External tools, reusable expertise, ChatGPT            │
│  connectors, web search (cached + live)                 │
├─────────────────────────────────────────────────────────┤
│  SECURITY LAYER                                         │
│  ┌─────────────────────────────────────────────────┐    │
│  │    Sandbox (Seatbelt / Landlock / seccomp)      │    │
│  │    + Approval Policy (on-request → never)       │    │
│  └─────────────────────────────────────────────────┘    │
│  OS-level filesystem + network restrictions             │
├─────────────────────────────────────────────────────────┤
│  CORE LAYER                                             │
│  ┌─────────────────────────────────────────────────┐    │
│  │         GPT-5.x-Codex Intelligence              │    │
│  │   Tools: Shell, Patch, Read, Web Search         │    │
│  │   (legacy artifact, read_file, grep_files       │    │
│  │    removed in v0.117.0)                         │    │
│  └─────────────────────────────────────────────────┘    │
│  Shared model across all surfaces; costs tokens         │
└─────────────────────────────────────────────────────────┘

コア層：すべてを支えているのが GPT モデルファミリーです。2026年9月29日時点の現行世代は GPT-6 です。複雑なコーディングやエージェント型の作業には gpt-6.1-sol（v0.159.1以降、モデルが設定されていない場合にバンドル版 CLI で使用されるデフォルト）、最も難しいエンドツーエンドの作業には gpt-6-astra、対象を絞った大量のタスクには gpt-6-luna、さらに前世代の gpt-6-sol が用意されています。GPT-5.6モデル（Sol、Terra、Luna）も移行期間中は引き続き利用できます。gpt-5.5（Codex では400Kコンテキスト、API では1M）は、ChatGPT サインインを使用する Codex では2026年10月14日に提供終了となり、gpt-5.4 は2026年8月31日に Codex での提供を終了しました。^{83117146148149171178} この層はファイルを読み取り、パッチを書き込み、シェルコマンドを実行し、コードベースについて推論します。コンテキストがいっぱいになると、Codex は会話を圧縮して空き容量を確保します。この層ではトークンを消費します。

セキュリティ層：Codex が実行するすべてのコマンドは、OSレベルのサンドボックスを通過します。macOS では、Apple の Seatbelt フレームワークがカーネルレベルの制限を適用します。Linux では、Landlock + seccomp によってファイルシステムとシステムコールへのアクセスがフィルタリングされます。サンドボックスはコンテナ内ではなく、カーネルレベルで動作します。そのうえで、承認ポリシーが人間による確認を求めるタイミングを決定します。

拡張層：MCP は外部サービス（GitHub、Figma、Sentry）に接続します。skills は、Codex が必要に応じて読み込む再利用可能なワークフローをパッケージ化したものです。アプリは ChatGPT connectors に接続します。ウェブ検索では、インターネットからリアルタイムのコンテキストを追加できます。

サーフェス層：CLI は、ターミナルを使いこなすユーザーや自動化に適しています。デスクトップアプリは、複数スレッドでのプロジェクト管理に使用します。IDE 拡張機能は、編集・コンパイル・テストの反復に向いています。Cloud では、独立して実行される非同期タスクを扱えます。

重要なポイント：ほとんどのユーザーは、1つのサーフェスだけを使用します。パワーユーザーは5つすべてを使い分けます。長時間実行するタスクには Cloud、決定論的なリポジトリ操作には CLI、密なコーディングサイクルには IDE 拡張機能、計画と調整にはデスクトップアプリ、サインイン済みのブラウザ操作にはブラウザ拡張機能を使用します。

目次

1. Codex をインストールするには？
2. クイックスタート：最初のセッション
3. 主要な操作サーフェス
4. 設定システムの詳細
5. どのモデルを選ぶべきですか？
6. Codex の料金はいくらですか？
7. 意思決定のフレームワーク
8. サンドボックスと承認システムの仕組み
9. AGENTS.md の仕組み
10. Hooks
11. MCP（Model Context Protocol）とは？
12. Code Mode
13. JavaScript REPL ランタイム
14. Skills とは？
15. Plugins
16. Plan Mode とコラボレーション
17. メモリシステム
18. セッション管理
19. 非対話モード（codex exec）
20. Codex Cloud とバックグラウンドタスク
21. Codex Desktop App
22. GitHub Action と CI/CD
23. Codex SDK
24. パフォーマンス最適化
25. 問題をデバッグするには？ – codex doctor を含む
26. エンタープライズ導入
27. ベストプラクティスとアンチパターン
28. ワークフローレシピ
29. 移行ガイド
30. クイックリファレンスカード
31. 変更履歴
32. 参照資料

Codex のインストール方法

パッケージマネージャー

# npm (recommended)
npm install -g @openai/codex

# Homebrew (macOS)
brew install --cask codex

# winget (Windows)
winget install OpenAI.Codex

# Upgrade to latest
npm install -g @openai/codex@latest

Codex CLI の更新、ダウングレード、アンインストール方法

v0.128.0以降の Codex には自己更新コマンドが用意されています。それ以外の操作は、 インストール時に使用したパッケージマネージャーから行います。⁸⁶ v0.146.0以降、リリースアーティファクト、チャンネルメタデータ、インストーラーのエイリアスは、OpenAI がホストするリリースインフラストラクチャから配信され、GitHub がフォールバックとして使用されます。¹¹⁴ Codex のインストールと更新のためにネットワークで GitHub を許可リストへ登録している場合は、OpenAI のリリースホストも追加してください。フォールバックがあるため、許可リストから漏れていても明確なエラーにはならず、気づかないままフォールバックへ切り替わります。

# Check what you are running
codex --version                          # -> codex-cli 0.160.1
npm view @openai/codex version           # Latest published version

# Update
codex update                             # Built-in self-update (v0.128.0+)
npm install -g @openai/codex@latest      # Or update via npm
brew upgrade --cask codex                # Or via Homebrew

# Pin or downgrade to an exact version
npm install -g @openai/codex@0.144.6

# Uninstall
npm uninstall -g @openai/codex
brew uninstall --cask codex
winget uninstall OpenAI.Codex

リリースによって問題が発生した場合は、バージョンの固定が適切です。 Codex の安定版は更新頻度が高いため、 特定のバージョンをインストールするのが最も速いロールバック方法です。問題を報告し、バージョンを固定して、作業を続けましょう。 PATH 上に別のインストールが隠れていると、古いバイナリが気づかないまま使われ続けるため、 codex --version でロールバックを確認してください（codex doctor では、まさにこの問題が Environment に表示されます）。

パッケージをアンインストールしても、状態データは削除されません。 認証情報、設定、セッション履歴は ~/.codex/ に保存されています。再インストール後もログイン情報と履歴を引き継ぐには、そのまま残してください。 完全に初期状態へ戻したい場合に限って削除します。rm -rf ~/.codex を実行すると、config.toml、 auth.json、保存済みの全セッションも削除されます。

直接インストール用スクリプト（v0.106.0以降）

macOS と Linux では、1行のインストール用スクリプトが GitHub のリリースアセットとして提供されています。⁶⁰

curl -fsSL https://github.com/openai/codex/releases/latest/download/install.sh | sh

このスクリプトはプラットフォームとアーキテクチャを自動検出し、適切なバイナリをダウンロードして PATH 上に配置します。

バイナリのダウンロード

npm または Homebrew を利用できない環境では、GitHub Releases¹ からプラットフォーム別のバイナリをダウンロードしてください。

システム要件

• macOS：Apple Silicon または Intel（Seatbelt による完全なサンドボックス対応）
• Linux：x86_64 または arm64（Landlock + seccomp によるサンドボックス）
• Windows：制限付きトークンを使用するネイティブサンドボックス（v0.100.0で試験的機能から昇格）。WSL にも対応しています²

認証

codex login                  # Interactive OAuth (recommended)
codex login --device-auth    # OAuth device code flow (headless)
codex login --with-api-key   # API key from stdin
codex login status           # Check auth state (exit 0 = logged in)
codex logout                 # Clear stored credentials

認証方法は2つあります。

1. ChatGPT アカウント（推奨）：既存の Plus、Pro、Team、Business、Edu、または Enterprise サブスクリプションでサインインします。クラウドタスクを含むすべての機能を利用できます。
2. API キー：環境変数 CODEX_API_KEY または codex login --with-api-key で設定します。一部の機能（クラウドスレッド）は利用できない場合があります。

エキスパート向けのヒント：認証情報の保存先は、config.toml の cli_auth_credentials_store で設定できます。選択肢は file（デフォルト）、keyring（OS のキーチェーン）、auto（利用可能ならキーチェーン、利用できなければファイル）です。

Amazon Bedrock ログイン（v0.145.0、試験的機能）： Amazon Bedrock 経由でモデルへアクセスするチーム向けに、カスタムエンドポイントと認証をサポートする試験的なログイン方法が追加されています。既存の管理対象 API キー認証（v0.140.0以降）および AWS 認証情報チェーンと併用できます（「カスタムモデルプロバイダー」を参照）。Bedrock のデフォルトモデルは GPT-5.6 Sol です。¹¹² v0.150.0では、Amazon Bedrock モデルにおける会話のコンパクションとマルチエージェントの互換性が修正されています。¹³² v0.151.0では、対象となる TUI のサインインフローに、機能フラグで有効化する Amazon Bedrock オプションが追加されています。オンボーディング時に既存の AWS プロファイルと環境内の認証情報を検出し、プロファイル、アクセスキー、環境変数、Bedrock API キーの手動設定を選択できます。また、AWS Region の入力、入力中のシークレットのマスキング、プロバイダー変更時の組み込みサーバー再起動にも対応しています。¹³⁵ v0.152.0では、認証情報の更新状況が表示されます。モデルプロバイダーが期限切れの認証情報を更新している間、TUI と codex exec に進行状況が表示されます。Amazon Bedrock セッションの再認証も対象です。これは、スレッド、ターン、プロバイダー、ユーザー向けメッセージを含む、安定版の modelProvider/authRecoveryStarted および modelProvider/authRecoveryCompleted app-server 通知によって実現されています。¹³⁸

シェル補完

# Generate completions for your shell
codex completion bash > /etc/bash_completion.d/codex
codex completion zsh > ~/.zsh/completions/_codex
codex completion fish > ~/.config/fish/completions/codex.fish

インストールの確認

codex --version
# codex-cli 0.160.1

クイックスタート：最初のセッション

5分で、何もない状態から実際に作業できるところまで進めます。

1. インストールして認証する：

npm i -g @openai/codex          # Install
codex login                      # Log in with your OpenAI account

2. プロジェクトへ移動する：

cd ~/my-project                  # Any git repo works

3. Codex を起動する：

codex

対話型の TUI が表示されます。Codex はプロジェクト構造を自動的に読み取ります。

4. 質問する：

> What does this project do? Summarize the architecture.

Codex が主要なファイルを読み取り、コードベースについて説明します。このような質問によって変更が加えられることはありません。Codex がファイルへパッチを適用するのは変更を依頼した場合だけであり、事前の確認が必要になる条件はサンドボックスと承認ポリシーによって決まります。

5. 変更を加える：

> Add input validation to the login endpoint

Codex が編集内容を diff として提案します。確認して y で承認するか、n で拒否してください。

6. slash commands を使用する：

> /plan Refactor the database layer to use connection pooling

Codex は実行せずに計画を作成します。計画を確認し、承認すると実行が始まります。

7. 作業内容を確認する：

> /diff

現在のセッションで Codex が加えたすべての変更を確認できます。

次のステップ： - プロジェクトの指示を記述した AGENTS.md を設定する（AGENTS.md の仕組みを参照） - ワークフロー用のプロファイルを設定する（プロファイルを参照） - 非対話型の自動化に codex exec を試す（非対話モードを参照）

中核となる操作インターフェース

Codexには、同じインテリジェンスを基盤とする5つの異なるインターフェースがあります。それぞれが異なるワークフローパターンに最適化されています。

1. 対話型CLI（ターミナルUI）

codex                        # Launch TUI
codex "fix the failing tests" # Launch with initial prompt
codex -m gpt-6-sol          # Specify model
codex --sandbox workspace-write --ask-for-approval on-request

ターミナルUIは、次の要素を備えたフルスクリーンアプリです。

• コンポーザー：プロンプトの入力、@によるファイル添付、!プレフィックスによるシェルコマンドの実行
• 出力ペイン：モデルの応答、ツール呼び出し、コマンド出力をストリーミング表示
• ステータスバー：モデル、トークン使用量、gitブランチ、sandboxモードを表示

主なTUIショートカット：

ステータス行の変更（v0.121.0）： ステータス行にあった従来のコンテキストウィンドウメーターは、コンテキストウィンドウがどの程度埋まっているかを示すコンテキスト使用率インジケーターに置き換えられました。ステータス行を解析するスクリプトやhooksがある場合は、この形式変更をご確認ください。⁸² 新しいバージョンが利用可能になると、CodexはCLIの更新通知も表示します。

TUIで利用できるslash commands：

ワークフローピッカーの再設計（v0.129.0）： 再設計されたピッカーにより、再開とフォークへアクセスしやすくなりました。また、新しいrawスクロールバックモードでは、コマンドやモデル出力をそのままコピーしたいときに、レンダリングされていないトランスクリプトをスクロールできます。長時間のデバッグセッションをトリアージする場合や、出力を別のツールへパイプする場合に便利です。⁸⁹

統合された@メンションメニュー（v0.140.0）： コンポーザーで@を入力すると、デフォルトでファイル、plugins、skillsを横断する単一のメンションメニューが開くようになり、従来のファイル専用添付フローに置き換わりました。1回のキー操作で、あらゆるプロジェクトリソースを参照できます。¹⁰²

2. Codex Desktop App（macOS + Windows）

codex app                    # Launch desktop app (auto-installs if missing)

デスクトップアプリには、CLIにはない次の機能があります。

• マルチタスク：異なるプロジェクトで複数の並列エージェントを同時に実行
• Git worktreeによる分離：各スレッドがリポジトリの分離されたコピー上で作業
• インラインdiffレビュー：アプリを離れずに変更をステージ、元に戻す、コミット
• 統合ターミナル：コマンド実行用のスレッド別ターミナル
• 会話のフォーク：会話を分岐して別の選択肢を検討
• フローティングポップアウトウィンドウ：会話を持ち運べる独立ウィンドウに分離
• 自動化：定期タスク（issueのトリアージ、CI監視、アラート対応）をスケジュール
• Appshots：最前面のMacアプリウィンドウを、スクリーンショットと取得可能なテキスト付きでスレッドに添付
• アプリ内ブラウザーコメント：ローカルまたは公開ページをプレビューし、要素や領域にコメントを残して、Codexに具体的なビジュアルフィードバックを反映させる
• Computer Use：範囲を限定したGUI作業のため、許可されたMacアプリをCodexに操作させる機能。対象となるリモートMacのComputer Useターンでは、ロック状態での利用をオプトインできます

GPT-Liveを利用したChatGPT Voice（desktop 26.715、2026年7月23日）：デスクトップアプリを音声で操作できるようになりました。入力せずに作業内容を話し合い、Chat、Work、Codexにまたがるタスクを調整できます。macOSでは、Screen contextを有効にすると、最前面ウィンドウのappshotが会話へ共有されます。見ているものを言葉で説明する代わりに、その内容について直接質問できます。Plus、Pro、Business、Edu、Enterpriseで利用でき、デスクトップアプリのほか、iOSのRemoteからも使用できます。これはデスクトップインターフェースの音声機能です。CLIには、TUIでの/voiceライブ会話（v0.156.0以降はデフォルトで有効）とスペースバーによる音声入力（v0.105.0で試験的に追加）という、独立した音声機能があります。¹¹³¹⁶⁹

共有スレッドスナップショット（2026年8月20日）：すべてのCodexプランで、macOSデスクトップアプリからローカルCodexスレッドの読み取り専用スナップショットを共有できます。元のスレッドが変更されても、スナップショットは更新されません。個人アカウントのリンクはリンクを知る全員が開けますが、ワークスペースアカウントのリンクは共有元ワークスペースのメンバーだけが開けます。Codexは共有前に既知のシークレットパターンを墨消ししますが、機密情報が残る可能性があるため、OpenAIは共有内容を確認するよう案内しています。リンクの表示や取り消しは、ChatGPTのデータコントロールにあるShared linksから行えます。¹²⁸

アプリとCLIの使い分け：複数の作業フローを調整する場合や、視覚的なdiffレビューが必要な場合はデスクトップアプリを使用します。ターミナルでの組み合わせやスクリプト処理、CI/CDとの統合を重視する場合はCLIが適しています。

3. IDE拡張機能（VS Code、Cursor、Windsurf）

Codex IDE拡張機能は、エディターへ直接統合されます。

• デフォルトでエージェントモード：ファイルの読み取り、編集、コマンド実行
• インライン編集：アクティブなファイル内で、コンテキストを考慮した提案を表示
• 共有セッション：CLIとIDE拡張機能の間でセッションを同期
• 同じ認証方式：ChatGPTアカウントまたはAPIキーでサインイン

VS Code MarketplaceまたはCursor/Windsurfの拡張機能ストアからインストールできます。³

4. Codex Cloud [EXPERIMENTAL]

クラウドタスクは、OpenAIが管理する環境で非同期に実行されます。

• 投入後は自動実行：ローカルマシンとは独立して実行されるタスクをキューに追加
• 並列実行：複数のクラウドタスクを同時に実行
• PRの作成：Codexが完了した作業からpull requestを作成
• ローカルへの適用：codex apply <TASK_ID>でクラウドの結果をローカルリポジトリに取り込む

codex cloud list             # List recent cloud tasks
codex apply <TASK_ID>        # Apply diff from a specific cloud task

クラウドタスクにはchatgpt.com/codexからもアクセスできます。⁴

5. ブラウザー拡張機能（Chrome、Edge、Brave、Opera、Vivaldi）

CodexはGoogle Chrome、Microsoft Edge、Brave、Opera、Vivaldi向けのブラウザー拡張機能としても提供され、CLI、デスクトップアプリ、IDE拡張機能、クラウドに並ぶ5番目のインターフェースとなっています。この拡張機能は2026年5月にChrome向けとして登場し、2026年8月25日の変更履歴で残りの4ブラウザーが追加されました。ChatGPTデスクトップアプリのSettings > Computer Useからセットアップできます。5つのブラウザーすべてがタブへのメンションとブラウザー操作に対応しています。Operaはサイドチャットに対応していないため、タスクはデスクトップアプリから開始してください。この拡張機能は、通常のブラウジングを乗っ取るのではなく、その傍らで動作するよう設計されています。Codexはバックグラウンドで複数のタブをまたいで並行作業し、どのサイトにアクセスさせるかは常にユーザーが管理できます。⁹⁰¹²⁷

• タブの並列操作：Codexはフォアグラウンドのタブをロックせず、複数のタブを同時に操作します。
• サイト単位の制御：Codexによる操作を許可するWebサイトを許可リストで指定します。デフォルトではアクセスできません。
• 作業台としてのブラウザー：この拡張機能は、管理コンソール、社内ダッシュボード、コンテンツ管理UI、チケットシステムなど、ページ自体が信頼できる情報源となるアプリやWebサイト上の作業に最適です。ローカルリポジトリにおけるCLIの代替ではありません。
• 同じ頭脳：ブラウザー拡張機能では、ほかのインターフェースと同じGPT-5.x-Codexインテリジェンスが動作します。そのため、CLIで機能するAGENTS.mdやskillsの設定は、ブラウザーを操作する作業にも同じ規約として引き継がれます。

ブラウザー拡張機能のドキュメントからインストールできます。このページは以前、Codex for Chromeという名称でした。¹²⁷

設定システムの詳細

Codex の設定には TOML を使用します。設定が競合した際にどれが優先されるかを決めるため、優先順位を理解することが重要です。

優先順位（高い順）

1. セッションオーバーライド（最優先）：CLI フラグ（--model、--sandbox、--ask-for-approval、--search、--enable/--disable、--profile）および -c key=value オーバーライド
2. プロジェクト設定（.codex/config.toml。CWD からプロジェクトルートへ上方向に探索し、最も近いディレクトリの設定を優先）
3. ユーザー設定（$CODEX_HOME/config.toml。デフォルトは ~/.codex/config.toml）
4. システム設定（Unix では /etc/codex/config.toml）
5. 組み込みのデフォルト値（最低優先）

requirements.toml は、通常の設定をマージした後にユーザーが選択できる値を制限するポリシー制約レイヤーとして機能します。エンタープライズデプロイをご覧ください。

設定ファイルの場所

上級者向けのヒント：CODEX_HOME 環境変数を指定すると、デフォルトの ~/.codex ディレクトリを変更できます。CI/CD や複数アカウントの構成に便利です。

デスクトップの複数フォルダプロジェクト（26.715、2026年7月23日）：ChatGPT デスクトップアプリのローカルプロジェクトでは、関連する複数のフォルダを扱えるようになりました。そのうち1つをプライマリフォルダに指定します（プロジェクトメニュー → プロジェクトを編集）。config.toml の自動検出はプライマリフォルダだけを対象に実行されます。セカンダリフォルダでもファイルの検索、読み取り、編集はできますが、設定には影響しません。セカンダリフォルダ内の .codex/config.toml は Codex が読み取れるファイルにすぎず、設定としては読み込まれません。これはデスクトップアプリにおけるプロジェクトのスコープに関する仕様であり、前述の優先順位が変更されたわけではありません。CLI では、引き続き現在の作業ディレクトリから上方向に探索してプロジェクト設定を解決します。¹¹³

設定項目の完全なリファレンス

# ~/.codex/config.toml — annotated reference

# ─── Model Selection ───────────────────────────────────
model = "gpt-6.1-sol"                  # Docs' example; unset = bundled default (gpt-6.1-sol since v0.159.1)
model_provider = "openai"               # Provider (openai, oss, or custom provider id)
model_context_window = 272000           # Token count available to active model (override)
model_auto_compact_token_limit = 200000 # Threshold triggering automatic history compaction
model_reasoning_effort = "medium"       # minimal|low|medium|high|xhigh (model-dependent)
model_reasoning_summary = "auto"        # auto|concise|detailed|none
model_verbosity = "medium"              # low|medium|high
personality = "pragmatic"               # none|friendly|pragmatic
review_model = "gpt-6-sol"             # Optional model for /review command
service_tier = "fast"                  # Preferred service tier for new turns
oss_provider = "lmstudio"              # lmstudio|ollama (used with --oss)

# ─── Sandbox & Approval ───────────────────────────────
sandbox_mode = "workspace-write"        # read-only|workspace-write|danger-full-access
approval_policy = "on-request"          # on-request|never (untrusted retired in v0.149.0)

[sandbox_workspace_write]
writable_roots = []                     # Additional writable paths
network_access = false                  # Allow outbound network
exclude_tmpdir_env_var = false          # Exclude $TMPDIR from sandbox
exclude_slash_tmp = false               # Exclude /tmp from sandbox

# ─── Web Search ────────────────────────────────────────
web_search = "live"                     # Web search mode (constrained by allowed modes)

# ─── Tools ─────────────────────────────────────────────
tools.update_plan.enabled = false       # Planning tool opt-in (v0.152.0); exposes update_plan when true

# ─── Instructions ──────────────────────────────────────
developer_instructions = ""             # Additional injected instructions
model_instructions_file = ""            # Custom instructions file path
compact_prompt = ""                     # Custom history compaction prompt

# ─── Shell Environment ─────────────────────────────────
allow_login_shell = false               # Allow login shell semantics (loads .profile/.zprofile)

[shell_environment_policy]
inherit = "all"                         # all|core|none
ignore_default_excludes = false         # Set true to keep KEY/SECRET/TOKEN vars
exclude = []                            # Glob patterns to exclude
set = {}                                # Explicit overrides
include_only = []                       # Whitelist patterns

# ─── Authentication ────────────────────────────────────
cli_auth_credentials_store = "file"     # file|keyring|auto
forced_login_method = "chatgpt"         # chatgpt|api
mcp_oauth_callback_port = 0            # Fixed port for MCP OAuth callback (0 = random)
mcp_oauth_credentials_store = "auto"   # auto|file|keyring

# ─── History & Storage ─────────────────────────────────
[history]
persistence = "save-all"                # save-all|none
max_bytes = 0                           # Cap size (0 = unlimited)

tool_output_token_limit = 10000         # Max tokens per tool output (global; per-tool MCP overrides in v0.152.0)
log_dir = ""                            # Custom log directory
sqlite_home = ""                        # Override SQLite-backed resumable state location

# ─── UI & Display ──────────────────────────────────────
file_opener = "vscode"                  # vscode|vscode-insiders|windsurf|cursor|none
hide_agent_reasoning = false
show_raw_agent_reasoning = false
check_for_update_on_startup = true

[tui]
notifications = false                   # Enable notifications
notification_method = "auto"            # auto|osc9|bel
animations = true
show_tooltips = true
alternate_screen = "auto"               # auto|always|never
status_line = ["model", "context-remaining", "git-branch"]

# ─── Project Trust ─────────────────────────────────────
project_doc_max_bytes = 32768           # Max AGENTS.md size (32 KiB)
project_doc_fallback_filenames = []     # Alternative instruction filenames
project_root_markers = [".git"]         # Project root detection

# ─── Feature Flags ─────────────────────────────────────
# Use `codex features list` for current names/stages/defaults.
[features]
shell_tool = true                       # Shell command execution (stable)
unified_exec = true                     # PTY-backed exec (stable)
shell_snapshot = true                   # Shell env snapshots (stable)
enable_request_compression = true       # zstd request compression where supported (stable)
fast_mode = true                        # Service-tier selection and Fast-tier commands (stable)
goals = true                            # Goal mode; stable and on by default in v0.133.0+
hooks = true                            # Lifecycle hooks (stable)
multi_agent = true                      # Enable multi-agent collaboration tools (stable)
personality = true                      # Personality selection (stable)
plugins = true                          # Plugin system (stable)
plugin_hooks = true                     # Plugin-bundled hooks (stable)
plugin_sharing = true                   # Workspace plugin sharing (stable)
browser_use = true                      # In-app browser automation (stable)
browser_use_external = true             # Browser-extension browser use (stable)
computer_use = true                     # macOS Computer Use (stable, plan/region gated)
in_app_browser = true                   # Shared rendered-page preview (stable)
image_generation = true                 # Image-generation tool (stable)
guardian_approval = true                # Auto-review approval path (stable)
skill_mcp_dependency_install = true     # Prompt/install missing skill MCP deps (stable)
tool_suggest = true                     # Tool/plugin suggestion surface (stable)
workspace_dependencies = true           # Workspace dependency discovery (stable)
memories = true                         # Memories (experimental)
network_proxy = false                   # Sandboxed-command network proxy (experimental); boolean or table, see below
prevent_idle_sleep = true               # Keep machine awake during active turns (experimental)
terminal_resize_reflow = true           # Terminal reflow improvements (experimental)
guardian_conversation_history_tools = false  # Guardian reads earlier user messages (under development, v0.160.0)

# Removed or deprecated feature names still appear in `codex features list`
# for migration diagnostics. Do not set removed flags such as
# `collaboration_modes`, `request_rule`, `codex_git_commit`,
# `apply_patch_freeform`, `search_tool`, or `js_repl` in new configs.

# ─── Guardian Auto-Review (v0.160.0 history keys) ─────
[auto_review]
conversation_history_max_output_tokens = 4000   # Per history-tool response, estimated tokens (default 4,000)
experimental_conversation_history_prompt = ""   # Blank = built-in retrieval instructions

# ─── Multi-Agent Roles (v0.102.0+) ───────────────────
[agents]
max_threads = 4                         # Maximum concurrent agent threads

[agents.explorer]
description = "Read-only codebase navigator"
config_file = "~/.codex/profiles/explorer.toml"

# ─── Notifications ────────────────────────────────────
notify = ["terminal-notifier", "-title", "Codex"]  # Command for notifications

# ─── Per-Project Overrides ────────────────────────────
[projects."/absolute/path/to/repo"]
trust_level = "trusted"                 # Per-project trust override

features.network_proxy は boolean | table です。 boolean 形式ではプロキシの起動または停止だけを指定し、table 形式ではポリシーも設定できます。このプロキシは、サンドボックス化されたコマンドに対して権限プロファイルのドメインルールを適用します。無効にすると、[permissions.<name>.network] のドメインルールは適用されず、コマンドはネットワークへ直接アクセスします。Web 検索、アプリ、MCP servers、その他のホスト型ツールはフィルタリングしません。¹³⁰

[features.network_proxy]
enabled = true
allow_local_binding = false
proxy_url = "http://127.0.0.1:3128"

[features.network_proxy.domains]
"api.github.com" = "allow"
"*.npmjs.org" = "allow"          # subdomains only
"**.example.com" = "deny"        # apex plus subdomains; deny wins on conflicts

管理者が管理する requirements.toml の experimental_network 要件では、features.network_proxy を使用せずにプロキシを起動できます。¹³⁰

プロファイル

作業モードごとに名前を付けた設定プリセットです。Codex 0.134.0 以降、各プロファイルは個別のファイル（~/.codex/<name>.config.toml）となり、トップレベルのキーだけを格納します。--profile <name> を指定すると、そのファイルが ~/.codex/config.toml に重ねて適用されます。従来の config.toml 内の [profiles.<name>] テーブルと、トップレベルの profile = "<name>" セレクターは読み込まれなくなりました。[profiles.<name>] テーブルが残っている場合、そのキーをプロファイルファイルへ移すまで、--profile <name> を指定しても起動できません。¹²²

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
personality = "pragmatic"

# ~/.codex/careful.config.toml
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0
sandbox_mode = "read-only"

# ~/.codex/auto.config.toml
model = "gpt-6.1-sol"
# GPT-6.1 Sol starts at Standard speed; /fast toggles Fast (2.5x credits)
model_reasoning_effort = "medium"
approval_policy = "never"
sandbox_mode = "workspace-write"

プロファイルファイルは、基本のユーザー設定より上、プロジェクト設定および CLI 設定より下のレイヤーです。そのため、基本設定と異なる値だけを記述すれば十分です。¹²²

プロファイルを有効にします。

codex --profile fast "quick refactor"
codex --profile careful "security audit"
codex -p auto "fix CI"

上級者向けのヒント：設定のトップレベルに profile = "fast" を指定すると、デフォルトのプロファイルを設定できます。セッションごとに変更するには --profile を使用します。

カスタムモデルプロバイダー

Azure、AWS Bedrock、ローカルモデル、またはプロキシサービスに接続します。

[model_providers.azure]
name = "Azure OpenAI"
base_url = "https://YOUR_PROJECT.openai.azure.com/openai"
wire_api = "responses"
query_params = { api-version = "2025-04-01-preview" }
env_key = "AZURE_OPENAI_API_KEY"

# Built-in amazon-bedrock provider (v0.123.0+, first-class in v0.124.0+)
# AWS SigV4 signing + credential-based auth; AWS profile selectable via the
# nested `aws.profile` field (NOT a top-level `aws_profile` key).
# v0.130.0+ also accepts credentials from `aws login` (the AWS console-login
# flow) — Codex resolves the cached console-login session for the chosen
# profile if static keys are absent.
# v0.140.0+ adds managed Amazon Bedrock API-key authentication, and stores
# CLI and MCP OAuth credentials in encrypted local storage.[^184]
[model_providers.amazon-bedrock]
name = "Amazon Bedrock"

[model_providers.amazon-bedrock.aws]
profile = "default"                   # any profile from ~/.aws/credentials
# Region/credential resolution otherwise follows the standard AWS chain;
# v0.130.0 added support for `aws login` console-login profiles in addition
# to static access keys and IAM role assumption.[^168]

[model_providers.ollama]
name = "Ollama (Local)"
base_url = "http://localhost:11434/v1"
wire_api = "chat"

env_key には、プロバイダーの API キーを格納する環境変数の名前を指定します。キー自体を config.toml に記述することはありません。requires_openai_auth = true を設定したプロバイダーでは、初回実行時にログイン画面が表示されます。認証情報は、必ずしも auth.json ではなく、cli_auth_credentials_store で選択したバックエンド（file、keyring、または auto）に保存されます。v0.160.0 以降、model_catalog_url を設定したプロバイダーでは、そのカタログ内のモデルだけが使用され、組み込みモデルは統合されません。また、カタログの更新に失敗した場合は、古いキャッシュを再利用せず、キャッシュ内のエントリを破棄します。¹⁸²

警告： chat/completions ワイヤー API（wire_api = "chat"）は OpenAI がホストするモデルでは非推奨となり、OpenAI は2026年2月に廃止を発表しました。³⁴ ローカルプロバイダー（Ollama、LM Studio）では、引き続きこの形式を利用できる場合があります。OpenAI エンドポイントでは、代わりに wire_api = "responses" を使用してください。

--oss フラグでローカルモデルを使用します。

codex --oss "explain this function"               # Uses default OSS provider
codex --oss --local-provider lmstudio "explain"   # Explicit LM Studio
codex --oss --local-provider ollama "explain"      # Explicit Ollama

または、設定ファイルで指定します。

model_provider = "oss"
oss_provider = "lmstudio"   # or "ollama"

インライン設定のオーバーライド

コマンドラインから任意の設定値をオーバーライドします。

codex -c model="gpt-5.5" "refactor the API"
codex -c 'sandbox_workspace_write.network_access=true' "install dependencies"
codex -c model_reasoning_effort="xhigh" "debug the race condition"

どのモデルを選ぶべきですか？

利用可能なモデル（2026年9月）

GPT-5.5（2026年4月23日）は、リリース時点でほとんどのCodexタスクにOpenAIが推奨していたモデルです。複雑なコーディング、コンピューター操作、知識労働、調査ワークフローに適しています。ChatGPT Plus / Pro / Business / Enterprise / Edu / Go向けには4月23日にCodex CLI / web / デスクトップで、OpenAI APIでは4月24日に提供されました。コンテキストウィンドウはCodexで400K、APIでは1Mです。Codexでは、各サブスクライバーティアのスループットとコストのバランスを取るため、ウィンドウが400Kに制限されます。APIでは完全な1Mを利用できます。料金（API）は、MTokあたり入力$5 / 出力$30です（GPT-5.4の2倍。OpenAIによると、トークン効率の改善後の実質的な増加は約20%）。ベンチマークは、Terminal-Bench 2.0で82.7%（一般公開モデルの中で当時のSOTA）、GDPval（44職種）で84.9%、OSWorld-Verifiedで78.7%、Tau2-bench Telecom（プロンプト調整なし）で98.0%です。OpenAIはリリース前、GPT-5.5とCodexを社内で使用してサービング基盤を書き直し、トークン生成速度を20%向上させました。⁸³

GPT-5.5は、ChatGPTサインインを使用するCodexでは2026年10月14日に提供終了予定です――モデルのドキュメントでは、提供終了の対象を全プラン（コンシューマー、Business、Enterprise、Eduを含む）のChatGPT、ChatGPT Work、Codexとし、OpenAI APIには適用されないと明記しています。¹⁵⁵ GPT-6のリリースに伴い、代替モデルの案内も変更されました。Plus、Pro、Business、Enterprise、Eduではgpt-6-solを、FreeとGoではデスクトップアプリのgpt-6-lunaを、それぞれ「利用可能になり次第」選択してください。ワークスペースのデフォルト、保存済みのモデル設定、管理対象の設定、カスタムエージェント、スケジュール済みタスク、スクリプトに含まれるgpt-5.5を置き換えてください。¹⁷¹

GPT-5.4とGPT-5.4 miniは、ChatGPTサインインを使用するCodexでは2026年8月31日に提供終了しました。¹¹⁷ モデルのドキュメントでは、現在の代替モデルとしてgpt-6-solとgpt-6-lunaが案内されています（EnterpriseとEduでは、最初に管理者がLunaを有効にする必要があります）。APIキーによる利用は影響を受けません。⁶⁴¹⁷¹ 正確なモデル一覧はアカウントや展開状況によって異なります。ローカルキャッシュ~/.codex/models_cache.jsonを確認してください。

非推奨化に関する注意（2026年3月11日）：GPT-5.1モデルはChatGPTで利用できなくなりました。既存の会話はGPT-5.3 Instant、GPT-5.4 Thinking、またはGPT-5.4 Proで自動的に継続されます。GPT-5.1-Codex-Miniは、2026年7月23日に停止されるまでAPIおよびCLI経由で引き続き利用できました。⁷¹⁸⁸

無料ティアに関する注意（2026年5月5日）：GPT-5.5 Instantは、2026年5月5日にChatGPTの無料ティアへ展開されました。これによりGPT-5.5ファミリーの利用者は有料プラン以外にも広がりましたが、Codex CLIを利用するには、引き続き対象となるPlus / Pro / Business / Enterprise / Edu / GoサブスクリプションまたはAPIキーが必要です。⁹²

GPT-5.4 mini（2026年3月17日）：GPT-5.4を小型化、高速化したバリアントで、400Kのコンテキストを備え、料金はMTokあたり$0.75/$4.50です。GPT-5.4のクォータの30%しか消費しません。サブエージェントへの委任に最適です。GPT-5.4に計画と調整を任せ、GPT-5.4 miniのサブエージェントには、コードベースの検索、ファイルのレビュー、ドキュメント処理など、対象を絞ったサブタスクを並行して処理させます。⁷⁶

Bedrock GPT-5.6（Sol、Terra、Luna）（v0.143.0、2026年7月8日）：Codexでは、Amazon Bedrockでホストされる3つのGPT-5.6モデルバリアントが正式にサポートされ、max推論レベルにも対応しました。Bedrockプロバイダー経由でモデルを利用するチームは、ほかのカスタムプロバイダーモデルと同じ方法で選択できます（カスタムモデルプロバイダーを参照）。maxレベルは、最も難しい推論やエージェント型のワークロードを対象としています。¹⁰⁶ v0.144.6（2026年7月18日）では、Sol、Terra、Lunaの同梱指示が更新され、コンテキストウィンドウが272,000トークンに修正されました。¹¹¹ v0.145.0（2026年7月21日）では、カスタムエンドポイントと認証に対応する実験的なBedrockログインが追加され、GPT-5.6 SolがBedrockのデフォルトモデルになりました。また、同梱のGPT-5.4モデルの選択は、対応するTerraおよびLunaバリアントへ移行されます。¹¹²

GPT-6-Astra（2026年9月3日リリース。v0.153.1～v0.153.4でCodexに追加）：明確な日付を含む経緯は次のとおりです。2026年9月3日、v0.153.1でAPI専用のカタログエントリが準備され、同日にOpenAIがGPT-6-Astraを発表しました。9月4日にはv0.153.4で選択画面への項目追加と、同梱CLIのデフォルト切り替えが行われました。発表では、限定された組織（最初はサイバーセキュリティプログラムのパートナー）から開始し、ChatGPT Plus、Pro、Business、Enterpriseへ「今後数日間」で拡大する段階的な展開に加え、OpenAI APIとAWSでの提供も説明されています。これらの展開情報は報道（CNBC、Axios、Forbes、Al Jazeera、9to5Mac）に基づきます。¹⁴⁵ 9月4日時点の情報はその後更新されました。OpenAIはXで、GPT-6 Astraが「ChatGPT WorkおよびCodexのすべてのPro、Enterprise、Business Premiumユーザーに利用可能になった」ほか、「APIでも提供を開始した」と発表し、PlusとBusinessにも数日以内に提供する見込みを示しました。同日の夜、Codex責任者のTibo Sottiauxも「AstraはすべてのPlusおよびBusinessユーザーにも展開されました」と補足しています。実際の利用権限には依然としてばらつきがあります。9月5日のコミュニティ報告では、PlusアカウントでCodexにGPT-5.6モデルしか表示されない例がありました。また、以下で引用するモデルのドキュメントの利用可否に関する記述も変わっていないため、引き続き第一者による有効な声明として扱います。¹⁴⁹ 第一者のドキュメントはすでに公開されています。APIのモデルページでは、gpt-6-astraを「最も困難なエンドツーエンド作業向けに構築された、最も高性能なモデル」というフラッグシップとして掲載しています。仕様は、標準の短いコンテキスト料金で入力$10/MTok、出力$50/MTok、コンテキストウィンドウ1.05Mトークン、最大入力922,000トークン、最大出力128K、知識カットオフは2026年4月30日です。長いコンテキスト向けのティアも明記されており、入力トークンが272Kを超えるプロンプトには、リクエスト全体に入力2倍、出力1.5倍の料金が適用されます。料金ページでは入力$20/MTok、出力$75/MTokで、GPT-5.6 Terra（バランス重視）やLuna（低予算）を上回ります。CodexのドキュメントではAstraを推奨Codexモデルとしつつ、利用可否は「展開状況、サインイン方法、クライアントによって異なる」と説明し、対象としてPro、Business（$100）、Enterpriseアカウントを挙げています。Astraでドキュメント化されているCodexの推論レベルは、Low、Medium、High、Extra High、Max、Ultraです。モデルのドキュメントではMediumがデフォルトですが、v0.153.4の同梱カタログではdefault_reasoning_levelがlowに設定されています。そのため、実際のデフォルトは利用環境によって異なるものとして扱い、セッション内で/statusを確認してください。9月15日に再確認した時点でも推論レベルは変わらず、各レベルの説明が選択画面に追加されています（Ultraの原文は「Maximum reasoning with automatic task delegation」）。MaxとUltraにはSDKでの確認が伴います。Python SDK 0.154.0（2026年9月10日リリース）では、maxとultraの推論レベルが追加されました（#39662）。^146148153 CLIでは、Astraはv0.153.1以降、APIを使用して設定でき（-m gpt-6-astra）、v0.153.3でAmazon Bedrockのカタログに追加されました（v0.157.0でGPT-6 Solに変更されるまで、BedrockのデフォルトはGPT-5.6 Solのままでした¹⁷⁴）。v0.153.4以降はモデルの選択画面に表示され、モデルが明示的に設定されていない場合の同梱デフォルトになっています。CLIの最低バージョンは文書化されていないため、これらを実質的な最低バージョンとして扱ってください。このデフォルト変更は、同梱CLIカタログに関するもので、すべての利用環境に適用されるわけではありません。ただし、cloudとの差はその後解消されました。9月4日と9月7日の確認では、AstraはCodex cloudで利用不可とされていました（GPT-5.6 Solは利用可能）が、9月15日の再確認では利用可否の表でAstraもCodex cloudで利用可能とされています。ただし、ページには引き続き「現在、Codex cloudチャットのデフォルトモデルは変更できません」と記載されています。展開上の注意として、利用権限はアカウントによって異なります。CLI 0.153.4以降では、展開対象外のアカウントにも、まだ実行できないモデルが同梱デフォルトとして設定されています。確実にモデルを選択するにはconfig.tomlで固定するか、-mを渡してください。v0.156.1以降、ドキュメントの例でもmodel = "gpt-6-sol"が使用されています。モデルページにはFastティアの記載がありませんが、AstraのFastモード料金は文書化されています。Codexの速度に関するドキュメントでは、ChatGPTサインイン時に「利用可能な場合」、Standardの2.5倍のクレジットを消費するとされています。APIの料金ページでは、Fastモードの料金が該当するStandard料金のちょうど2倍で、短いコンテキストではMTokあたり$20/$100、長いコンテキストでは$40/$150です。v0.153.2のカタログ文字列にある「2倍速」という部分は、引き続きカタログ上の表示テキストにすぎません。速度に関するページでは、Astraの速度倍率は明記されていません。^145146147148 一部更新、2026年9月23日：モデルのドキュメントでは、Astraを推奨Codexモデルとは説明しなくなりました。「Recommended models」セクションではGPT-6 SolとLunaが先に挙げられ、Astraは「最も困難なエンドツーエンド作業」向けとされています。また、AstraはCodex cloudで利用不可とされ、開始時の推論レベルはLight（low）となり、同梱カタログと一致しました。モデルが設定されていない場合、Astraは引き続き同梱CLIのデフォルトです。¹⁷¹ 2026年9月29日に更新：v0.159.1ではGPT-6.1 Solが同梱デフォルトになり、Astraは選択画面の2番目に移動しました。モデルのドキュメントでは、複雑なコーディングにはGPT-6.1 Solを推奨しつつ、Astraは最も困難なエンドツーエンド作業向けとして維持されています。ドキュメントの設定例もgpt-6.1-solを使用するようになりました。¹⁷⁸

AstraでのPowerプリセット（2026年9月6日以前にドキュメントへ追加）：Codexのモデルに関するドキュメントでは、モデル選択画面のPowerオプションがGPT-6-Astraの推論レベルに対応付けられています。これは、PowerプリセットとAstraの対応を初めて示したドキュメントです。この段落は¹⁴⁶の9月5日の再確認時にはなく、9月7日に公開を確認しました。原文は次のとおりです。「For eligible Pro, Business ($100), and Enterprise accounts, the Astra rollout updates the Power options to Terra Light, Sol Light, Sol Medium, Astra Light, Astra Medium, and Astra Extra High. Options can differ by plan and rollout stage.」直前の文では、選択画面の図にGPT-5.6のコントロールが引き続き表示されていることも説明されています。上記のモデル表と併せて読むと、「Power」はGPT-5.6 Solのmedium推論を意味していましたが、利用権限のあるアカウントでは、同じプリセットの段階にTerra、Sol、Astraが固定された推論レベルで含まれるようになりました。選択肢は引き続きプランと展開段階によって異なります。この段落の原文は、2026年9月15日の再確認時にも変更されていません。¹⁴⁶ 2026年9月23日に更新：GPT-6 SolとLunaのリリース後、ドキュメントでは6つのPowerプリセットを「Luna High、Sol Light（開始時のプリセット）、Sol Medium、Astra Light、Astra Medium、Astra Extra High」と記載しています。一部の有料プランではAstra Extra Highが利用できないことも説明され、SolはMedium、LunaはHigh、AstraはLight（low）から始めることが推奨されています。¹⁷¹

コンテキストをまたぐ実験的なメモ機能（Astra、ドキュメント公開済み、オプトイン）：Codexのモデルに関するドキュメントには、「Experimental context management」というセクションがあります。原文は次のとおりです。「On supported Codex clients, users signed in with ChatGPT Plus or Pro can opt in to experimental context management. Astra keeps notes across context windows and can search earlier messages and tool results from the same task. This experiment is off by default and isn’t available with Business, Enterprise, or API-key sign-in at launch.」オプトイン方法の原文は次のとおりです。「To opt in, set features.context_management.experimental_mode = true in your config.toml, then start a new task.」これはv0.153.0で追加されたfeatures.context_management.experimental_modeと同じ設定項目です（コンテキスト管理を参照）。ドキュメントでは、この機能をAstraの名前、およびPlusとProによるサインインに明示的に関連付けています。一方、v0.153.0のリリースノートでは、対象としてPlus、Pro、Pro Liteのセッションが挙げられていました。v0.154.0ではコード側の制約が厳格化され、セッション開始時に、使用中のモデルの機能に基づいて実験の利用資格が判定されるようになりました（#43147）。ドキュメントのセクションは、2026年9月15日の再確認時にも原文のまま変更されていません。実験的な機能であり、デフォルトではオフです。動作や利用条件は今後変更される可能性があります。^140146152 v0.157.0：同梱モデルカタログでは、GPT-6-Astraを含むすべての同梱モデルから、実験的なコンテキスト管理への対応を示す指定が削除されました（#47397）。CLIでは、その対応が指定されたモデルに対してのみ実験を有効にします。したがって、同梱カタログを使用する場合、オプトインしても効果はありません。サインイン済みアカウントに提供されるカタログが異なるかどうかは、文書化されていません。モデルのドキュメントでは、2026年9月26日時点でもオプトインについて説明していました。¹⁷⁴ 2026年9月29日：モデルページからこのセクションが削除され、設定リファレンスではfeatures.context_management.experimental_modeについて「Experimental context-management setting. The feature is not currently available」と説明されています。GPT-6.1 Solにも、この機能への対応は指定されていません。¹⁷⁸

モデル選択フローチャート

Is this a quick fix, extraction, or other well-defined repeatable task?
├─ Yes → gpt-6-luna (most efficient; docs suggest starting at High)
└─ No
   ├─ Do you need real-time pairing speed?
   │  ├─ Yes → gpt-5.3-codex-spark (near-instant, Pro only)
   │  └─ No
   │     ├─ Hardest end-to-end work across many steps and tools?
   │     │  ├─ Yes → gpt-6-astra (strongest; most expensive)
   │     │  └─ No → gpt-6.1-sol (near-Astra at lower cost; default since v0.159.1)
   └─ GPT-6.1 Sol not yet available on your account? → gpt-6-sol, then gpt-5.6-sol

推論レベル

応答前にモデルがどの程度「考える」かを制御します。

対応するレベルはモデルによって異なります。minimalを利用できるのはGPT-5モデルのみです。すべてのモデルが全レベルに対応しているわけではありません。

persistentの詳細（v0.151.0）：persistentレベルで実行されるターンでは、現在時刻のリマインダーと中断可能なclock.sleepツールがデフォルトでオンになります（明示的なfeatures.current_time_reminderの設定と管理対象の要件は維持されます）。また、モデルのメタデータでpersistent_instructionsを通じて上書きまたは無効化できる、能動性とフォローアップに関する同梱ガイダンスも提供されます。¹³⁵

codex -c model_reasoning_effort="xhigh" "find the race condition"

上級者向けのヒント：同じプロンプトでも、xhigh推論はmediumの3～5倍のトークンを使用することがあります。追加の思考に見合う、本当に難しい問題にのみ使用してください。

TUIで推論レベルをすばやく操作（v0.124.0以降）。⁸⁵ 対話型のTUIセッションでは、Alt+,で推論レベルを1段階下げ、Alt+.で1段階上げられます。セッション途中で難しい問題に直面した際、/effortや-cを使わず、一時的にmedium → high → xhighと引き上げる場合に便利です。セッション途中でモデルのアップグレードを受け入れると、以前のレベルは引き継がれず、新しいモデルのデフォルトへ推論レベルがリセットされます。

モデルの切り替え

セッション途中では/model slash commandでモデルを切り替えられます。また、実行ごとに--model / -mを指定することもできます。

codex -m gpt-5.3-codex-spark "pair with me on this component"

Codex の料金は？

機能についてはモデルの選択、タスクごとに適切なモデルを選ぶ方法については意思決定フレームワークもご覧ください。

ChatGPT プラン経由のアクセス

Codex を利用できるかどうかは、ChatGPT のプランと組織の設定によって異なります。⁵¹

2026年4月の料金改定： Business の年払い料金は、1シートあたり月額$25から$20に引き下げられました。Business と Enterprise のワークスペースでは、従量課金の Codex 専用シートも利用できるようになりました。固定シート料金はなく、トークン消費量に基づいて課金されます。⁷⁹ 現在、料金ページでは、2026年2月の Desktop App リリース時に提示されていたプロモーションの2x倍率ではなく、モデル別の範囲として上限を掲載しています（上表を参照）。¹⁶¹⁶²

2026年5月の利用上限引き上げ（2026年5月31日に終了）： Plus プランの Codex では、5時間枠の上限が25倍（通常の引き上げ幅は20倍）となり、同じ期間中は月額$100のティアも2倍になりました。⁸⁹

TUI のレート制限 UX（v0.152.0〜v0.153.0）： 上限に達しても、そこで行き止まりになることはありません。v0.152.0では、コンポーザーの上部に操作可能なレート制限バナーが表示されます。利用状況の確認、クレジットの管理、上限のリセット、ワークスペース所有者への通知、プランの管理が可能で、認証済みのアカウントとユーザーに該当する項目だけが表示されます。上限エラーの後には利用状況が更新され、バナーで指示された場合は、関連のないスレッド設定を変更せずに、最初に利用可能なフォールバックモデルへ Codex が切り替わります。¹³⁸ v0.153.0では、Plus と Team プランに対する警告が従来より早く表示されるようになりました。約5時間の利用枠で残量が半分を下回ると警告が発生します。その他のプランや異なる長さの利用枠では、従来どおり75%、90%、95%のしきい値が使用されます。¹⁴⁰

クレジット消費量

Codex の操作では、プランに割り当てられたクレジットを消費します。

これらは Standard 速度の料金であり、料金ページによると、GPT-6 のリリース後も GPT-5.6 Sol、Terra、Luna の料金は「変更なし」です。実際には「GPT-5.6 の利用では、1メッセージあたり平均5〜30クレジットを消費」します（8月のアクセス開始時点では5〜40と記載されていました）。Fast モードでは、GPT-6.1 Sol、および「利用可能な場合」の GPT-6 Astra、Sol、Lunaについて、Standard の2.5倍のクレジットを消費します。また、バンドルされたカタログでは、service_tierを設定しない限り、TUI の GPT-6 Sol と Luna（GPT-6.1 Sol を除く）で Fast がデフォルトのティアとなります。予想よりクレジットの減りが速い場合は、/fast statusを確認してください。画像生成では、同等のテキストのみのターンと比べて、含まれる上限を3〜5倍速く消費します。^162171178

Enterprise と Edu プランでは、契約上の割り当てに応じてクレジットが拡張されます。現在の利用状況は、TUI で/statusを確認してください。

API の課金

API 経由で Codex を使用する場合、選択したモデルに対する OpenAI の標準的な API 料金に基づき、トークン単位で課金されます（適用可能なプロンプトキャッシュ割引を含む）。100万トークンあたりの現在の API 料金は、GPT-6.1 Sol が入力$2 / 出力$10（キャッシュ済み入力$0.10）、GPT-6 Sol が$2 / $10、GPT-6 Luna が$0.10 / $0.50、GPT-6 Astra が$10 / $50です。4モデルすべてで、入力が272Kトークンを超えるプロンプトは、リクエスト全体について入力が2倍、出力が1.5倍の料金となり、Fast モードは2倍です。^146171178 ChatGPT のクレジット倍率は、API キーによるサインインには適用されません。現在の料金については、公式 API 料金ページをご確認ください。²⁰

コスト最適化戦略

1. プロファイルを使用する：日常的なタスク向けに、gpt-6-lunaとmodel_reasoning_effort = "low"を指定したfastプロファイルを作成します
2. 高い推論レベルは必要な場合に限る：xhighはトークン消費量が3〜5倍になるため、本当に難しい問題だけに使用します
3. --ephemeralを使用する：CI/CD ではセッションを永続化せず、オーバーヘッドを削減します
4. 推論要約を最小限にする：説明が不要な場合は、model_reasoning_summary = "none"を設定します
5. exec モードで一括処理する：自動化ワークフローでは、codex execによって TUI のオーバーヘッドを回避できます
6. 利用状況を監視する：TUI の/statusと組織の課金ダッシュボードを確認します。v0.148.0以降では、対象となるワークスペースの/status、ステータス行、ターミナルタイトルに、スレッドの推定クレジット数またはコストが表示されます¹¹⁸

実際のコスト例

一般的なタスクにおける代表的な API コスト（2026年半ばの gpt-5.3-codex 料金を使用したスナップショット、推論レベルは medium。モデルが変わっても相対的な規模感は共通です）：

コストは、推論レベル、キャッシュ、会話の長さによって変動します。日常的なタスクにはgpt-5.6-lunaを使用すると、費用を大幅に削減できます。キャッシュ済みの入力トークンには割引料金が適用されます。

隠れたトークンのオーバーヘッド

ツールを呼び出すたびに、画面に表示されるプロンプト以外のトークンも追加されます。

上級者向けのヒント： 実際の利用状況は、TUI の/statusで監視してください。トークン数には、表示されているメッセージだけでなく、すべてのオーバーヘッドが含まれます。予想外のコストが発生した場合は、接続されている MCP サーバーの数を確認しましょう。各サーバーのツール定義が、API を呼び出すたびに追加されます。

チームのコスト管理

チームのコストを管理するための戦略： - requirements.tomlを設定することで、組織全体にモデルと推論レベルの制限を適用します - CI/CD にはgpt-5.6-lunaを使用する — 自動化パイプラインで最大レベルの推論が必要になることはほとんどありません - プロファイルベースで予算を管理する — コスト上限を適切に設定したci、review、devプロファイルを定義します - OpenTelemetry で監視する — Enterprise 環境では、利用状況のテレメトリを既存の可観測性スタックへエクスポートできます

判断フレームワーク

各インターフェースを使い分ける基準

各 sandbox モードを使い分ける基準

各推論レベルを使い分ける基準

Plan モードと直接実行

Will Codex need to change more than 3 files?
│
├── YES → Use Plan Mode (/plan)
│         Codex designs the approach BEFORE making changes.
│         You review and approve the plan.
│         Best for: refactors, new features, migrations
│
└── NO → Is the change well-defined?
         │
         ├── YES → Direct execution
         │         Just describe the task. Codex executes immediately.
         │         Best for: bug fixes, small features, test additions
         │
         └── NO → Use Plan Mode (/plan)
                  Let Codex explore and propose an approach first.
                  Best for: unfamiliar codebases, ambiguous requirements

Steer モード：Enter と Tab

目安：Enter =「止まって、今すぐこれを聞いてください」。Tab =「今の作業が終わったら、これも実行してください」。

Desktop App と CLI

How do you prefer to work?
│
├── Terminal-first → Use CLI
│   │
│   ├── Single focused task → codex (interactive TUI)
│   ├── Scripted automation → codex exec (non-interactive)
│   └── Quick one-shot → codex exec "prompt" -o result.txt
│
└── Visual/multi-project → Use Desktop App
    │
    ├── Multiple parallel tasks → Multi-thread with worktree isolation
    ├── Visual diff review → Built-in Git diff viewer
    ├── Scheduled automation → Automations tab
    └── Voice-driven → Ctrl+M for voice dictation

どのプロファイルを選ぶべきか

タスクに合った設定済みプロファイルを選びます。

プロファイルファイル（各プリセットにつき1つ、~/.codex/ 内。従来の単一ファイルによる profile = "default" + [profiles.*] レイアウトは、0.134.0 以降読み込まれません¹²²）：

# ~/.codex/fast.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"

# ~/.codex/careful.config.toml
model = "gpt-6-astra"
model_reasoning_effort = "xhigh"

# ~/.codex/pair.config.toml
model = "gpt-5.3-codex-spark"
model_reasoning_effort = "high"

# ~/.codex/ci.config.toml
model = "gpt-6-luna"
# GPT-6 Sol/Luna start on the Fast tier (2.5x credits) unless service_tier is set; check /fast status
model_reasoning_effort = "low"
sandbox_mode = "workspace-write"

セッションごとにプロファイルを切り替えるには、codex --profile careful を使用します。

Sandbox と承認システムはどのように機能しますか？

Codex は、技術的に可能な操作と人間の承認を求めるタイミングを分離した2層のセキュリティモデルを採用しています。この仕組みは Claude Code の権限システムとは根本的に異なり、Codex では OS カーネルレベルで制限を適用します。⁵ 管理者が組織全体に適用する requirements.toml の制約については、エンタープライズデプロイもご覧ください。

v0.148.0 の強化： Linux と Windows の両方で、sandbox の制限がフェイルクローズになりました。拒否されたパスや読み取れないパスは、暗黙的に許可されるのではなく、ブロックされたものとして扱われます。¹¹⁸

レイヤー1：Sandbox（可能な操作）

sandbox は、OS ネイティブの仕組みを使ってファイルシステムとネットワークへのアクセスを制御します。

プラットフォーム固有の適用方法：

• macOS：Apple の Seatbelt フレームワークを sandbox-exec 経由で使用します。モード固有のプロファイルが実行時にコンパイルされ、カーネルによって適用されます⁶。v0.121.0 以降、macOS の sandbox プロファイルでは、特定の Unix ソケット（docker.sock、エディターの IPC ソケットなど）を許可リストに追加できます。また、プライベート DNS の名前解決はデフォルトでブロックされなくなりました。⁸²
• Linux：ファイルシステムの制限には Landlock、システムコールのフィルタリングには seccomp を使用します。独立したヘルパープロセス（codex-linux-sandbox）により、多層防御の分離を実現しています。⁵ Bubblewrap（bwrap）は Linux ビルドの一部として同梱・コンパイルされます（v0.100.0 でオプション扱いから昇格）⁷。v0.117.0 では、レガシーなカーネル構成を持つ古いディストリビューションでの sandbox の信頼性が向上しました。⁷⁵ v0.129.0 では Linux の sandbox 起動処理が強化され、同梱の Bubblewrap が上流のセキュリティパッチを含む 0.11.2 に更新されました。v0.130.0 では、起動処理がさらに強化されています。⁸⁹⁹¹
• Windows：制限付きトークンを使用するネイティブ sandbox です（v0.100.0 で試験的機能から昇格）。WSL もサポートされており、Linux の Landlock と seccomp を継承します。v0.117.0 では、プロセス分離を改善するために制限付きトークンの sandbox が強化されました。⁷⁵ v0.130.0 では、sandbox ユーザーにデスクトップランタイムのバイナリキャッシュへのアクセス権が付与され、Windows sandbox がワークスペースの sandbox ユーザー向けにランタイムバイナリを確実に解決できるようになりました。⁹¹

これが重要な理由：コンテナベースの sandbox（Docker）とは異なり、OS レベルの sandbox は高速かつ軽量で、脱出も困難です。Codex がシステムコールを認識する前に、カーネルが制限を適用します。

セキュリティ修正： - zsh-fork による sandbox 回避（v0.106.0）： zsh のフォークを介したシェル実行により、sandbox の制限を回避できる脆弱性が修正されました。⁶⁰ これより前のバージョンを使用している場合は、直ちにアップグレードしてください。 - 入力サイズの上限（v0.106.0）： 極端に大きなペイロードによる停止を防ぐため、入力に約100万文字の上限が適用されるようになりました。⁶⁰ - 安全な devcontainer プロファイル（v0.121.0）： Docker devcontainer 向けに強化された新しいカスタマープロファイルでは、コンテナ内の sandbox に Bubblewrap を使用します。WSL2 はサポートされますが、WSL1 は明示的に拒否されます（Bubblewrap は WSL1 のカーネルシムと互換性がありません）。⁸² - Guardian レビューと hooks（v0.121.0）： Guardian のレビューセッション中は hooks が無効化されるため、ツール実行前後の hooks が Guardian サブエージェントの判断に干渉することはありません。⁸² ログ記録や検証を hooks に依存している場合、Guardian レビューでは実行されない点に注意してください。完全な監査証跡が必要なら、app-server の可観測性を利用しましょう。 - Linux の /dev ファイルシステム（v0.105.0）： Linux 上で sandbox 化されたコマンドに最小構成の /dev ファイルシステムが提供されるようになり、デバイスノードを必要とするツールとの互換性が向上しました。⁶¹

ReadOnlyAccess ポリシー（v0.100.0以降）： 読み取りアクセスをきめ細かく制御できる構成可能なポリシー形式です。workspace-write モードでも、Codex が読み取れるディレクトリを制限できます。

[sandbox_workspace_write]
read_only_access = ["/etc", "/usr/local/share"]  # Only these paths readable outside workspace

レイヤー2：承認ポリシー（確認するタイミング）

承認ポリシーは、Codex が処理を一時停止して人間の確認を求めるタイミングを決定します。

on-failure は古い例や互換性維持のための経路に残っていますが、現在の OpenAI 設定ドキュメントでは非推奨とされています。対話型の実行には on-request、外部に安全境界が用意された非対話型の実行には never を推奨します。⁸⁷

v0.150.0 以降、コンポーザーから権限モードを順番に切り替えるキーボードショートカットを割り当てられます。/keymap で設定してください。¹³²

個別の承認 ID（v0.104.0以降）

複数ステップのシェル実行では、各コマンドに個別の承認 ID が割り当てられるようになりました。これにより承認がきめ細かくなり、シーケンス内の1つのコマンドを承認しても、同じシェル呼び出しに含まれる後続のコマンドまで自動的に承認されることはありません。⁴⁹

柔軟な承認制御（v0.105.0以降）

承認フローで、追加の sandbox 権限と個別の拒否がサポートされるようになりました。⁶¹

• 追加の sandbox 権限：現在の sandbox モードを超えるアクセスがコマンドに必要な場合、モード全体を変更するのではなく、必要な追加権限だけをリクエストできます
• 個別の拒否：ツール呼び出しを個別にフィードバック付きで拒否できるため、Codex は同じコマンドを単純に再試行せず、アプローチを調整できます

実行時の権限リクエスト（v0.113.0以降）

実行時に追加の権限を要求できる組み込みの request_permissions ツールが追加されました。⁶⁹ 昇格したアクセス権が必要なタスクに遭遇すると、暗黙的に失敗したり、別のフラグを指定して再起動するよう求めたりするのではなく、TUI の承認フローを通じて特定の権限（ファイルシステムのパス、ネットワークアクセスなど）を正式に要求できます。

アプリ承認モード writes（v0.144.0以降）

アプリとコネクターに、中間的な承認レベルが追加されました。writes アプリ承認モードでは、アプリが読み取り専用として宣言した操作は確認なしで実行でき、書き込みを伴う操作では引き続き一時停止します。¹⁰⁷ 以前のアプリ承認は全許可か全拒否に近いものでしたが、writes は多くの運用者が連携機能に求める信頼モデル、つまり「見るのは自由、触る前には確認」に合致します。

自動レビューされる承認：--approve-for-me（v0.147.0以降）

新しい --approve-for-me CLI フラグは、承認プロンプトを自動レビューされる承認に変えます。処理を中断して確認を求める代わりに、各リクエストがレビューパスで審査され、代理で承認または拒否されます。¹¹⁶ これは、「すべて承認する」（現在は削除された --full-auto が推奨していた姿勢）と「すべての操作で中断する」の中間に位置します。プロンプトは判断ポイントとして残りますが、レビュー担当が回答します。このフラグは、v0.146.1 で導入された、サイバー操作が可能なモデル向けのより安全な自動レビューデフォルトを継承します。権限の委任として扱ってください。中断すると停止してしまう長時間の無人実行には適していますが、認証情報や本番環境の状態に触れ、自分で確認したいセッションには適しません。

昇格したターミナル入力の承認（v0.151.0、v0.158.0以降はデフォルトで有効）

write_stdin_approval 機能フラグは、v0.151.0 で導入された時点ではデフォルトで無効でしたが、v0.158.0 以降はデフォルトで有効です。昇格した unified-exec ターミナルへ空でない入力を送信する前に、新たな承認を求めます。これらのレビューは、hooks、Guardian、アプリサーバー、TUI を経由して writeStdin 承認として処理されます。ターミナルの環境、起動ディレクトリ、昇格状態はターンをまたいで維持され、承認後、バイトが書き込まれる前にプロセスの識別情報が再検証されます。完全に整形されたアクションと承認理由は8,000バイト以内に収める必要があります。サイズ超過または途中で切り詰められたアクションは、承認が要求される前、かつターミナルに何も到達しない段階で拒否されます。¹³⁵ v0.158.0 ではこのフラグが有効化され（#47799）、プラグインがメトリクス用途で使用するような実行時限定の許可ではレビューが発生しなくなりました。一方、追加のエージェント権限、sandbox の回避、起動後のポリシー変更では引き続き発生します（#48073）。無効にする方法： config.toml の [features] に write_stdin_approval = false を設定します。¹⁷⁶

権限プロファイル（v0.113.0以降、v0.128.0およびv0.133.0で拡張）

権限プロファイルは、ファイルシステムとネットワークの sandbox ポリシーを、名前付きで再利用可能なセクションに分割します。default_permissions には :read-only や :workspace などの組み込みプロファイルを設定するか、カスタムの [permissions.<name>] テーブルを指定します。⁸⁷ v0.133.0 では、プロファイルが管理対象のインターフェースとして昇格しました。利用可能なプロファイルのメタデータを一覧 APIs で公開できるほか、プロファイル同士の継承、管理対象の requirements.toml による権限要件の宣言、実行時のアクティブプロファイル更新が可能です。また、Windows の sandbox 設定では、独立した場当たり的なポリシーではなく、解決済みのプロファイルを使用するようになりました。⁹⁸

default_permissions = "project-safe"

[permissions.project-safe.filesystem]
"/usr/local" = "read"
glob_scan_max_depth = 3

[permissions.project-safe.filesystem.":project_roots"]
"." = "write"
"**/*.env" = "none"

[permissions.project-safe.network]
enabled = true
mode = "limited"

[permissions.project-safe.network.domains]
"api.github.com" = "allow"
"registry.npmjs.org" = "allow"

プロジェクトルートが書き込み可能な場合でも読み取りを禁止すべき機密ファイルや glob には、none を使用してください。一度限りのコマンド例外には、プロファイルを広範囲に拡張するよりもルールの使用を推奨します。⁸⁷

v0.151.0： 復元された app-server スレッドでは、権限プロファイルが従来のターン単位の sandbox オーバーライドへ平坦化されず、そのまま維持されるようになりました。プロファイルはターンのルーティングや互換性のある /cd によるディレクトリ変更をまたいで存続します。復元されたプロファイルを従来の sandbox モードとして安全に表現できない /cd は、暗黙的に制限を弱めるのではなく拒否されます。¹³⁴

従来の --full-auto に関するガイダンス

古いガイドでは、--full-auto を次の設定に相当する便利なエイリアスとして説明していました。

codex --sandbox workspace-write --ask-for-approval on-request

v0.128.0 のリリースノートでは --full-auto が非推奨とされ、現在の CLI ヘルプにも対話型実行用のオプションとして掲載されていません。代わりに、上記の明示的なフラグか、名前付きの権限プロファイルを使用してください。⁸⁶

v0.147.0 で削除が完了し、codex exec --full-auto は利用できなくなりました。 このフラグを渡し続けているスクリプトは、実行されずエラーになります。移行は機械的に行えます。--sandbox workspace-write に置き換え、以前の呼び出しが --full-auto の承認動作に依存していた場合は、承認フラグまたはプロファイルも追加してください。アップグレード前に、codex exec をシェルから呼び出す自動化を監査しましょう。この問題は非推奨警告ではなく、パイプラインの停止として現れます。¹¹⁶

Sandbox の信頼性（v0.129.0）： Linux の sandbox 起動処理が強化され、低速なファイルシステムやシンボリックリンクを使ったチェックアウトにおける競合が軽減されました。Windows の sandbox に対する信頼性向上では、長時間実行時に発生する複数のエッジケースのクラッシュが解消されています。また、同梱の Bubblewrap は上流のセキュリティパッチを含む 0.11.2 に更新されました。設定変更は不要です。適用するには codex update を実行してください。⁸⁹

推奨設定

日常的な開発（安全なデフォルト）：

sandbox_mode = "workspace-write"
approval_policy = "on-request"

パワーユーザー向け（フルアクセス、人間による確認あり）：

sandbox_mode = "danger-full-access"
approval_policy = "on-request"   # `untrusted` retired in v0.149.0

コミュニティの記事では、この組み合わせが「最適なバランス」として推奨されています⁸。ただし、同じ推奨を繰り返す前に、実際の動作を理解しておきましょう。コマンドが sandbox の外に出るか、ネットワークへ到達する必要がある場合に承認プロンプトが表示されますが、danger-full-access はその両方の境界を取り除くため、on-request で昇格が必要になる場面はほとんど残りません。これは「すべてのコマンドを人間が確認する最大権限」ではなく、「確認を最小限に抑えた最大権限」です。前者が必要なら workspace-write を維持し、sandbox の境界で確認が発生するようにしてください。¹²³

CI/CD の自動化：

sandbox_mode = "workspace-write"
approval_policy = "never"

Guardian サブエージェントによるスマート承認（v0.115.0以降）

スマート承認では、すべての操作に人間の承認を求める代わりに、レビューリクエストを Guardian サブエージェントへ送れます。Guardian セッションは承認をまたいで維持され、プロンプトキャッシュを再利用して起動時のオーバーヘッドを回避します。各レビューにはクリーンな履歴が与えられるため、以前の判断が後続のレビューに漏れることはありません。⁷³

config.toml でレビュー担当を設定します。

approvals_reviewer = "guardian_subagent"   # "user" (default) or "guardian_subagent"

これは、包括的に approval_policy = "never" と設定するのではなく、理由付けを伴う自動レビューが必要な CI/CD ワークフローで特に便利です。

Guardian v2 のデフォルト変更（v0.151.0）： Guardian v2 では、画像を含むコンピューター操作のレビューがデフォルトになりました。features.guardianv2.review_scope.computer_use_only のデフォルトは true です。より広いツールレビュー範囲を維持するには false に設定してください。また、features.guardianv2.transcript.include_images のデフォルトも true です。Guardian の記録から画像を除外するには false に設定します。どちらも v0.150.0 では設定可能かつデフォルト無効の機能として導入され、v0.151.0 でデフォルトが有効になりました。¹³⁵

Guardian の対象範囲は承認モードに追従（v0.153.0）： 2つのモードでは、結果を変えられない Guardian の処理が省略されるようになりました。Full Access（すでに approvalPolicy: "never" と無制限の権限を組み合わせたもの）では、確認のみを目的とする Guardian と MCP のリクエストが、同期レビュー、サンプラーの事前ウォームアップ、バックグラウンド採点なしで承認されます。保留中、失敗済み、制限付きの環境は Full Access として扱われません。また、アクティブな権限状態がターンごとに再評価されるため、既存のスレッドでも Full Access へ安全に移行したり、そこから離れたりできます。ユーザー承認モード（approvals_reviewer = "user"）では、Guardian の事前ウォームアップと非同期採点が省略され、通常の node_repl.js 実行確認は自動的に受け入れられます。一方、機密性の高い操作の検査やユーザー入力のリクエストについては、従来の動作が維持されます。¹⁴⁰ これは Guardian が実行されるタイミングを限定するもので、人間による承認レイヤーを変更するものではありません。このガイドで説明している on-request での danger-full-access の確認動作は承認ポリシーによるもので、別の仕組みです。さらに v0.152.1 では、Guardian の承認レビューが Node REPL ポリシーをモデルのメタデータ（auto_review.node_repl_policy）から取得できるようになりました。このフィールドがない場合は、同梱のポリシーへフォールバックします。¹³⁹

Guardian のコンピューター操作採点はモデル要件に従う（v0.153.1）： コンピューター操作のみを対象とする Guardian の採点と迅速な承認判断は、アクティブなモデルのメタデータで node_repl_auto_review_required が設定されている場合に限り実行されるようになりました。また、モデルの切り替えによって採点が省略される場合は、以前のスコアや処理中のスコアが無効になります。そのため、レビュー対象のモデルへ戻しても、古い承認判断が復活することはありません。これは v0.153.1 パッチの主要な変更ですが、リリース本文には記載されていません。#42422（38ba8cdc の cherry-pick）は、rust-v0.153.0…rust-v0.153.1 の比較でのみ確認できます。¹⁴²

Guardian による親の compaction 再利用がデフォルトで有効（v0.156.0）： #46522 により guardian_reuse_parent_compaction が安定版機能へ昇格し、デフォルトで有効になりました。これにより Guardian は、レビューセッションを再起動するときに親スレッドの暗号化された compaction を再利用できます。PR のテストによると、親の履歴が変わった場合、キャッシュされたレビューセッションは引き続き無効化されます。以前の動作に戻す方法： config.toml の [features] で guardian_reuse_parent_compaction = false を設定するか、codex features disable guardian_reuse_parent_compaction を実行してください。¹⁶⁹¹⁷¹

Guardian のスレッドコンテキストがデフォルトで有効（v0.157.0）： #47275 により guardianv2.thread_context が安定版へ昇格し、同期および非同期の Guardian レビューで有効になりました。これにより、レビューではスレッドが所有するコンテキストが使用されます。この機能は、Guardian v2 の enabled 切り替えとは独立しています。v0.157.0 では [features.guardianv2] に thread_context = false を設定して無効化できましたが、v0.158.0 でそのオプションは削除されました。¹⁷⁴

Guardian のスレッドコンテキストが常時有効（v0.158.0）： #47686 と #47689 により、Guardian セッションのキャプチャおよびサブエージェントの履歴フォークでは、スレッドが所有するコンテキストを無条件で使うようになりました。Codex は、プロファイルのオーバーライドや管理対象の要件を含め、[features.guardianv2] 内の thread_context を無視し、config.toml から削除するよう求める非推奨通知を表示します。代替となる無効化スイッチはありません。¹⁷⁶

Guardian が過去のユーザーメッセージを読み取り可能（v0.160.0、オプトイン）： Guardian がレビューする記録では、以前の指示、制限、取り消された権限が省略される場合があります。Apps を有効にし、[features] で guardian_conversation_history_tools = true を設定すると、レビュー担当に user_message.search_messages と user_message.read_messages の2つのツールが提供されます。これらは、親セッション自身の Apps 接続と識別情報を通じて提供されます。呼び出しのたびに親の現在のアプリおよびツールポリシーが再確認され、無効なツールや承認を必要とするツールではフェイルクローズします。2つの [auto_review] キーで調整できます。conversation_history_max_output_tokens は各レスポンスの上限を設定します（デフォルトの推定値は4,000トークンで、親側のより厳しい制限も引き続き適用されます）。experimental_conversation_history_prompt は組み込みの取得指示を置き換えます（空欄の場合はデフォルトを使用）。もう1つのオプトインフラグ guardian_root_handoff_context は、ワーカーエージェントのレビューで使用するルート会話の証拠を、各引き継ぎの前後にあるメッセージと最新の3件に限定します。どちらのフラグも開発中で、デフォルトでは無効です。設定リファレンスにもまだ掲載されていません。¹⁸²

[features]
guardian_conversation_history_tools = true

[auto_review]
conversation_history_max_output_tokens = 4000

PowerShell 分類器の厳格化（v0.142.2）： 安全性分類器が検査できない実行可能な AST 領域を含む PowerShell コマンドは、自動承認をすり抜けるのではなく、承認が必要になりました。これにより、難読化された PowerShell や動的に構築された PowerShell が Windows 上で分類を回避できる問題が解消されます。¹⁰⁵

危険なコマンドの検出を拡張（v0.144.5）： より多くの強制的な rm の形式を検出できるようになりました。また、拒否されたコマンドには、不透明な拒否通知ではなく、より明確な拒否理由が返されます。承認ポリシーを調整し、コマンドがブロックされた理由を把握する必要がある場合に便利です。¹¹⁰

ネットワークアクセスの有効化

Codex は、workspace-write モードではデフォルトでネットワークアクセスをブロックします。必要に応じて有効にしてください。

# Per-run
codex -c 'sandbox_workspace_write.network_access=true' "install the packages"

# In config.toml
[sandbox_workspace_write]
network_access = true
writable_roots = ["/path/to/extra/dir"]   # Additional writable directories
exclude_slash_tmp = false                  # Prevent /tmp from being writable
exclude_tmpdir_env_var = false             # Prevent $TMPDIR from being writable

WebSocket プロキシのサポート（v0.104.0以降）

WebSocket トラフィックをプロキシ経由で処理する企業環境向けに、WS_PROXY と WSS_PROXY の環境変数がサポートされるようになりました。⁴⁹

export WSS_PROXY="https://proxy.corp.example.com:8443"
codex "update the README"

これらは、既存の HTTPS_PROXY および SOCKS5 プロキシのサポート（v0.93.0以降）を補完します。

v0.146.0 で「すべてのトランスポート層」が実際にプロキシ対応となりました。 設定されたプロキシは、認証、プラグインのダウンロード、MCP の認可、リモート実行、WebSocket 接続、HTTP リダイレクト、LM Studio 接続の全体で利用されるようになりました。変更履歴によると、これら7つの経路では以前プロキシが無視されていました。¹¹⁴ v0.146.0 より前の Codex を企業プロキシ内で実行し、通常のモデル呼び出しは機能するのにログインやプラグインのインストールが失敗していた場合、この不整合が原因である可能性が高いでしょう。

macOS のシステムプロキシ（v0.142.2以降）： respect_system_proxy を有効にすると、macOS の認証クライアントがシステムプロキシ、PAC、WPAD の設定に従います。これにより、プロファイルを通じてプロキシ設定が配布される企業の Mac では、認証トラフィック用にシェルごとのプロキシ環境変数を設定する必要がなくなりました。¹⁰⁵ v0.143.0 以降、この対応は Windows と Responses API トラフィックにも拡張されています。 Codex は、認証と Responses API の呼び出しの両方を、PAC および WPAD の自動構成を含む macOS または Windows のシステムプロキシ経由で処理します。これにより、いずれの OS でも厳しく制限された企業ネットワークに残っていた最後の問題が解消されました。¹⁰⁶

Sandbox のテスト

信頼して使用する前に、sandbox の動作を検証してください。

codex sandbox macos --permissions-profile :workspace -- ls /etc/passwd   # macOS test
codex sandbox linux --permissions-profile :workspace -- cat /etc/shadow  # Linux test

sandbox が正しく動作していれば、ワークスペースに限定されたプロファイルでは、どちらのコマンドも権限拒否エラーで失敗するはずです。いずれかのコマンドが成功した場合は、sandbox の設定を調査する必要があります。

AGENTS.md の仕組み

AGENTS.md は Codex のプロジェクト指示システムです。現在は Linux Foundation の Agentic AI Foundation が管理するオープン標準⁹であり、Codex、Cursor、Copilot、Amp、Jules（Google）、Gemini CLI、Windsurf、Cline、Aider、Zed、Factory、RooCode、および 60,000 を超えるオープンソースプロジェクトでサポートされています。特定のリポジトリやディレクトリ内で Codex がどのように動作するかを定義します。AGENTS.md を補完する再利用可能な専門知識パッケージについては、skillsをご覧ください。

検出階層

Codex はセッション開始時にディレクトリツリーをたどり、指示チェーンを構築します。

1. グローバル（~/.codex/）：AGENTS.override.md > AGENTS.md
2. プロジェクト（git ルートから現在のディレクトリまで）：各階層で AGENTS.override.md > AGENTS.md > フォールバックファイル名の順に確認
3. マージ：ファイルはルートから下位へ連結されます。現在のディレクトリに近いファイルほどプロンプトの後ろに配置され、先にある指示を上書きします

~/.codex/AGENTS.md                     ← Global defaults
  └─ /repo/AGENTS.md                   ← Project-wide rules
      └─ /repo/services/AGENTS.md      ← Service-specific rules
          └─ /repo/services/payments/
               AGENTS.override.md      ← Overrides everything above for this dir

信頼されていないプロジェクトではプロジェクトの AGENTS.md をスキップ（v0.150.0）： 上記の走査は、プロジェクトが信頼されていることを前提としています。v0.150.0 以降、「信頼されていないプロジェクトはプロジェクトレベルの AGENTS.md 指示を提供しなくなり、権限の変更後も管理された読み取り拒否ルールが引き続き適用されます」。つまり、プロジェクトスコープの検出はスキップされる一方、ユーザーレベルの ~/.codex/AGENTS.md の指示は維持されます。そのため、信頼する前のチェックアウトから動作規約を注入されることはありません。¹³²

デスクトップの複数フォルダープロジェクト（26.715、2026年7月23日）： 上記の走査は CLI の動作を示しており、すべてが現在の作業ディレクトリを基準に解決されます。ChatGPT デスクトップアプリでは、関連する複数のフォルダーを1つのローカルプロジェクトに含められるようになりました。ただし、検出の基準となるのはそのうちの1つだけです。「新しいチャット、Git 操作、AGENTS.md、skills、config.toml の自動検出では、プライマリフォルダーが使用されます。セカンダリフォルダーも、ファイルの検索、読み取り、編集には引き続き利用できます」。プロジェクトメニューの プロジェクトを編集 から、プライマリにするフォルダーを選択できます。¹¹³

この1つの設定が、Codex の5つの中核システムのうち3つを同時に制御します。指示、skills、設定は、すべてプライマリフォルダーに従います。実際には、セカンダリフォルダー内の AGENTS.md は Codex が開けるファイルにすぎず、読み込まれる動作規約ではありません。ルールを含むリポジトリを2番目に追加した場合は、それをプライマリに昇格させるか、そのルールをプライマリフォルダーの AGENTS.md に改めて記載してください。自動検出を想定していたリポジトリ内の skill フォルダーにも同じことが当てはまります。CLI のディレクトリ走査自体は何も変わっていません。これはデスクトップアプリにおけるプロジェクトスコープの仕様です。

優れた AGENTS.md の条件

Codex 自体による直接的なガイダンスとコミュニティのパターン¹⁰に基づきます。

推奨： - 具体的に書く："Use rg --files for discovery" は "search efficiently" より明確です - 完了条件を定義する：「完了」とは何を意味するのかを示します（テスト合格、lint エラーなしなど） - コマンドを含める：ビルド、テスト、lint、フォーマットの正確な実行方法を記載します - タスク別に整理する：コーディング、レビュー、リリース、インシデント／デバッグのセクションに分けます - エスカレーション方法を定義する：行き詰まった場合や予期しない状態に遭遇した場合の対応を示します

非推奨： - 実行ルールを伴わないスタイルガイド全体の貼り付け - 曖昧な指示（「注意する」「最適化する」） - 矛盾する優先事項の混在（速度重視＋網羅的な検証＋実行時間の余裕なし） - 説明用の文章を書くこと（AGENTS.md は運用ポリシーであり、README ではありません）

例：本番環境向け AGENTS.md

# Repository Guidelines

## Build, Test, and Development Commands
- Run API (dev): `python3 -m uvicorn main:app --reload`
- Install deps: `pip install -r requirements.txt`
- Lint: `python3 -m ruff check .` (auto-fix: `--fix`)
- Format: `python3 -m ruff format .`
- Tests: `python3 -m pytest -v`
- Coverage: `python3 -m pytest --cov=app --cov-report=term-missing`

## Coding Style & Naming Conventions
- Python 3.11+. Type hints on all functions.
- Ruff enforced: 88-char lines, double quotes, spaces for indent.
- Naming: modules `snake_case.py`, classes `PascalCase`, functions `snake_case`.

## Commit & Pull Request Guidelines
- Conventional Commits: `feat:`, `fix:`, `docs:`, `refactor:`, `chore:`, `test:`
- Commits should be small and focused.
- PRs must include: description, test plan, and screenshots for UI changes.

## Security
- Never commit secrets. Use `.env` for local config.
- Validate all external API calls with proper error handling.

エージェントセッションでのシークレットの取り扱い

ソースコードだけでなく、Codex から参照できる履歴もセキュリティ上の対象として扱ってください。Codex のリリースノートには、シェルのスナップショット取得や環境変数の秘匿化に関する取り組みが記載されています。また、メモリーシステムはメモリーへの書き込みにシークレットが含まれていないかスキャンします。しかし、こうした保護機能があっても、コマンド出力、セッショントランスクリプト、シェルスナップショット、ローカルログ、ヘルパースクリプトが認証情報を出力しても安全な場所になるわけではありません。³⁷⁵⁵⁹⁵

運用ルールは単純です。モデルに確認させる目的でシークレットを出力しないでください。ヘルパー用の認証情報は環境側で必要とされる設定に保持します。監査時には、実行可能なソース、ドキュメント、生成キャッシュ、セッショントランスクリプト、シェルスナップショット、ログ、意図的なシークレット保管場所を分離してください。確度の高いシークレット形式が見つかった場合はローカル履歴から秘匿化し、手動の衛生管理ループが実証されてから予防用 hooks を導入します。公開すべき知見は、対象領域の整理と受け入れ基準です。非公開のトークン値、正確なパス、検出処理の内部実装ではありません。⁹⁵

オーバーライドの仕組み

各ディレクトリ階層の AGENTS.override.md は、そのスコープにおける通常の AGENTS.md を置き換えます。次のような場合に使用します。

• リリース凍結：「新機能は禁止、修正のみ」
• インシデントモード：「すべての変更についてオンコール担当者のレビューが必要」
• 一時的な強化：「今スプリントでは依存関係を更新しない」

設定

# Custom fallback filenames (in addition to AGENTS.md)
project_doc_fallback_filenames = ["TEAM_GUIDE.md", ".agents.md"]

# Increase max size for large instruction files
project_doc_max_bytes = 65536    # 64 KiB (default: 32 KiB)

スキャフォールドの生成

codex                           # Launch TUI
/init                           # Generate AGENTS.md scaffold

または、指示チェーンを確認します。

codex --ask-for-approval never "Summarize your current instructions"

Hooks

Codex では、v0.99.0 と v0.100.0 で従来の AfterAgent および AfterToolUse という名前の hooks が導入されました。v0.114.0 では SessionStart と Stop を備えた試験的な hooks エンジンが追加され⁷⁰、v0.124.0（2026年4月23日）で安定版となりました。⁸⁵ rust-v0.150.0 に搭載されたエンジンには、12個のイベント（codex-rs/hooks/src/lib.rs の HOOK_EVENT_NAMES）が登録されています。v0.149.1 の時点では11個でしたが、v0.150.0 で12個目となる Interrupt が追加されました。¹³² 従来の名前は設定可能な項目から削除されています。AfterToolUse はソースツリーのどこにも存在せず、AfterAgent は従来の notify ブリッジにおける内部ペイロード名としてのみ残っています。¹²⁴ Hooks はエージェントループ中にスクリプトまたは MCP ツールを実行します。複数のファイルにある一致した hooks はすべて実行され、1つのイベントに一致する複数の command hooks は同時に起動します。また、管理対象外の hook は、実行前にすべて確認して信頼する必要があります。¹²⁴ v0.148.0 ではエンジンが拡張され、hooks でコマンドを非同期に実行したり、MCP ツールを呼び出したりできるようになりました。command ハンドラーに async = true を設定すると、Codex の処理を継続しながらバックグラウンドで実行できます。また、mcp_tool ハンドラーを使用すれば、エージェントと同じ MCP servers にアクセスできます。¹¹⁸¹²⁴

利用可能な Hook イベント

WebSearch などのホスト型ツールは hook の実行経路を通りません。また、一部の特殊なツール経路では hook を適用しないようにできます。OpenAI 自身は、これを「有用なガードレールではあるものの、完全な強制境界ではない」と説明しています。¹²⁴

Hook の設定

Hooks は、イベント、matcher グループ、1つ以上のハンドラーという3階層で構成されます。設定は hooks.json（~/.codex/hooks.json、<repo>/.codex/hooks.json、またはプラグインの hooks/hooks.json）に記述するか、config.toml および requirements.toml にインラインで記述します。プロジェクトローカルの hooks は、プロジェクトの .codex/ レイヤーが信頼されている場合にのみ読み込まれます。¹²⁴ インライン TOML の形式は次のとおりです。

# ~/.codex/config.toml or <repo>/.codex/config.toml
[[hooks.SessionStart]]
matcher = "startup|resume"

[[hooks.SessionStart.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/session_start.py"
additionalContextLimit = 5000

[[hooks.PreToolUse]]
matcher = "^Bash$"

[[hooks.PreToolUse.hooks]]
type = "command"
command = '/usr/bin/python3 "$(git rev-parse --show-toplevel)/.codex/hooks/pre_tool_use_policy.py"'
timeout = 30
statusMessage = "Checking Bash command"

[[hooks.PostToolUse]]
matcher = "^Bash$"

[[hooks.PostToolUse.hooks]]
type = "command"
command = "python3 ~/.codex/hooks/post_tool_use_review.py"
async = true
timeout = 120

ハンドラーのフィールドは、type（command または mcp_tool。prompt および agent ハンドラーは解析されますがスキップされます）、command、秒単位の timeout（デフォルトは600秒。SessionEnd は1秒で、上限は3秒）、statusMessage、additionalContextLimit（Codex が全文をディスクに保存してプレビューを送信する前に、additionalContext のうちモデルへ渡す量）、commandWindows（Windows 専用のオーバーライド）、async です。コマンドの作業ディレクトリにはセッションの cwd が使用されます。そのため、リポジトリローカルの hooks では、相対的な .codex/hooks/... パスではなく、git rev-parse --show-toplevel を基準にパスを解決してください。¹²⁴

確認と信頼。 Codex は、管理対象外の各 hook について、現在のハッシュに対する信頼状態を記録します。新規または変更された hooks は要確認とされ、信頼されるまでスキップされます。/hooks を実行すると、hook の提供元を確認し、内容を精査して信頼したり、個別の hook を無効化したりできます。起動時に確認が必要な hooks がある場合、Codex は /hooks を案内する警告を表示します。システム、MDM、クラウド、または requirements.toml 由来の管理対象 hooks は、ポリシーによって信頼されており、ユーザー向け hook ブラウザーから無効化することはできません。--dangerously-bypass-hook-trust を使用すると、hook の提供元を別の場所で検証する自動化向けに、永続的な信頼を記録せず、その1回の実行に限って有効な hooks を実行できます。¹²⁴

SessionStart hook の stdout はモデルのコンテキストに取り込まれるため、セッション開始時に日付、ブランチ名、環境変数などの動的情報を注入する用途に適しています。

Claude Code の Hook パターンを再現する

Codex が実装しているイベントには Claude Code と同じイベント名が使われています。そのため、ほとんどの hook 設定は、JSON を hooks.json に移し、/hooks から信頼することで移行できます。

エキスパート向けのヒント： 新しい hook イベントは今後のリリースでも追加されます。v0.150.0 では Interrupt イベントが追加されました（¹³²）。最新の一覧については、codex-rs/hooks/src/lib.rs の HOOK_EVENT_NAMES と Codex changelog を確認してください。

TUI 内の hook ブラウザー（v0.129.0）： TUI で /hooks を実行すると、利用可能な hooks を確認し、現在どれが有効かを把握したうえで、config.toml を編集せずに個別の hook を切り替えられます。プラグインに同梱された hook の問題を調査する場合や、編集に集中する間だけ PostToolUse linter を一時的に無効化する場合に便利です。⁸⁹

MCP（Model Context Protocol）とは？ [EXPERIMENTAL]

MCPは、外部のツールやサービスに接続することでCodexの能力を拡張します。codex mcp コマンド群は現在実験的と位置づけられており、コマンドや設定フォーマットはリリース間で変更される可能性があります。Codexは2種類のトランスポートに対応しています。STDIO（ローカルプロセス）とStreamable HTTP（リモートサーバー）です。¹¹

v0.121.0のMCP変更点: ツールは名前空間付きで登録されるようになり、一覧上のツール名は素の名前ではなく <server>:<tool> の形式で表示されます。修飾されていないツール名をgrepしているスクリプトやプロンプトは更新してください。新たに supports_parallel_tool_calls フラグが対象のMCPsへ引き渡され、対応を宣言したサーバーでは並列実行が可能になります。サンドボックスの状態メタデータもMCPツールのメタデータ経由で流れるようになったため、サーバー側が挙動を調整できます（例：read-onlyサンドボックス下での実行を警告する）。独自リクエストの codex/sandbox-state は削除されました。今後はメタデータ経路を使ってください。MCP Appsロールアウトのフェーズ3もここで到達し、ツール呼び出しに対応。deferred-callパターンを使うサーバー向けに、フラット化されたdeferredツール呼び出しもサポートされます。⁸²

v0.142.2のMCP変更点（2026年6月25日）: MCPツールは対応環境ではツール検索がデフォルトになりました。すべてのツール定義を事前に読み込むのではなく、Codexが必要に応じてツールを発見する方式です。ツール数の多い構成での発見性が向上しつつ、旧来のモデルやプロバイダーとの互換性も保たれます。また、リモートstdioのMCPサーバーは、リモートプラットフォームのパス形式で書かれた絶対作業ディレクトリも受け付けます（macOSクライアントからWindows形式のパス、またはその逆）。¹⁰⁵

v0.147.0のMCP変更点（2026年8月7日）: CodexにMCP 2026-07-28プロトコル改訂版へのオプトイン対応が追加されました。ページネーション付きの検出（巨大なツールカタログは1つの過大な一覧ではなくページ単位でストリーミングされます）、マルチラウンドリクエスト（サーバーが1つの論理リクエスト内で複数ステップのやり取りを保持できます）、そしてノンブロッキングなサーバー起動です。キャッシュ済みのMCPツールはサーバーの起動完了前に公開されるため、起動の遅いサーバーがセッション開始を止めることはなくなりました。オプトイン方式なので、旧改訂版のサーバーはそのまま動作します。¹¹⁶

v0.151.0のMCP変更点（2026年8月29日）: オプション扱いのMCPサーバーに設定可能な起動猶予時間が加わりました。mcp_optional_startup_grace_ms（デフォルト1,000ミリ秒）は、ツールカタログの取得がオプションサーバーをどれだけ待つかを制御します。0 にすると共有の猶予が無効になり、オプションサーバーは設定済みの startup_timeout_sec にフォールバックします。更新した値は実行中およびMCP設定の再読み込み時に適用されます。拡張機能からMCPツールの結果を検査または差し替えることもできます。ToolLifecycleContributor::on_mcp_tool_result は、MCPの完了が公開される前、かつ結果がモデル向けに整形される前に実行され、成功・エラーいずれの結果でも、Code Mode経由でも動作します。¹³⁴

v0.152.0のMCP変更点（2026年9月1日）: 追加的な変更が3点あります。openai/elicitation フォームリクエストが到着しました。クライアントがオブジェクト値の form ケーパビリティを宣言するとCodexはフォーム対応を通知し、openai/elicitation/create リクエストを処理して、そのメタデータと不透明なスキーマをapp server経由で openaiForm として転送します（x-openai-* アノテーションは保持されます）。従来の openai/form の処理は独立したまま残り、TUIはレンダリングできないフォームリクエストを自動的に拒否します。ツール単位の出力上限: MCPサーバーの tools 設定配下の各エントリは、正の output_token_limit を受け付けます（例：[mcp_servers.context7.tools.search] に output_token_limit = 2000）。プラグインとユーザーのポリシーが重なる場合は最も厳しい上限が優先され、実効値は会話履歴に引き継がれるため、ツール出力、post-toolフックの応答、再開したセッションのいずれも同じ上限で切り詰められます。グローバルな tool_output_token_limit と併存する追加機能です。パッケージ形式のサーバー名: MCPサーバー名に :、@、/、. を含められるようになりました（npm:@modelcontextprotocol/server-sequential.thinking は正当な名前です）。この名前は mcp add/get/list/remove、実行時のツール名前空間、OAuthの資格情報検索をまたいで保持され、生成される config.toml の復旧ヒントでは素の名前でないものが引用符で囲まれます。¹³⁸

MCPサーバーの設定

STDIOサーバー（ローカルプロセス）:

# In ~/.codex/config.toml or .codex/config.toml

[mcp_servers.context7]
enabled = true
required = true                         # Fail startup if unavailable
command = "npx"
args = ["-y", "@upstash/context7-mcp"]
env = { "MY_VAR" = "value" }            # Static env vars
env_vars = ["PATH", "HOME"]             # Forward host env vars
cwd = "/path/to/project"                # Optional working directory
startup_timeout_sec = 10
tool_timeout_sec = 60
enabled_tools = ["search", "summarize"]  # Tool allowlist
disabled_tools = ["slow-tool"]           # Tool denylist

HTTPサーバー（リモート）:

[mcp_servers.figma]
enabled = true
url = "https://mcp.figma.com/mcp"
bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
http_headers = { "X-Figma-Region" = "us-east-1" }
env_http_headers = { "X-Org-Id" = "FIGMA_ORG_ID" }  # Headers from env vars
startup_timeout_sec = 10
tool_timeout_sec = 60

CLIの管理

codex mcp add context7 -- npx -y @upstash/context7-mcp
codex mcp add context7 --env API_KEY=... -- npx -y @upstash/context7-mcp   # With env vars
codex mcp add figma --url https://mcp.figma.com/mcp --bearer-token-env-var FIGMA_OAUTH_TOKEN
codex mcp list                          # List all configured servers
codex mcp list --json                   # JSON output
codex mcp get context7                  # Show server config
codex mcp get context7 --json           # JSON output
codex mcp login <server>                # OAuth flow for HTTP servers
codex mcp logout <server>               # Remove OAuth credentials
codex mcp remove <server>               # Delete server definition

セッション中は /mcp で稼働中のサーバーと利用可能なツールを確認できます。/mcp verbose（v0.123.0+）⁸⁴ はサーバーの詳細な診断情報、リソース、リソーステンプレートを返します。サーバーの読み込みに失敗しているときや、ツールが想定した場所に現れないときに役立ちます。素の /mcp は高速なままです。v0.144.0 以降、MCPツールは実験的なオプトインなしで対話的に認証を要求できます。セッション途中で認証が必要になったサーバーは、codex mcp login で事前認証するまで失敗するのではなく、通常のフローでプロンプトを出します。¹⁰⁷

プラグインのMCP読み込み（v0.123.0+）は、標準の mcpServers スキーマと .mcp.json のトップレベルのサーバーマップの両方を受け付けるため、どちらの流儀で書かれたプラグインも問題なく読み込めます。⁸⁴

MCPのユーザー検証（v0.155.0、対応Mac）: 対応MacのローカルTUIセッションでは、MCPリクエストをTouch IDで検証し、Secure Enclaveで署名できます（#43624、#43712、#43715）。検証用のアイデンティティは登録したワークスペースに限定され（#43524）、検証結果はMCPツールの継続処理へネイティブに引き継がれます（#44346）。v2.68の昇格チェックリストで初めて監視対象となり、alpha.7クラスターと共に0.154.0から外れ、0.155.0で出荷されました。¹⁵⁶

CodexをMCPサーバーとして実行する

削除されました（v0.154.0、2026年9月9日）。 codex mcp-server コマンドと単体バイナリの codex-mcp-server は、stable 0.154.0（#42993）をもって廃止され、2026年8月24日の非推奨化が完了しました。公式チェンジログ（2026年9月5日）はこう述べています。「codex mcp-server コマンドと単体の codex-mcp-server バイナリは、2026年8月24日の非推奨化を経て削除されました。いずれかのコマンドを起動している統合は、Codexをアップグレードする前に更新してください。」統合先としては app-serverプロトコル（VS Code拡張機能とデスクトップアプリの背後にあるインターフェース。認証、会話履歴、承認、ストリーミングされるエージェントイベントを扱います）を狙うべきです。ただし削除の告知自体がこれを実験的であり「本番ワークロードではサポートされない」と明記しています。あるいはClaude Code側からは Claude Code向けCodexプラグイン があります。「Claude CodeからCodexを使ってコードをレビューしたり、タスクを委譲したりできます。」Codexを外部のMCPサーバーへ接続する側（codex mcp ...、/mcp）は影響を受けません。^125152153

CLI 0.153.4以前ではこのコマンドはまだ存在します（2026年8月24日に非推奨化。v0.149.0以降は warning: `codex mcp-server` is deprecated and will be removed in a future release. をstderrへ出力したうえで起動します、PR #39657）。統合をすぐに移行できない場合は、npm install -g @openai/codex@0.153.4 でピン留めするのが応急策になります:^12125148152

codex mcp-server                        # REMOVED in 0.154.0; works only on 0.153.x and earlier (deprecated, warns)

0.153.x以前では、サーバーは2つのツールを公開します: 1. codex(): プロンプト、サンドボックス、モデル、承認のパラメーターを指定して新しいセッションを開始します 2. codex-reply(): threadId とプロンプトで既存のセッションを継続します

Agents SDK（Python）と併用する場合 – CLI 0.153.4以前のみ:

from agents import Agent, Runner
from agents.mcp import MCPServerStdio

async with MCPServerStdio(
    name="Codex CLI",
    params={"command": "npx", "args": ["-y", "@openai/codex@0.153.4", "mcp-server"]},  # pin: removed in 0.154.0
    client_session_timeout_seconds=360000,
) as codex_mcp_server:
    agent = Agent(name="Developer", mcp_servers=[codex_mcp_server])
    result = await Runner.run(agent, "Fix the failing tests")

注目のMCPサーバー

実践パターン

パターン1: コンテキストを踏まえた開発 — Context7を自分のフレームワークのドキュメントと組み合わせ、Codexが常に最新のAPIリファレンスを参照できるようにします:

[mcp_servers.context7]
enabled = true
required = true
command = "npx"
args = ["-y", "@upstash/context7-mcp"]

パターン2: 出力の上限 — MCPツールのレスポンスはデフォルトで約25K文字に切り詰められます。大きなペイロードを返すツール（データベースクエリ、ログ取得など）では、enabled_tools で特定のツールに絞り込み、レスポンスを要点に保ちましょう。

パターン2a: マルチモーダルなツール出力（v0.107.0） — カスタムツールはテキストと併せてマルチモーダルな出力（画像、リッチコンテンツ）を返せるようになりました。これにより、スクリーンショットや図、チャートのレンダリングといった視覚的な成果物を生成するツールが、それらを直接モデルへ渡して分析させられます。⁶²

パターン3: エンタープライズにおけるMCPガバナンス — requirements.toml で開発者が使えるMCPサーバーを制限します:

# In /etc/codex/requirements.toml — only approved servers allowed
[mcp_servers.approved-internal]
identity = { command = "npx @company/internal-mcp" }

requirements.toml のアイデンティティに一致しないサーバーは、起動時にブロックされます。ポリシー設定の全体像は エンタープライズ展開 を参照してください。

Code Mode [EXPERIMENTAL]

Code mode（v0.114.0）は、エージェントの対象範囲をコード中心の操作に制限することで、より分離されたコーディングワークフローを提供します。⁷⁰ 有効にすると、より広範なシステム操作を行わず、コードの読み取り、書き込み、テストに集中します。

v0.139.0以降、code modeでは、ネストされた JavaScript ツール呼び出しからも含め、スタンドアロンのウェブ検索を直接呼び出せるようになり、結果をプレーンテキストで受け取ります。これにより、サンドボックス化されたコーディングコンテキストを離れることなく、最新情報を取得できます。¹⁶⁵ v0.146.0ではスタンドアロンのウェブ検索が互換性のあるカスタムモデルプロバイダーにも拡張され、この機能はOpenAIがホストするモデルだけに限定されなくなりました。¹¹⁴

v0.146.0では、app-serverがリモートのCode Modeホストへ接続できるようになり、code modeランタイムをクライアントと同じマシン上で動かす必要がなくなりました。当初は WebSocket が使用されていました。¹¹⁴ v0.151.0では WebSocket トランスポートが削除されています（#40692）。app serverの --code-mode-host 接続で受け付けるのは、http:// および https:// のgRPCエンドポイントだけです。また、スタンドアロンのcode-modeホストで使用できるのはstdioとgRPCリスナーに限られます。タグrust-v0.151.0時点のリスナーのドキュメントには、原文どおり「Transport endpoint: stdio, stdio://, or grpc://IP:PORT.」と記載されています。WebSocket は、トレース用のraw OTLPトレースバッチをストリーミングするオプションのエンドポイントとしてのみ残されており、セッショントランスポートとしては使用されません。¹³⁵

この機能は実験段階です。最新情報はリリースノートをご確認ください。

JavaScript REPLランタイム [REMOVED]

Codex v0.100.0では、実験的な JavaScript REPLランタイム（js_repl）が追加され、v0.106.0では /experimental から利用できるようになりました。⁶⁰ ただし、この案内は現在では過去のものです。v0.128.0のリリース変更履歴には「Remove js_repl feature」と記載され、現在の機能一覧では js_repl と js_repl_tools_only の両方が削除済みとされています。⁸⁶

新しい設定に features.js_repl = true を追加しないでください。繰り返し実行できるロジックが必要な場合は、シェルコマンド、リポジトリにコミットされたスクリプト、MCP ツール、または scripts/ ディレクトリを備えたCodex skillを使用します。

skillsとは？

skillsは、Codexが必要に応じて読み込む、再利用可能なタスク専用の機能パッケージです。オープンなagent skills標準に準拠しています。¹³

skillの構造

my-skill/
  SKILL.md           (required: instructions)
  scripts/           (optional: executable scripts)
  references/        (optional: reference docs)
  assets/            (optional: images, icons)
  agents/openai.yaml (optional: metadata, UI, dependencies)

検出場所

Codexは、ユーザーがインストールしたskillsを $CODEX_HOME/skills（デフォルト：~/.codex/skills）に保存します。.system/ 配下の組み込みsystem skillsもここに含まれます。シンボリックリンクされたskillフォルダーにも対応しています。

skillの作成

SKILL.mdの形式：

---
name: security-audit
description: Run a thorough security audit on the codebase.
---

## Security Audit Procedure

1. Scan for hardcoded secrets using `rg -i "(api_key|password|secret|token)\s*=" --type py`
2. Check for SQL injection: look for string interpolation in queries
3. Verify input validation on all API endpoints
4. Check dependency vulnerabilities: `pip audit` or `npm audit`
5. Review authentication and authorization patterns
6. Report findings with severity levels (Critical/High/Medium/Low)

メタデータ（agents/openai.yaml）：

interface:
  display_name: "Security Audit"
  short_description: "Full codebase security review"
  icon_small: "./assets/shield.svg"
  brand_color: "#DC2626"
  default_prompt: "Run a security audit on this repository"

policy:
  allow_implicit_invocation: false    # Require explicit $skill

dependencies:
  tools:
    - type: "mcp"
      value: "snyk"
      transport: "streamable_http"
      url: "https://mcp.snyk.io/mcp"

skillsの呼び出し

• 明示的：/skills メニュー、またはプロンプト内での $skill-name の指定
• 暗黙的：Codexがタスクの説明から一致するskillsを自動検出（allow_implicit_invocation: true の場合）
• Creator：$skill-creator を使用して、新しいskillを対話形式で作成
• Installer：$skill-installer install <name> を使用して、コミュニティのskillsをインストール
• Executor提供（v0.146.0）：Codexはexecutorが提供するskillsを検出し、明示的に選択したskillsを含め、関連リソースを読み込みます¹¹⁴

コンテキストの上限により、skillカタログが切り詰められる場合があります。 v0.146.0では、コンテキストが限られている場合でも、より多くの利用可能なskillsが保持され、カタログを切り詰める必要がある場合は警告が表示されます。¹¹⁴ 以前は、大規模なskillライブラリが通知なく削減され、利用できるはずのskillが提示されないことがありました。多数のskillsで暗黙的な呼び出しを利用する場合は、この警告に注意してください。

有効化／無効化

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

skillsとslash commandsの違い

skillsのデバッグ

skillが有効にならない場合：

1. 検出を確認：TUIの /skills に表示されるか確認します
2. パスを確認：skillフォルダーが認識される場所（~/.codex/skills/、プロジェクトルート、または /etc/codex/skills/）にあることを確認します
3. enabled を確認：config.tomlで enabled = false に設定されたskillsは読み込まれません
4. 暗黙的な有効化を確認：自動検出を利用する場合は、agents/openai.yaml に allow_implicit_invocation: true が設定されていることを確認します
5. キーワードを使用：暗黙的な一致の精度を高めるには、skillの description に含まれる語句をプロンプトに加えます

実践例：デプロイ用skill

参照資料とスクリプトの連携を示す、複数ファイルで構成された完全なskillです。

deploy-skill/
  SKILL.md
  references/
    runbook.md
    rollback-checklist.md
  scripts/
    pre-deploy-check.sh
    smoke-test.sh
  agents/openai.yaml

SKILL.md：

---
name: deploy
description: Deploy the application to staging or production. Runs pre-flight checks, executes deployment, and verifies with smoke tests.
---

## Deployment Procedure

### Pre-flight
1. Run `scripts/pre-deploy-check.sh` to verify:
   - All tests pass
   - No uncommitted changes
   - Branch is up to date with remote
2. Review the runbook at `references/runbook.md` for environment-specific steps.

### Deploy
3. Execute the deployment command for the target environment.
4. Monitor logs for errors during rollout.

### Verify
5. Run `scripts/smoke-test.sh <environment-url>` to confirm critical paths.
6. If smoke tests fail, follow `references/rollback-checklist.md`.

呼び出し例：$deploy to staging または $deploy production with canary rollout

Plugins

Plugins は、skills、MCP エントリ、hooks、アプリコネクターを、単一のインストール可能なパッケージにまとめます（v0.110.0以降）。⁶⁵ v0.117.0以降、Plugins は正式な機能として扱われています。製品スコープの Plugins は起動時に自動同期され、/plugins では、検索と管理のための TUI 内ブラウザーを利用できます。⁷⁵ v0.128.0では、マーケットプレイスからのインストール、リモートバンドルのキャッシュ、リモートアンインストール用 API、Plugin に同梱された hooks、hook の有効化状態、外部エージェント設定のインポートが追加され、Plugin のワークフローが拡充されました。⁸⁶ v0.129.0（2026年5月7日）では、Plugin のワークスペース共有（再公開せずに Plugin セットをチームメイトへプッシュ）、共有アクセス制御（受信者ごとの有効化／無効化、アクセス権の取り消し）、ソースフィルタリング（ワークスペースが取得するマーケットプレイスを制限）、および CLI を使わずに /plugins ブラウザーから直接実行できるマーケットプレイス操作が追加されました。⁸⁹ v0.133.0（2026年5月21日）では、Plugin の検索結果を監査しやすくなりました。リスト出力でマーケットプレイスを識別できるようになり、インストール済みのバージョンとマーケットプレイスのルートが表示されます。また、検索結果の取得元レジストリを推測しなくても、リモートの Plugin コレクションを確認できます。⁹⁸ v0.130.0（2026年5月8日）では、Plugin のパッケージ内容がより明確になり、共有ワークフローを細かく制御できるようになりました。⁹¹

• Plugin の詳細に同梱 hooks を表示。 /plugins の詳細ビューに、Plugin に同梱されているすべてのライフサイクル hook（SessionStart、UserPromptSubmit、Stop など）が表示されるようになりました。Plugin をインストールする前に、セッションへ登録される hooks を正確に確認できます。ツールだけを見て信頼した Plugin によって、予期しない hook の副作用が生じる心配はありません。
• shareContext 内の Plugin 共有メタデータ。 ワークスペースから Plugin を共有すると、共有リンクのペイロードにリンクのメタデータ（作成者、スコープ、鮮度）が含まれるようになりました。これにより、受信側のセッションで出所を表示し、受け入れるかどうかを判断できます。
• 共有設定の検出可能性コントロール。 共有設定には検出可能性の切り替えが用意されています。組織全体の一覧に公開することなく、特定のワークスペースや受信者リストに限定して Plugins を公開できます。

v0.143.0（2026年7月8日）では、リモート Plugins がデフォルトで有効になりました。 リモート Plugins をオプトイン用フラグなしで利用できるようになり、/plugins カタログの行には、git やローカルに加えて npm マーケットプレイスのソースなど、より詳しい情報が表示されます。また、各エントリにリモート版とローカルにインストール済みの版の両方が表示されるため、バージョンのずれをひと目で確認できます。¹⁰⁶ 共通の Plugin セットをチーム標準として採用する場合、リモートがデフォルトで有効になったことで、従来は展開の障壁となっていたマシンごとの有効化作業が不要になります。

Plugin のソース

v0.147.0以降は、1回のクエリでローカル、個人、ワークスペース、リモートの各カタログを横断して Plugin を検索できます。どのカタログにあるかではなく、必要な機能を検索すればよいのです。ポータブルな Agent Plugin パッケージと組み合わせることで、ある環境で構築した Plugin を、その作成元のマシンやワークスペースに縛られることなく、別の環境へスムーズにインストールできます。¹¹⁶

Plugin の検索

Codex はセッション開始時に、有効な Plugins をモデルへ通知します（v0.111.0）。これにより、インストール済みの MCP、アプリ、skills を見つけやすくなります。⁶⁵ モデルはタスクの文脈に基づき、セッション中に関連する Plugins を提案できます。v0.117.0では、製品スコープの Plugins が起動時に同期されるため、手動で操作しなくても最新の Plugin カタログを利用できます。⁷⁵ v0.142.0以降、/plugins メニューではリモート Plugins が OpenAI Curated、ワークスペース、自分と共有のセクションに分類され、対象となるターンでは関連する Plugins をインラインで提案し、インストールできます。¹⁰⁴ v0.151.0以降、plugin/list と plugin/installed は、要求された各 cwd の有効な Plugin 設定を読み込みます。ローカルマーケットプレイスはリクエスト順に結合され、インストール状態と有効化状態はリポジトリ間で統合されます。また、無効なプロジェクト設定は、有効なローカルカタログやグローバルで有効なリモートカタログを除外することなく、marketplaceLoadErrors を通じて報告されます。¹³⁴

@plugin メンション（v0.112.0以降）

チャット内で @plugin-name を使うと、インストール済みの任意の Plugin を直接参照できます。⁶⁸ Plugin をメンションすると、そのコンテキスト（機能、ツール、設定）がモデルのコンテキストウィンドウへ自動的に追加されます。Plugin の機能を改めて説明する必要はありません。

@deploy push this branch to staging with canary rollout
@linter check for unused imports in src/

カスタム skills、MCP サーバー、アプリコネクターを含む、インストール済みのあらゆる Plugin で利用できます。

Plugin マーケットプレイス（v0.113.0以降）

Plugin マーケットプレイスでは、メタデータ、カテゴリー、評価を利用して、より詳しく検索できるようになりました。⁶⁹ インストール時の認証チェックでは、API キーまたは OAuth を必要とする Plugins に有効な認証情報が設定されているか、インストール前に検証します。アンインストール用エンドポイントを使うと、Plugins と関連設定を適切に削除できます。

サードパーティ製マーケットプレイスの追加（v0.121.0以降）

現在の OpenAI Codex ドキュメントでは、マーケットプレイスのソース管理に codex plugin marketplace を使用します。これにより、OpenAI のファーストパーティマーケットプレイスに限定されないサードパーティ製 Plugin の配布方法が正式に定義され、GitHub リポジトリの短縮表記、HTTP(S) Git URL、SSH URL、ローカルマーケットプレイスのルートディレクトリがサポートされます。Git の ref を固定するには --ref を使用し、--sparse PATH の繰り返し指定は Git ベースのマーケットプレイスリポジトリに限って使用してください。⁹³

# GitHub repository (shorthand)
codex plugin marketplace add owner/repo

# Arbitrary git URL
codex plugin marketplace add https://git.example.com/team/plugins.git

# SSH Git URL
codex plugin marketplace add git@example.com:team/plugins.git

# Local directory
codex plugin marketplace add /path/to/local/marketplace

# Upgrade or remove a configured marketplace
codex plugin marketplace upgrade <marketplace-name>
codex plugin marketplace remove <marketplace-name>

追加したマーケットプレイスの Plugins は、デフォルトの Plugins と並んで /plugins ブラウザーに表示されます。App server の呼び出し元（IDE／デスクトップ統合）では、プログラムからマーケットプレイスを登録するための同等のエンドポイントを利用できます。⁸²

セキュリティ上の注意：サードパーティ製マーケットプレイスの Plugin コードは、Codex に付与された権限で任意に実行されます。追加前にソースの信頼性を確認し、初回実行時にはサンドボックス環境の使用を推奨します。

Agent Plugins：ベンダー横断の標準（v0.146.0〜v0.147.0）

「Agent Plugins」は単なる Codex の機能名ではありません。オープンかつベンダー中立なパッケージング標準であり、2026年8月6日に Agent Plugins 1.0.0として公開されました。公式サイトでは「AI エージェントを拡張する再利用可能なコンポーネントのための、ポータブルなパッケージ形式」と説明されています。¹⁶¹ Plugin は、必須の plugin.json マニフェストを含むディレクトリです。このマニフェストは、最上位で許可されるフィールドが $schema、name、version、description、author、homepage、repository、license、keywords、extensions の10個に限定されたクローズドスキーマであり、「クライアントは未知のフィールドを1つずつ報告し、無視しなければならない」と定められています。さらに、任意の skills/ フォルダー（直下にある、SKILL.md を含む各子ディレクトリが1つの skill となります）、stdio、Streamable HTTP、または従来の HTTP+SSE サーバーを宣言する任意の mcp.json、および他のクライアントが「無視しなければならない」逆ドメイン形式の任意のクライアント名前空間ディレクトリで構成できます。規範として定める範囲はパッケージングです。この仕様は「AI エージェントを拡張する再利用可能なコンポーネントを配布可能な Plugins としてパッケージ化するための、標準 Agent Plugins Specification v1.0.0を定義する」ものであり、その下位に位置する Agent Skills と MCP には、それぞれ独自の仕様が引き続き適用されます。¹⁶¹

重要なのはガバナンスです。Vercel が提案を開始し、Amazon、Anysphere（Cursor）、GitHub、Microsoft、OpenAI と共同で1.0仕様を策定しました。仕様リポジトリのメンテナーには Amazon、Cursor、Microsoft、OpenAI、Vercel の関係者が名を連ね、Google も公開日にコアメンテナーへ加わると発表しています。¹⁶¹ 発表時に対応クライアントとして挙げられたのは、ChatGPT、Codex、Cursor、GitHub Copilot、Kiro、VS Code です。目立つ不在者もいます。基盤となる Agent Skills 形式と MCP 自体を作成した Anthropic は、メンテナーに含まれていません。Claude Code は独自の Plugin 形式を維持しており、Codex 側では Claude Code マーケットプレイスソース（v0.146.0）と /import によって、その隔たりを埋めています。¹⁶¹

Codex の観点では、v0.146.0で Agent Plugins のマニフェスト、ワークスペースへの Plugin 公開、さらに Amazon Bedrock と Claude Code という2つの Plugin マーケットプレイスが追加されました。¹¹⁴ v0.147.0では、ポータブルな Agent Plugins のインストールと、ローカル、個人、ワークスペース、リモートの各カタログを横断する検索が加わり、一連の機能が完成しました。¹¹⁶ チームにとって運用上特に便利なのは、ワークスペースへの公開です。公開マーケットプレイスを立ち上げたり、各開発者に Git ソースを手動で追加してもらったりせず、自分たちのワークスペースへ Plugins を公開できます。

リリースノートでは Codex 上の機能について発表されていますが、設定キーや CLI 構文は公開されていません。ここでは、この機能が追加されたことと標準の仕様を記録するにとどめ、Codex からの操作方法は扱いません。OpenAI のドキュメントで説明されるまでは、マニフェストの作成ワークフローと codex plugin publish の呼び出しはいずれも未検証として扱ってください。

Plugins の管理

codex plugin marketplace add <src>       # Add a marketplace source
codex plugin marketplace upgrade [name]  # Upgrade one marketplace or all
codex plugin marketplace remove <name>   # Remove a configured marketplace
codex plugin list                        # List plugins; includes remote catalog entries (v0.153.0)
codex plugin list --json                 # JSON adds source, version, install + auth policy (v0.153.0)

v0.153.0では、Plugin の CLI がマーケットプレイス管理から、リモートマーケットプレイスに対する Plugin 単位の操作へと拡張されました。codex plugin list にはリモートカタログのエントリが含まれ、JSON 出力にはソース、バージョン、インストールポリシー、認証ポリシーが表示されます。また、既存の Plugin CLI を使って、リモート Plugins を追加および削除できます。リモートカタログはスコープとコレクションごとにキャッシュされ、新しいキャッシュ結果が優先されます。キャッシュ内で Plugin が見つからない追加リクエストでは、1回だけ再取得されます。さらに、フィルタリングされていないリモート一覧の取得に失敗しても、ローカルのキュレーション済みカタログは保持されます。ただし、明示的に選択したリモートマーケットプレイスのエラーは引き続き表示されます。¹⁴⁰

TUI では、/plugins（v0.117.0以降）を使用すると、セッションを離れることなく、個々の Plugins を対話形式で参照、インストール、削除できます。⁷⁵

上級者向けのヒント：Plugins を使えば、以前は個別に必要だった MCP の設定、skill のインストール、アプリコネクターのセットアップを1つにまとめられます。1つの Plugin に3つすべてを同梱できるため、チームへの導入が速くなり、設定の移植性も高まります。

Plan Mode とコラボレーション

Plan mode を使うと、Codex は変更を実行する前にアプローチを設計できます。v0.94.0 以降、デフォルトで有効です。¹⁴「Plan Mode と直接実行」の判断ツリーについては、判断フレームワークをご覧ください。

Plan mode と update_plan ツール（v0.152.0）の違い： この2つは別のもので、デフォルトで有効なのは片方だけです。Plan mode は、このセクションで説明する、Codex が実行前に提案を行うコラボレーションモードです。v0.94.0 以降デフォルトで有効になっており、この点に変更はありません。一方、update_plan は、モデルがターン内で構造化された計画を管理するために呼び出せる計画用のツールです。v0.152.0 ではオプトインとして導入され、tools.update_plan.enabled のデフォルト値は false です。無効になっている間、Codex はモデル、コラボレーションモード、multi-agent、compaction、prewarm、goal-continuation の各プロンプトから、同梱の update_plan ガイダンスも除外します（計画に言及している場合でも、カスタム基本指示、モデルカタログの指示、コラボレーションポリシー、ユーザーの目標テキストは保持されます）。有効にするには、config.toml で tools.update_plan.enabled = true を明示的に設定してください。¹³⁸

Plan Mode の開始

/plan                              # Switch to plan mode
/plan "redesign the API layer"     # Plan mode with initial prompt

Plan mode では、Codex は次のように動作します。 - ファイルを読み取り、コードベースを分析します - 実装計画を提案します - 承認されるまで変更を加えません - 専用の TUI ビューに計画をストリーミング表示します

Steer Mode

Steer mode（v0.98.0 以降デフォルトで有効）では、Codex が作業中でも、現在のタスクを中断せずに新しい指示を追加できます。¹⁴

指示を追加する方法は2つあります。

実用例：

# Codex is refactoring the auth module...

[Enter] "Use bcrypt instead of argon2 — we already have it as a dependency"
→ Codex adjusts immediately, mid-turn

[Tab] "Once auth is done, update the migration script too"
→ Codex finishes auth refactor, then starts the migration

Steer mode は TUI で常に有効です。Codex の完了を待ってから指示したい場合は、ターンの終了後に通常どおり入力するだけで構いません。特別なモードは必要ありません。

TUI の機能強化（v0.105.0～v0.106.0）

構文ハイライト（v0.105.0）： TUI では、フェンスで囲まれたコードブロックと diff がインラインで構文ハイライトされるようになりました。配色は /theme で選択できます。⁶¹

新しい TUI コマンド（v0.105.0以降）：⁶¹

音声文字起こし（v0.105.0、実験的機能）： スペースキーを押すと、音声文字起こしを使ってプロンプトを入力できます。この機能は実験段階にあり、マイクの使用許可が必要になる場合があります。⁶¹ v0.107.0 以降、リアルタイム音声セッションではマイクとスピーカーのデバイスを選択でき、使用する音声入出力ハードウェアを指定できます。⁶² v0.140.0 で削除され、v0.145.0 で復活： 実験的な /realtime 音声コントロールと関連する音声依存関係は、v0.140.0 で TUI から削除されました（スペースキーによる音声文字起こしには影響ありませんでした）。¹⁰² v0.145.0 では、新たな形で音声機能が復活しています。一般的なローカル音声形式による音声入力と音声ツール出力に加え、ストリーミング方式のリアルタイム V3 会話が導入されました。¹¹² v0.155.0 と v0.156.0：ライブ音声会話。 v0.155.0（2026年9月17日）では、実験的なオプトイン機能として /voice が追加されました。対応ビルドの /experimental から有効にでき、ストリーミング文字起こしとマイク操作を備えたライブ会話を利用できます（#43581、#43651、#44331）。ミュート用ショートカットを設定できるほか（#43690）、macOS パッケージには署名済みの音声リソースが含まれています（#43983）。v0.156.0（2026年9月22日）では安定版となり、デフォルトで有効になりました（#44921）。同日、ドキュメントの変更履歴でも「音声会話はデフォルトで有効になり、F8 による切り替え、/voice settings ピッカー、Linux および Windows 向けの同梱音声ランタイムを利用できます」と発表されました。無効にするには、config.toml の [features] で realtime_conversation = false を設定してください。CLI の slash-command 参照には、現在も /voice が掲載されていません。また、ドキュメントの音声機能ページで扱われているのはデスクトップアプリの ChatGPT Voice であり、別の機能です。¹⁵⁶¹⁶⁹

その他の改善点： - 長いリンクが TUI の行をまたいで折り返されても、クリック可能な状態を維持するようになりました（v0.105.0）⁶¹ - ローカルファイルのリンク表示が改善されました（v0.106.0）⁶⁰ - TUI の Markdown では OSC 8 メタデータによってウェブリンクをクリック可能な状態に保ち、表示領域が狭いテーブルは、リンク先を失うことなく読みやすいキー／値形式に切り替わります（v0.136.0）¹⁶⁸ - 対応ターミナルでは Markdown リンクがクリック可能なラベルとして表示され、それ以外では URL が引き続き表示されます（v0.150.0）¹³² - sub-agents に対する Ctrl+C の処理が修正され、子プロセスを適切に終了できるようになりました（v0.106.0）⁶⁰

Memory System

Codex には、セッションをまたいで事実、設定、プロジェクトのコンテキストを保存する永続的な Memory System（v0.100.0以降）があります。²⁴

Memory コマンド

memory は ~/.codex/memory/ 内の Markdown ファイルに保存されます。Codex はセッション開始時にこれらを読み込み、以後のすべてのセッションで動作を調整するために使用します。

保存に適した内容

memory は、継続的に使う設定やプロジェクトの事実を保存するのに最適です。

• プロジェクトの規約：「このプロジェクトではスペースではなくタブを使用する」または「API の応答には常に meta フィールドを含める」
• ツールの設定：「npm ではなく pnpm を使用する」または「pytest -x --tb=short でテストを実行する」
• アーキテクチャ上の決定：「認証モジュールは src/middleware/ ではなく src/core/auth/ にある」
• ワークフローの設定：「diff を表示する前に必ずリンターを実行する」

パイプラインでの Memory

codex exec の実行時には、memory が自動的に読み込まれます。そのため、CI/CD パイプラインやスクリプトでも対話型セッションと同じコンテキストを利用でき、呼び出すたびに指示を繰り返す必要はありません。

Memory の改良（v0.101.0～v0.107.0）

• 機密情報の除去：memory はディスクに書き込まれる前に自動的にスキャンされ、機密情報がないか確認されます
• CWD の認識：プロジェクト固有の内容を想起できるよう、memory ファイルに作業ディレクトリのコンテキストが含まれるようになりました
• 開発者メッセージの除外：フェーズ1の memory 入力から開発者／システムメッセージを除外し、ユーザーとのやり取りに焦点を当てることで memory の品質を高めます
• diff ベースの忘却（v0.106.0）：diff ベースの忘却によって古くなった事実を削除し、保存される memory を長期的に簡潔で関連性の高い状態に保つようになりました⁶⁰
• 使用状況を考慮した選択（v0.106.0）：memory の取得時に使用状況が考慮され、頻繁に参照されるものや、最近の状況との関連性が高いものが優先されるようになりました⁶⁰
• 設定可能な memory（v0.107.0）：memory を全面的に設定できるようになりました。保存された memory をすべてリセットして白紙の状態に戻すには、codex debug clear-memories を使用します。関連性のないプロジェクトへ切り替える場合や、memory の状態が実態からずれた場合に便利です⁶²
• フェーズ2モデルのアップグレード（v0.121.0）：フェーズ2の memory 統合モデルが、以前のデフォルトから gpt-5.4 に更新されました。フェーズ2のパイプラインはセッション間に実行され、フェーズ1のトランスクリプトから長期保存する事実を抽出します。このモデル変更により、トークンコストを変えずに想起の品質が向上します。⁸²
• TUI の memories メニュー（v0.121.0）：セッション内の新しい UI から、memory モード、個別の memory の削除、リセットボタンを操作できるようになりました。memory をリセットしても、過去の rollouts は無効化されず、保持されるようになりました。そのため、今後想起される内容を消去しても、セッションの再生は損なわれません。⁸²

Memory と AGENTS.md の違い

ヒント：無期限に保持したい事実には /m_update を使用してください。セッション固有のコンテキストは、会話の中で Codex に直接伝えるだけで構いません。チームで共有するコンテキストには、AGENTS.md を使用してください。

セッション管理

Codex はセッションを ~/.codex/sessions/ に保存するため、CLI とデスクトップ環境の間で、再開、フォーク、マルチスレッドのワークフローを利用できます。

v0.146.0 では、スレッドを名前で指定できるようになりました。 /new と /clear にセッション名を指定でき、重要なスレッドをピン留めできます。また、別の会話に移るために現在の会話を閉じる必要がなくなり、サイド会話を開いたままにできます。¹¹⁴ 実際のところ、長期間続くプロジェクトが、日付を手がかりに見分けなければならないタイムスタンプの一覧ではなくなります。v0.147.0 では会話セクションが追加されました。会話を永続的なセクションに整理して手動で並べ替えられるほか、長いトランスクリプトも全体を一度に読み込まず、段階的に閲覧できます。¹¹⁶ v0.148.0 では /export とコマンドラインでのフォークが追加されました。/export は会話全体を Markdown としてクリップボードまたは新しいファイルに出力し、codex exec fork はセッションを非対話形式でフォークします。さらに、再開ピッカーからセッションをアーカイブおよび復元できます。¹¹⁸ v0.149.0 では codex queue が追加されました。コマンドラインから既存のローカルまたはリモートセッションへメッセージを送信できます。また、再開またはフォークしたスレッドで、有効な権限プロファイルが復元されるよう修正されました。¹²⁰ v0.150.0 ではタイトルが自動生成されるようになりました。名前のないターミナルタスクには内容を表すタイトルが自動的に付けられ、/rename では会話に基づく編集可能なタイトルが提案されます。¹³² v0.151.0 では /recap が追加されました。会話の直近の進捗と次のステップを短くまとめた要約を、必要なときにリクエストできます。また、対象となるアイドル状態かつフォーカスされていない会話には、Codex が同じ要約を自動生成してトランスクリプトに追加します。リクエストは範囲と処理環境が分離され、再試行は自動生成に失敗した場合に限られます。¹³⁵ v0.153.0 では、自動生成を無効にできるようになりました。tui.auto_recap = false を設定すると、スケジュール済みの自動要約チェックがキャンセルされ、保留中の自動生成結果も破棄されますが、手動の /recap は引き続き利用できます。¹⁴⁰

codex agents（v0.149.0） は、マシン上で実行中のすべてのエージェントセッションを管理するための対話型ダッシュボードです。1つの画面からタスクの検索、開始、表示、名前変更、停止を行え、ショートカットも設定できます。セッション内では、/agents ですべての実行中のエージェントセッションを切り替え、/subagents で現在のセッションに属するサブエージェントを切り替えます。¹²⁰¹²⁹ v0.150.0 では、会話からタスクを指定できるようになりました。@ メンションで別の Codex タスクを参照し、ターミナルからエージェントにタスクの読み取り、作成、またはメッセージ送信を依頼できます。¹³²

再開

前回の続きから再開します。

codex resume                          # Interactive picker (sorted by recency)
codex resume <SESSION_ID>             # Resume a specific session
codex exec resume --last "continue"   # Non-interactive: resume most recent

TUI 内の /resume slash command でも、検索機能を備えた同じ対話型ピッカーが開きます。

ページネーション対応のスレッド履歴（v0.145.0、v0.151.0 で正式採用）： ページネーション対応のスレッド履歴により、効率的な再開、履歴全体の検索、永続化されたスレッド名、サブエージェント対応、メモリ機能がセッション管理に加わります。履歴は一度にすべて読み込むのではなく、ページ単位で読み込まれます。数百件のセッションが存在する、長期間使用されている作業ディレクトリでは特に重要です。v0.145.0 で実験的機能として導入され、v0.151.0 では APIs が実験的機能から正式採用へ移行しました（thread/turns/list、thread/items/list、thread/revert で実験的な API 機能が不要になりました）。また、ストアが thread/turns/list と thread/items/list に対応し、かつ thread/start で historyMode が省略されている永続スレッドに限り、解決後のデフォルトがページネーション方式になります。エフェメラルスレッドと、これらの APIs に対応していないストアを使用するスレッドでは、引き続き従来方式がデフォルトです。明示的な選択の動作も変わりません。また、タグ rust-v0.151.0 の時点で、プロトコルレベルの ThreadHistoryMode enum は引き続き Legacy がデフォルトです（protocol.rs:755-758）。つまり、対応する永続スレッドに対する解決後のデフォルトであり、一律の切り替えではありません。¹¹²¹³⁵

フォーク

現在の進捗を失わずに別の選択肢を検討できるよう、会話を分岐します。

/fork                              # Fork current conversation
/fork "try a different approach"   # Fork with new prompt

フォークすると、フォーク地点までの履歴を共有する独立したスレッドが作成されます。v0.146.0 以降、フォーク履歴はページネーションに対応し、フォークを一時的なものとして作成できます。一時フォークはスレッド一覧に表示されないため、実際に操作するスレッド一覧に使い捨ての実験が混ざりません。¹¹⁴ 一方のフォークで行った変更が、もう一方に影響することはありません。アプローチを比較したり（例：「フォークして Memcached の代わりに Redis を試す」）、リスクの高い変更を安全に検討したりする際に役立ちます。

サブエージェントへのスレッドのフォーク（v0.107.0）： スレッドを独立したサブエージェントとしてフォークできるようになり、会話から自律的に実行される並行作業ストリームを生成できます。これは既存のフォークモデルを拡張したものです。単に会話を分岐するだけでなく、フォークされたスレッドが固有の実行コンテキストを持つサブエージェントになります。⁶² v0.117.0 以降、サブエージェントはパスベースのアドレス（例：/root/agent_a）と構造化されたエージェント間メッセージングを使用するため、マルチエージェントの連携がより明示的になり、デバッグもしやすくなりました。⁷⁵

暗号化されたエージェント間メッセージ（v0.138.0 以降）： Multi-agent v2 では、親エージェントがサブエージェントを生成したり、メッセージを送信したりする際のタスクテキストが暗号化されます。spawn_agent、send_message、followup_task のメッセージパラメーターには暗号化の指定があります。親モデルがツール呼び出しを生成すると Responses API がペイロードを暗号化し、ローカルで実行中の Codex は暗号文のみを保持します（InterAgentCommunication.encrypted_content に格納され、平文コンテンツは空になります）。その後、受信側モデルへ渡す際に API がサーバー側で復号します。¹⁰⁸ 実用上、次の3つの影響があります。

• ローカルのセッションログには、委任内容の平文が記録されなくなりました。 親エージェントがサブエージェントを生成したことや、その応答は確認できますが、送信された指示の正確な内容は確認できません。セッション履歴からマルチエージェントの実行を監査またはデバッグする場合、その記録は残っていません。この問題を追跡している未解決のリグレッションIssueには、2026年7月中旬時点で修正がリンクされていません。¹⁰⁹ 何が起きたかを再構築する手がかりとしては、拡張機能のライフサイクルイベント（サブエージェントの開始と停止、ツールの実行、ターンのメタデータ — v0.133.0 以降）と app-server の可観測性が残されています。⁹⁸
• カスタムプロバイダーのモデルでは動作しない場合があります。 暗号化されたツールの使用が設定されていないモデルエンドポイントは、暗号化された spawn_agent スキーマを 400 エラー（"declares encrypted parameters but is not configured for encrypted tool use"）で拒否します。カスタムプロバイダーでマルチエージェントの委任がこのエラーによって失敗する場合、原因は設定ではなく、この暗号化の変更です。¹⁰⁹
• Codex が生成する通知は引き続き読めます。 子エージェントの完了通知は Codex 自体が生成するため、平文のままです。また、シリアライズされた JSON エンベロープではなく、型付きの agent_message 項目として表示されるようになりました。¹⁰⁸

OpenAI は、この変更の背景にある脅威モデルを公開していません。PR では暗号文の処理フローを説明していますが、何から保護するためのものかは明記されていません。

Multi-agent v2 の安定化（v0.145.0、オプトイン）： v0.137.0 で登場し、v0.138.0 で委任の暗号化が加わった Multi-agent v2 は、オプトイン機能として安定版になりました。v0.145.0 では、サブエージェントのモデル、サブエージェントごとの推論レベル、同時実行数を設定できるようになり、マルチエージェントのロールが復元されたほか、エージェント間の移動も改善されています。v0.137/v0.138 の調整期間を理由に v2 の利用を見送っていた場合、設定インターフェースが安定したのはこのリリースです。サブエージェントのモデルと推論の選択はランタイムで固定されるのではなく、設定で指定できるようになりました。¹¹²

スレッド一覧

実行中のセッションを表示および管理します。

/status                            # Current session info and token usage
/ps                                # Show background terminals in session

デスクトップアプリでは、スレッドがサイドバーに表示され、履歴全体と差分のプレビューを確認できます。

セッションのライフサイクル

セッションは CLI とデスクトップアプリの間で同期されるため、一方で開始し、もう一方で続きを進められます。

非対話モード（codex exec）

codex exec は、スクリプト、CI/CD、自動化のために Codex を非対話形式で実行します。¹⁵

基本的な使い方

codex exec "summarize the repository structure"
codex exec --sandbox workspace-write -c approval_policy=on-request "fix the CI failure"   # exec has no -a flag; set the policy via -c or config
codex exec --json "triage open bugs" -o result.txt

デフォルトでは、codex exec は進捗やイベントを stderr に、エージェントの最終メッセージを stdout に出力します。標準的な Unix パイプラインと組み合わせやすい設計です。

セッションのアーカイブ（v0.136.0）

履歴を削除せず、再開／フォークの一覧を整理するためにセッションをアーカイブできます。TUI では /archive、シェルでは次のようにアーカイブします。¹⁶⁸

codex archive <session-id>     # archive a session
codex unarchive <session-id>   # restore it

アーカイブしたセッションは、アーカイブを解除するまで再開やフォークの対象になりません。終了させるつもりだったセッションを誤って続行するのを防ぐガードレールです。同じリリースでは、codex app-server --stdio により、エディターやホストとの統合に向けて app-server を stdio モードで起動できるようになりました。また、コマンドの安全性を確保する修正として、/diff からリポジトリ提供の Git ヘルパーを実行できなくなりました。Windows では、管理者向けのアルファ版プロビジョニング手段として codex sandbox setup --elevated が追加されています。¹⁶⁸

JSON Lines 出力

--json を指定すると、stdout は JSONL イベントストリームになります。

codex exec --json "fix the tests" | jq

イベントの種類：thread.started、turn.started/completed/failed、item.started/completed、error

{"type":"thread.started","thread_id":"019c5c94-..."}
{"type":"turn.started"}
{"type":"item.started","item":{"id":"item_1","type":"command_execution","status":"in_progress"}}
{"type":"item.completed","item":{"id":"item_3","type":"agent_message","text":"..."}}
{"type":"turn.completed","usage":{"input_tokens":24763,"cached_input_tokens":24448,"output_tokens":122}}

構造化出力

JSON Schema を使用して、レスポンスの形式を強制します。

codex exec "Extract project metadata" \
  --output-schema ./schema.json \
  -o ./project-metadata.json

-o / --output-last-message は、最終メッセージをファイルに書き込みます。

セッションの再開とレビュー

codex exec resume --last "continue where you left off"
codex exec resume <SESSION_ID> "fix the remaining issues"
codex exec review --base main           # Code review against a branch

主なフラグ

CI 認証

codex exec は、自動化環境での非対話認証に CODEX_API_KEY を使用できます。

codex exec の起動バナー（v0.130.0）。 codex exec の起動バナーには、従来の「research preview」という文言が表示されなくなりました。CI で起動時の出力を解析している場合、バナーのテキストが簡潔になっている点に注意してください。構造化された --json イベントに変更はありません。⁹¹

codex remote-control（v0.130.0 以降）

codex remote-control は、別のプロセス（IDE 拡張機能、カスタムオーケストレーター、リモート制御プレーンなど）から操作することを想定した、ヘッドレス app-server を起動するトップレベルコマンドです。多くのインテグレーターが複数のフラグを手作業で組み合わせていた codex app-server の呼び出しに代わり、デスクトップや IDE のインターフェースで提供されるものと同じ app-server ランタイムに、サードパーティ製ツールからアクセスできる単一の安定したエントリーポイントを提供します。⁹¹ v0.133.0 ではコマンドの実行形態が改善され、フォアグラウンドコマンドとして実行し、準備完了を待機して、マシンの状態を報告できるようになりました。さらに、長時間稼働するコントローラー構成向けに、明示的なデーモン形式の start / stop コマンドも引き続き利用できます。⁹⁸ v0.143.0 では codex remote-control pair が追加されました。 実行中のデーモンから手動ペアリングコードを生成するため、自動検出ハンドシェイクを使わずにコントローラーを接続できます。制御プロセスとデーモンが異なるホストやネットワークセグメントにある場合に便利です。¹⁰⁶

# Start a headless, remotely controllable app-server
codex remote-control

# Generate a manual pairing code for an out-of-band controller (v0.143.0+)
codex remote-control pair

# Same lifecycle as a TUI session: thread store, hooks, plugins, MCP, sandbox
# all initialize from your normal config.toml.

すべてのターンを一度にメモリへ読み込まず、大量のスレッド履歴を列挙する必要がある UI を構築する場合は、codex remote-control と以下の app-server ページネーション APIs を組み合わせてください。

App-Server のスレッドページネーション（v0.130.0 以降）

app-server クライアントでは、3種類のターン項目ビューを使用して、大規模なスレッドをページ単位で取得できるようになりました。⁹¹

v0.121.0 で導入された ThreadStore インターフェースとページネーションを組み合わせることで、長時間実行されるスレッドを効率よくたどれます。特に、オーケストレーターとロールアウトファイルが別のマシンに置かれる可能性があるリモート制御環境で有効です。⁸² v0.143.0 では、コントローラーが調査できる範囲が広がりました。 app-server クライアントで、利用可能な環境の列挙、スレッドの子孫スレッドの一覧表示、特定のターンを起点とした履歴のフォークが可能になりました。これらは、履歴を先頭から再実行せず、以前の時点から実行を分岐させる UI に必要な基本機能です。¹⁰⁶ v0.151.0 では、ページネーション対応のスレッド履歴 APIs が実験段階を終了しました。 対応するストアを使用する永続スレッドでは、thread/start で historyMode を省略すると、デフォルトでページネーション対応履歴が使用されます（エフェメラルスレッドと非対応ストアでは従来方式が維持されます）。また、ページネーション対応スレッドでの全履歴の読み込みは非推奨となりました（#40676）。¹³⁵

App-Server 設定のライブ更新（v0.130.0 以降）

実行中の app-server スレッドは、再起動しなくても config.toml の変更を反映できるようになりました。設定を編集して保存すると、実行中のスレッドでは次のターンから新しい値が反映されます。これは codex remote-control と対になるバグ修正であり、長時間稼働するヘッドレスサーバーを停止せず、その場で再設定できます。⁹¹

ターン単位のライブ設定（v0.151.0）： 実行中のターンの設定を、処理の途中でも変更できるようになりました。実験的な app-server メソッド turn/settings/update は、特定の実行中ターンにおける後続ステップの model、effort、summary、serviceTier を更新します。将来のターンには影響しません。また、更新が適用されたか、拒否されたか、対象を見失ったかを報告します。更新後の設定スナップショットが公開される前に、管理対象の制約が再検証され、そのターンですでに許可された承認および Guardian の安全性プロパティも維持されます。turn/start では serviceTierForTurn も指定できるため、スレッドに保存されたサービスティアを変更せず、新しい1ターンだけサービスティアを上書きできます（"default" は標準速度を意味し、省略または null の場合はスレッドのティアを継承します）。¹³⁵

暗号化されたリモートエグゼキューター（v0.141.0）

v0.141.0（安定版、2026年6月18日）以降、リモートエグゼキューターは、認証済みのエンドツーエンド暗号化 Noise リレーチャネルを介して接続します。制御プレーンとエグゼキューターは、その間にあるリレーを信頼する必要がなくなりました。オーケストレーターがネットワーク境界を越えて app-server を操作する場合に重要です。同じリリースでは、クロスプラットフォームのリモート実行で、エグゼキューター固有の作業ディレクトリとシェルが維持されるようになりました。これにより、ある OS 上のコントローラーから別の OS 上のエグゼキューターを操作しても、パスやシェルのセマンティクスが意図せず書き換えられることはありません。また、エンタープライズプロキシとの互換性を確保するため、TLS で P-521 証明書署名も受け入れられるようになりました。¹⁰³

Codex Cloudとバックグラウンドタスク [EXPERIMENTAL]

GitLabサポート（ベータ版、2026年8月19日）： Codex cloudでは、すべてのChatGPTプランでGitLabプロジェクトに接続できるようになりました。プロジェクトをリンクし、環境を作成して、issueやマージリクエストからタスクを開始したり、レビューを依頼したりできます。Self-Managed GitLabには19.0以降が必要です。¹¹⁹

ステータス：Codex Cloudは実験的な機能です。インターフェース、料金、利用可能状況は変更される場合があります。クラウド環境はOpenAIが管理するため、インフラストラクチャを制御することはできません。

Codex Cloudは、OpenAIが管理する環境でタスクを非同期に実行します。⁴ CLI v0.150.0以降、ターミナル上の会話からもタスクを操作できます。@メンションで他のCodexタスクを参照し、エージェントにタスクの読み取り、作成、メッセージ送信を依頼できます。¹³² CodexをCIパイプラインに統合する方法については、GitHub ActionとCI/CDもご覧ください。

クラウドタスクの認証情報を強化（v0.152.0）： クラウドタスクのリクエストには保存済みのChatGPT認証情報が含まれる可能性があるため、認証情報を読み込む前の段階で送信先が制限されるようになりました。CODEX_CLOUD_TASKS_BASE_URLは、ポート443上の信頼できるChatGPT HTTPSオリジンに対して検証されます（ユーザー情報、クエリ、フラグメントを含むURLは拒否されます）。また、認証情報がリダイレクト先へ転送されないよう、クラウドタスクのバックエンドと環境検出クライアントではリダイレクトが無効化されています。¹³⁸

仕組み

1. タスクを送信します（chatgpt.com/codex、Slack連携、またはCLIから）
2. Codexがリポジトリを隔離されたクラウドサンドボックスへクローンします
3. エージェントが独立して作業します。コードを読み、テストを実行し、変更を加えます
4. 完了すると、CodexがPRを作成するか、レビュー用のdiffを提供します
5. codex apply <TASK_ID>で結果をローカルに適用します

クラウドでのインターネットアクセス

エージェントのインターネットアクセスはデフォルトでオフになっており、環境ごとに設定します。

• オフ：エージェントはインターネットにアクセスできません（デフォルト）
• オン：任意のドメイン許可リストとHTTPメソッドの制限を設定できます

Allowed domains: pypi.org, npmjs.com, github.com
Allowed methods: GET, HEAD, OPTIONS

エージェントのインターネットアクセスがオフでも、セットアップスクリプトはインターネットを使用して依存関係をインストールできます。

Slack連携

Slackのチャンネルまたはスレッドで@Codexにメンションすると、クラウドタスクを開始できます。

前提条件： 1. 対象となるChatGPTプラン（Plus、Pro、Business、Enterprise、またはEdu） 2. 接続済みのGitHubアカウント 3. 設定済みのクラウド環境が1つ以上 4. ワークスペースにSlackアプリがインストールされていること

Codexはタスクへのリンクを返信し、完了すると結果を投稿します。

Cloud CLI

codex cloud exec --env <ENV_ID> "Fix failing tests"  # Start a cloud task
codex cloud status <TASK_ID>                          # Check task progress
codex cloud diff <TASK_ID>                            # View task diff
codex cloud list                                      # List recent tasks
codex cloud list --json                               # JSON output
codex cloud apply <TASK_ID>                           # Apply from cloud subcommand
codex apply <TASK_ID>                                 # Apply diff (top-level shortcut)

Codex Desktop App

Codex Desktop App（macOS および Windows）は、複数のプロジェクト管理に最適化されたグラフィカルインターフェースを提供します。¹⁶ Windows 版は、PowerShell のネイティブサポートと Windows ネイティブのサンドボックスを備え、2026年3月4日にリリースされました。⁶⁶

インストール

codex app                      # Auto-downloads and installs on first run

または直接ダウンロード：Codex.dmg（macOS）| Microsoft Store で入手可能（Windows）

主な機能

Appshots、ブラウザコメント、Computer Use

5月21日のアプリアップデートにより、Desktop App は単なるスレッド管理ツールではなく、より強力なコンテキスト取得手段になりました。Codex が処理を実行する前に別の Mac アプリの状態を必要とする場合は、Appshots を使用します。Codex は最前面のウィンドウと、アプリが公開している表示中／画面外の取得可能なテキストをキャプチャし、添付ファイルをセッション履歴へローカルに保存します。⁹⁹

Web やフロントエンドの作業では、未認証のページであれば、まずアプリ内ブラウザを使用します。Codex と共有できるレンダリング済みプレビューが表示され、クリック、スクリーンショット、アセットのダウンロード、読み取り専用の検査 JavaScript などのブラウザ操作に対応しています。また、ページ上の領域にコメントを付け、次のターンで Codex に対応させることもできます。⁹⁹ ログインが必要なサイトでは、引き続きブラウザ拡張機能（Chrome、Edge、Brave、Opera、Vivaldi。Opera ではサイドチャットを利用できません）を使用してください。サイトツール（WebMCP、2026年8月25日）：Desktop App の組み込みブラウザでは、ChatGPT Work と Codex が Web サイトから提供されるツールを使ってページを操作できます。最新の Desktop App で GPT-5.6 Sol または GPT-5.6 Terra を使用してください。サイトツールは GPT-5.6 Luna、Enterprise ワークスペース、Edu ワークスペースでは利用できません。¹²⁷

Computer Use は、構造化された連携機能やブラウザプレビューでタスクを検証できない場合にのみ使用します。許可された Mac アプリの確認と操作が可能ですが、ファイル編集やシェルコマンドには Codex の承認ルールとサンドボックスルールが適用されます。また、ロック中の使用は限定的です。Mac のロック後、信頼済みのアクティブな Computer Use ターンの間のみ、許可されたアプリへ Codex が一時的にアクセスできます。再ロックの保護機能とローカル入力の検出機能も備えています。⁹⁹

スレッドモード

各スレッドは、作成時に選択した3つのモードのいずれかで実行されます。

Worktree の分離メカニズム：

Worktree スレッドを開始すると、Desktop App は次の処理を行います。 1. 一時ディレクトリに新しい git worktree（git worktree add）を作成します 2. 現在の HEAD から新しいブランチをチェックアウトします 3. worktree 内でエージェントを実行します — すべてのファイル変更が分離されます 4. 完了後に差分レビューを表示します — どの変更を元へマージするかを選択できます

このため、同じリポジトリ上で複数の Worktree スレッドを競合なく同時に実行できます。それぞれに独自のブランチと作業ディレクトリが割り当てられます。

Worktree の設定とスレッド所有権（v0.151.0）： 管理対象 worktree の動作は、専用の設定パーサーによって既存の [desktop] 設定から解決されます。worktree のルートはデフォルトで $CODEX_HOME/worktrees、自動クリーンアップはデフォルトで有効、保持される worktree は15個です。設定されたルート、クリーンアップフラグ、保持数は使用前に検証されます。管理対象のリンク済み worktree には、スレッドとの関連付けを記録する、バージョン管理された codex-thread.json 所有権レコードを Git メタデータ内に保持することもできます。書き込みはアトミックかつ上書き禁止です（同じ関連付けの繰り返しは冪等であり、所有者が競合する場合は拒否されます）。また、所有権メタデータに触れる前に、プライマリ、ネストされたチェックアウト、管理対象外のチェックアウトは拒否されます。¹³⁵

管理対象 worktree が v0.154.0 で CLI に対応（実験的機能）： 起動時の --worktree または TUI の /worktree により、新規またはフォークされたセッション用の分離チェックアウトを作成できます。codex exec は自動化向けの管理対象 worktree に対応し、TUI のセッションコマンドと worktree ブラウザでは、worktree セッションの一覧表示、閲覧、再開が可能です（#42196、#42366、#42652、#43069、#43120、#43286）。v0.155.0 では、worktree をデフォルトで無効のまま維持しつつ、関連する管理機能が追加されました： エージェントの概要画面から worktree セッションを非表示、アーカイブ、削除でき、所有権の詳細も表示されます。また、変更のない管理対象 worktree を削除する際には確認を求められます（#43942、#44424、#44433）。9月11日にマージされたデフォルト有効化の変更（#44870）は、rust-v0.155.0 タグとの祖先関係を確認した結果、安定版 0.155.0 には含まれていませんでした。¹⁵²¹⁵⁶

v0.156.0 では管理対象 worktree がデフォルトになります： #44870 により worktrees が安定版機能へ昇格し、デフォルトで有効化され、/experimental から削除されました。併せて、worktree セッションは独自のデーモンを起動する代わりに既存のローカルデーモンへ接続できるようになり（#46498）、エージェントの概要画面から直接作成することも可能になりました（#45276）。この画面にはステータスフィルターのタブも追加されています（#46839）。worktree は明示的に要求しない限り無効であるという前提でスクリプトや設定を作成している場合、0.156.0 でその動作が変わります。無効にするには： config.toml の [features] で worktrees = false を設定します（実行ごとに無効化する場合は --disable worktrees）。古いローカルデーモン： 「The local Codex service cannot check background terminals」というメッセージで worktree の作成や /cd がブロックされる場合は、codex app-server daemon update を実行して Codex を再起動してください。¹⁶⁹¹⁷¹

自動化

自動化はアプリ内でローカル実行されるため、アプリが起動しており、プロジェクトがディスク上で利用可能でなければなりません。

• Git リポジトリでは、自動化に専用のバックグラウンド worktree を使用します（作業ディレクトリから分離されます）
• Git を使用していないプロジェクトでは、プロジェクトディレクトリ内で直接実行されます
• 自動化には、デフォルトのサンドボックス設定が適用されます

自動化の設定方法： 1. Desktop App でプロジェクトを開きます 2. サイドバーの Automations タブをクリックします 3. トリガー（スケジュール、Webhook、手動）を定義します 4. プロンプトを記述し、実行モード（Local または Worktree）を選択します 5. 自動化の実行に使用する推論レベルを設定します（App v26.312）⁷² 6. 自動化がスケジュールどおりに実行され、結果がレビュー待ちキューに追加されます

使用例： - Issue のトリアージ：新しい Issue を自動的に分類し、優先順位を付けます - CI の監視：ビルドの失敗を監視し、修正案を提示します - アラート対応：監視アラートに反応し、診断分析を行います - 依存関係の更新：セキュリティパッチを確認して適用します

結果は、人による承認を受けるためのレビュー待ちキューに表示されます。

Windows のサポート

Codex Desktop App は、PowerShell のネイティブサポートと Windows ネイティブのサンドボックスを備え、2026年3月4日（App v26.304）に Windows 向けにリリースされました。WSL を必要とせず、skills、自動化、worktrees を含むすべての機能を利用できます。⁶⁶

GitHub Action と CI/CD

公式の GitHub Action を使用すると、Codex を CI/CD パイプラインに統合できます。¹⁸

基本的な使い方

# .github/workflows/codex.yml
name: Codex
on:
  pull_request:
    types: [opened]

jobs:
  codex:
    runs-on: ubuntu-latest
    outputs:
      final_message: ${{ steps.run_codex.outputs.final-message }}
    steps:
      - uses: actions/checkout@v5
      - name: Run Codex
        id: run_codex
        uses: openai/codex-action@v1
        with:
          openai-api-key: ${{ secrets.OPENAI_API_KEY }}
          prompt-file: .github/codex/prompts/review.md
          sandbox: workspace-write
          safety-strategy: drop-sudo

設定オプション

出力：final-message。後続のステップ／ジョブで使用する Codex の最終応答テキストです。

安全対策

アクセス制御

with:
  allow-users: "admin,maintainer"     # Limit who can trigger
  allow-bots: false                   # Block bot-triggered runs

デフォルト：書き込み権限を持つコラボレーターのみが Codex ワークフローをトリガーできます。

Codex SDK

TypeScript SDK を使用すると、Codex のエージェント機能をカスタムアプリに組み込めます。¹⁹

インストール

npm install @openai/codex-sdk

基本的な使い方

import { Codex } from "@openai/codex-sdk";

const codex = new Codex();
const thread = codex.startThread();

// Multi-turn conversation
const turn1 = await thread.run("Diagnose CI failures and propose a fix");
console.log(turn1.finalResponse);

const turn2 = await thread.run("Implement the fix and add tests");
console.log(turn2.items);

// Resume a previous session
const resumed = codex.resumeThread("<thread-id>");
await resumed.run("Continue from previous work");

高度な SDK 機能

• runStreamed(...)：途中経過を受け取るための非同期イベントストリーム
• Python SDK 認証（v0.132.0以降）：API キーによるログイン、ChatGPT のブラウザ／デバイスコードフロー、アカウント情報の確認、ログアウトが、正式な SDK 経由の操作として利用できます。⁹⁷
• テキストのみのターンを簡単に扱う機能（v0.132.0以降）：Python のターン API はプレーン文字列を受け取り、収集された項目、所要時間、使用量を含む、より詳細な TurnResult メタデータを返します。⁹⁷
• outputSchema：最終出力を JSON 形式に強制
• マルチモーダル入力：テキストとローカル画像（{ type: "local_image", path: "..." }）を渡せます
• 画像ワークフロー（v0.117.0）：view_image が URL を返し、生成画像を再度開けるようになり、セッションを再開しても画像履歴が保持されます⁷⁵
• 複数環境での view_image（v0.130.0）：複数の環境にまたがるセッション（ターンごとの環境と作業ディレクトリの選択機能とともに v0.124.0 で導入され、環境を維持する機能が v0.125.0 で改善されました）では、view_image がオーケストレーターのローカルファイルシステムではなく、選択中の環境を通じてファイルパスを解決するようになりました。リモート環境から添付された画像は、SDK を実行しているホストではなく、その環境の作業ディレクトリを基準に取得されます。⁹¹

スレッドとクライアントの設定

// Custom working directory, skip git check
const thread = codex.startThread({
  workingDirectory: "/path/to/project",
  skipGitRepoCheck: true,
});

// Custom environment and config overrides
const codex = new Codex({
  env: { CODEX_API_KEY: process.env.MY_KEY },
  config: { model: "gpt-5.5" },
});

セッションは ~/.codex/sessions に保存されます。

実行環境：Node.js 18以降。

パフォーマンス最適化

コンテキスト管理

コンテキストウィンドウはモデルによって異なります。現在の GPT-5.6 ファミリー（Sol、Terra、Luna）は 272K、前世代のフラッグシップである GPT-5.5 は Codex で 400K（API では1M）、GPT-5.4 / GPT-5.4-mini（2026年8月31日に Codex での提供終了予定）は 1M / 400K、旧世代の GPT-5.3-Codex ファミリーは 272K入力 + 128K出力（合計400Kのバジェット）でした。いずれも予想以上に早く埋まるため、先回りして管理しましょう。

1. /compact を定期的に使用する：会話履歴を要約してトークンを解放します
2. ローカルドキュメントを用意する：質の高い AGENTS.md とローカルドキュメントにより、コンテキストを消費する調査の負担を軽減できます
3. @ で特定のファイルを添付する：Codex にファイルを探させるのではなく、ファイルを直接参照します
4. プロンプトの焦点を絞る：対象ファイルを明示したスコープの狭いプロンプトは、自由度の高い調査よりもコンテキスト消費を抑えられます

実験的なコンテキスト管理（v0.153.0、デフォルトでは無効）： features.context_management.experimental_mode を有効にすると、Codex バックエンドを使用する対象の ChatGPT Plus、Pro、Pro Lite セッションで、トークンバジェットコンテキスト、履歴メモ、new_context ツールを組み合わせたコンテキストスタックが有効になります。API キーを使用するセッション、カスタムプロバイダー、Codex 以外のエンドポイント、一時的な構造化スレッドは対象外です。また、このフラグは明示的に開発中とされているため、ワークフローの基盤としてではなく、今後のコンテキスト処理の方向性を示すプレビューとして扱ってください。¹⁴⁰ v0.154.0では機能ゲートが追加されています：対象かどうかはセッション開始時に、アクティブなモデルの機能に基づいて判定されます（#43147）。これは Codex のモデルドキュメントで、Plus および Pro のサインインに関連して Astra の名称と結び付けられているものと同じ機能情報です（「どのモデルを選ぶべきか？」のコンテキスト横断注記をご覧ください）。¹⁴⁶¹⁵² v0.157.0時点では、同梱のカタログ内でこの機能に対応するとマークされたモデルはないため（#47397）、そのカタログを使用している場合、この設定は効果を持ちません。¹⁷⁴ v0.159.1で追加された GPT-6.1 Sol にも対応マークはなく、設定リファレンスでは、このキーが「現在利用できない」と説明されています。¹⁷⁸

トークン効率

速度の最適化

1. gpt-5.3-codex-spark：対話的なペア作業向けの低レイテンシーバリアント
2. --profile fast：推論レベルを低く設定した構成済みの gpt-5.6-luna
3. ツールの並列実行：Codex は独立した読み取り／チェックを同時に実行するため、それが可能になるようにプロンプトを構成します
4. 成果重視のループ：手順を1つずつ指示する代わりに、「実装し、テストし、修正して、成功したら終了」と依頼します

問題をデバッグするには？

よくある問題と解決策

エラーメッセージの参照