結論先說
- 本地 Codex 會話預設開啟
cached(緩存)聯網搜尋,從 OpenAI 維護的索引緩存裏取結果,而不是實時抓任意網頁,用來降低網頁提示詞注入風險。 - 命令行單次要查最新網頁,直接加
--search(等價於把當次運行切到live實時搜尋)。 - 想持久修改或徹底關掉,在
~/.codex/config.toml頂層設定web_search,可選"cached"、"live"、"indexed"、"disabled"四檔。 - 開啟完全訪問沙箱(如
--yolo或danger-full-access)時,web_search預設會自動變成"live"。 - 聯網搜尋是雲端託管工具,和本地命令沙箱網絡是兩套獨立開關:即使沙箱禁止本地
curl/npm聯網,web_search沒設為"disabled"時依然可用。

圖:本站根據 Codex 官方文檔:Web search 整理的示意圖
本文根據 Codex 官方文檔《Web search》《Sample Configuration》與《Managed configuration》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。普通網頁版搜尋與 API 搜尋工具見 ChatGPT 搜尋怎麼用 和 OpenAI API 聯網搜尋工具怎麼用。
適用於誰
- 想讓 Codex CLI 或桌面端查當天剛發佈的第三方庫更新說明,發現預設搜不到最新網頁的人;
- 在涉密或離線合規項目裏,需要徹底關掉 Codex 聯網搜尋或只允許查指定技術文檔域名的人;
- 分不清「
web_search搜尋工具」與「本地沙箱命令出網權限(network_access)」為什麼互不影響的人。
一、四種聯網搜尋模式有什麼區別
按官方《Web search》與示例配置的說明,web_search 頂層鍵支持四個取值,官方同時強調要把所有網頁搜尋結果當作不可信輸入對待:
"cached"(預設):直接從 OpenAI 維護的搜尋索引緩存返回預收錄結果,不去目標站點實時拉頁面。好處是速度快,且能減少(但不能完全消除)惡意網頁裏的提示詞注入風險。"live"(實時):實時聯網獲取最新數據,適合查剛發佈的框架變更日誌、當天報錯公告。需要注意,當你使用--yolo等完全訪問沙箱運行時,預設檔位會從cached自動切為live。"indexed"(索引門控):僅在請求經過搜尋索引門控的前提下允許外部網頁訪問,介於純緩存與完全實時之間。"disabled"(關閉):完全停用內置網頁搜尋工具。
二、命令行單次開關與 config.toml 持久配置

圖:本站根據 Codex 官方文檔:Web search 與託管配置整理的示意圖
1. 命令行臨時開啟實時搜尋:--search
平時保持預設 cached,偶爾有一回需要查最新外部資料時,在啟動 CLI 時加上 --search 即可:
bash
codex --search "查看這個依賴庫最新版本的破壞性變更說明"
在交互式對話記錄和 codex exec --json 的事件流裏,搜尋動作會以 web_search 條目的形式清晰列出來。
2. 在 config.toml 裏持久開啟或關閉
打開 ~/.codex/config.toml(完整層級與語法見 Codex config.toml 完整詳解),在所有 [表] 之前的根級區域寫入:
toml
# 四選一:"cached" | "live" | "indexed" | "disabled"
web_search = "live"
如果只想允許搜尋白名單內的技術文檔站點,官方還支持配合 tools.web_search.allowed_domains 做域名過濾。IDE 擴展(如 VS Code)不單獨維護搜尋模式,直接沿用所連接的 Codex 主機設定。
3. 在桌面端與網頁版做深度多源調研
除了寫代碼時順帶查文檔,官方《Web search》還介紹了做多源長報告的做法:在桌面端切到 Work 打開 插件(Plugins) 啟用 Deep research,或在網頁版 Work 點輸入框旁的 + 號選 Deep research,就能結合上載文件做跨信源對比報告。想在 Plus 或 Pro 上暢用 Work、Codex 與聯網檢索,可看本站 ChatGPT Plus 充值說明。
三、別把「搜尋開關」和「沙箱命令聯網」搞混
這是很多人在配安全策略時最容易踩的坑。官方文檔專門劃清了兩者的邊界(沙箱配置見 Codex 權限與沙箱設定):
web_search是官方託管工具,不走你本機權限配置裏的網絡代理(network_proxy)或命令域名白名單。就算sandbox_workspace_write.network_access是預設的false(禁止子進程自己髮網絡請求),只要web_search沒關,Codex 仍能調用託管搜尋。- 反過來也一樣:你在搜尋工具上配的
tools.web_search.allowed_domains只管內置網頁搜尋,管不住本地 Shell 命令、連接器(Connectors)或 MCP 伺服器發出的網絡流量。兩邊要各自獨立配置。
四、團隊管理員強制限制與自定義模型提供方
- 管理員鎖定模式:如果公司不允許成員開啟實時搜尋(哪怕成員自己加了
--yolo),管理員可在後台requirements.toml裏寫allowed_web_search_modes = ["cached"](此時disabled仍隱式允許);寫成空數組allowed_web_search_modes = []則強制全員只能處於disabled關閉狀態。公司團隊開通與管理可了解本站 ChatGPT Business 團隊版定製。 - 自定義模型提供方:如果你接的是自定義 Responses API 提供方(配法見 Codex 怎麼配置 Azure OpenAI 等官方模型提供方),官方說明其
supports_standalone_web_search預設是false,且獨立網頁搜尋功能仍在開發中,只有提供方接口、所選模型和運行時三方同時支持才會生效。
常見問題
問:我已經設了 web_search = "live",為什麼運行後還是隻能用 cached 或搜不了?
答:先在 CLI 裏運行 /debug-config,看是不是被項目級 .codex/config.toml、當前選用的 --profile 文件,或者工作區管理員下發的 allowed_web_search_modes 強約束覆蓋了。
問:Codex Cloud(雲端任務)裏的聯網規則也歸 web_search 管嗎?
答:本地會話由上述 web_search 控制;雲端容器環境的互聯網進出邊界由雲端環境自身的網絡設定單獨控制。
問:開啟聯網搜尋會額外扣套餐額度嗎?
答:網頁搜尋返回的結果會作為工具輸出進入上下文,佔用 token 並計入你當前的套餐使用限額(或按 token 扣 Credits / API 費用)。
相關教學
- Codex config.toml 完整詳解
- Codex 權限與沙箱設定
- OpenAI API 聯網搜尋工具(web search)怎麼用
- ChatGPT 搜尋怎麼用
- Codex 怎麼配置 Azure OpenAI 等官方模型提供方
參考資料
- Codex 官方文檔:Web search — https://learn.chatgpt.com/docs/web-search
- Codex 官方文檔:Sample Configuration — https://learn.chatgpt.com/docs/config-file/config-sample
- Codex 官方文檔:Managed configuration — https://learn.chatgpt.com/docs/enterprise/managed-configuration
0 條評論
還沒有評論,來搶沙發~