Codex 聯網搜尋怎麼開關:cached、live、disabled 四種模式與 --search 參數

Codex 能聯網查最新庫文檔嗎、怎麼徹底關掉?按官方《Web search》與配置參考整理:預設開啟 cached 緩存搜尋,單次實時檢索用 --search,持久修改在 config.toml 設 web_search,附域名白名單與沙箱網絡的區別。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

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

Codex 本地聯網搜尋四種模式對比

圖:本站根據 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 聯網搜尋怎麼按場景設開關

圖:本站根據 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 權限與沙箱設定):

  1. web_search 是官方託管工具,不走你本機權限配置裏的網絡代理(network_proxy)或命令域名白名單。就算 sandbox_workspace_write.network_access 是預設的 false(禁止子進程自己髮網絡請求),只要 web_search 沒關,Codex 仍能調用託管搜尋。
  2. 反過來也一樣:你在搜尋工具上配的 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 官方文檔: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

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    AutoGen 現在怎麼樣了?微軟官方演進路線與 Microsoft Agent Framework 入門

    搜 AutoGen 新教學常被 0.2、0.4、社區分支和 Semantic Kernel 繞暈。按微軟官方文檔,微軟已將 AutoGen 與 Semantic Kernel 兩支團隊合併推出統一的開源框架 Microsoft Agent Framework。本文講清現狀與 Python 快速上手。

    ChatGPT其他 AI 工具0
  2. 02

    多 Agent 的成本為什麼翻倍、怎麼控制:Token 膨脹根源與五項降本措施

    剛把單智能體拆成多 Agent,用量往往暴漲好幾倍。Anthropic 工程報告統計單智能體約為聊天的 4 倍 Token,多智能體可達約 15 倍。本文拆解固定前綴重複加載、歷史搬運、工具鏈定義與緩存失效四大根源,並給出五條實操控費辦法。

    ChatGPTClaude0
  3. 03

    多 Agent 協同開發怎麼落地:「一個寫、一個審」雙代理工作流搭建指南

    多 Agent 協同開發裏投入產出比最高的模式就是「一個寫、一個審」。本文依據 Anthropic 與 OpenAI 官方編碼最佳實踐,講清為什麼同會話自審容易漏問題,以及用只讀子代理、跨模型交叉審查(Claude Code + Codex)和自動化閉環落地的具體方法。

    ClaudeCodex0
  4. 04

    多 Agent 編排模式詳解:編排者-工作者、交接(Handoffs)、並行與評估循環怎麼選

    搜「multi-agent orchestration 中文」會被各家框架的不同術語繞暈。本文對照 Anthropic《Building effective agents》與 OpenAI 智能體指南,把編排者-工作者、去中心化交接、並行分片投票與生成-評估循環四種標準編排拓撲講透。

    ChatGPTClaude0
  5. 05

    多智能體(Multi-Agent)是什麼、什麼時候該用:Anthropic 與 OpenAI 官方判斷標準

    多智能體不是代理越多越聰明。本文依據 Anthropic 研究系統架構文章與 OpenAI 官方智能體指南,講清確定性工作流、單智能體與多智能體的區別,以及哪三類瓶頸才值得上多智能體協同。

    ChatGPTClaude0
  6. 06

    codebase-memory 類 MCP 是什麼、怎麼用:基於語法樹圖譜的本地代碼索引原理與配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一類本地代碼圖譜 MCP 伺服器:用 Tree-sitter 把倉庫解析成函數與調用關係的 SQLite 圖庫,幫編碼助手查調用鏈並省下讀整份文件的額度。

    ClaudeCodex0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~