Web search (Codex)

サンドボックス内のローカルコマンドのネットワークとは別のホスト型ツールです。ローカルの Codex チャットでは、OpenAI が管理するインデックスを使う cached search が既定で有効です。検索モードや検索対象のドメインは設定で指定できます。

Web search は、ChatGPT に含まれるファーストパーティの Web 検索ツールです。Web から得た結果は、すべて信頼できない入力として扱います。

検索の記録は、使う場所ごとに次のように残ります。

• CLI では、検索が対話のトランスクリプトと codex exec --json の出力に web_search 項目として現れます。
• IDE 拡張は、接続先の Codex ホストの検索モードを使い、検索の動きはチャットのトランスクリプトに表示されます。
• ChatGPT のデスクトップアプリでは、検索の動きがほかのツール呼び出しと一緒にトランスクリプトに記録されます。
• ChatGPT の Web 版では、検索を使ったときに検索結果と引用がチャットに表示されます。

ローカルの Codex チャットでは、cached search が既定で有効です。cached モードは任意のページをその場で取得する代わりに OpenAI が管理するインデックスを使うため、プロンプトインジェクションのリスクを下げます。ただし、リスクを無くすものではありません。

• Codex をフルアクセスで実行している場合、Web search の既定はライブの結果です。
• "indexed" モードは、検索インデックスがリクエストを通したときだけ外部の Web へのアクセスを許可します。
• 最新の情報が必要な作業では web_search = "live"、ツールを止める場合は web_search = "disabled" を指定します。

カスタムプロバイダーの既定値は supports_standalone_web_search = false です。オプトインするには、設定の [model_providers.custom] テーブルで supports_standalone_web_search = true を指定します。

このプロバイダーの設定だけでは standalone search は有効になりません。プロバイダー、選んだモデル、ランタイムのすべてが standalone search に対応している必要があります。ワークスペースや管理側の検索制限も引き続き適用されます。

Web search は、サンドボックス内のローカルコマンドのネットワークとは別のホスト型ツールです。権限プロファイルのネットワークプロキシやドメインの許可リストは使わず、コマンドのネットワークアクセスを無効にしていても利用できる状態が残る場合があります。

• 検索の設定には web_search、tools.web_search.allowed_domains、管理用の allowed_web_search_modes を使います。
• 検索ドメインのフィルターは、ローカルコマンドの通信、アプリ、コネクタ、MCP サーバーを制限しません。
• standalone web search はシステムのプロキシ設定に従います。検索のリダイレクトを含め、設定したプロキシを経由するルーティングは 2026 年 9 月 25 日に修正されています。
• 暗黙のクライアント設定が、サーバーや保存済みスレッドの Web 検索設定を上書きすることはありません。

対象となるプランについては、公式のリリースノートには記載がありません。

ローカルの Codex で使う検索モードは config.toml で設定します。

1. 作業が最新の情報に依存する場合は、config.toml に web_search = "live" を設定してライブ検索を使います。
2. Web search ツールを使わない場合は、web_search = "disabled" を設定してツールをオフにします。