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 条评论

登录 后参与评论

还没有评论,来抢沙发~