Codex 网页搜索的工作原理
Codex 内置了搜索工具。OpenAI 的文档在描述它时附带了一条警告:“ChatGPT 包含一个第一方网页搜索工具。请将所有网页结果视为不可信输入。”
你可以看到 Codex 何时进行了搜索。文档称:“搜索在交互式转录和 codex exec --json 输出中显示为 web_search 项目。”在 IDE 扩展中,搜索活动也会出现在对话转录中,文档指出:“该扩展使用所连接的 Codex 主机的搜索模式。”
关键问题在于结果的来源。这取决于搜索模式。
什么是缓存搜索
Codex 的配置文档更详细地解释了默认设置:“缓存是 OpenAI 维护的网页结果索引,因此缓存模式返回预索引的结果,而不是获取实时页面。这减少了来自任意实时内容的提示词注入风险。”
因此,在缓存模式下,Codex 在你提问的那一刻并没有访问你询问的页面。它正在从索引中读取结果。这就是开头例子的原因。非常近期发布或更新的页面可能尚未反映在索引中。
这种权衡是刻意为之的。实时页面可能包含旨在操纵智能体的指令。索引减少了这种风险暴露,尽管文档谨慎地表示它是降低风险而非消除风险。
四种搜索模式
Codex 的配置参考列出了 web_search 设置的四个值。文档对每一个都进行了描述:
- Cached(缓存)是默认设置。它提供来自网页搜索缓存的结果。
- Indexed(索引)仅在搜索索引允许请求时才允许外部网页访问。
- Live(实时)从网页获取最新数据。文档称其与
--search标志效果相同。 - Disabled(禁用)关闭网页搜索工具。
默认设置有一个例外。文档称:“当 Codex 以完全访问权限(full access)运行时,网页搜索默认为实时结果。”因此,如果你以完全访问权限运行 Codex,你可能已经在未进行任何设置的情况下获得了实时结果。
何时缓存结果就足够了
对于许多日常工作,索引已经足够:
- 查找成熟的库函数如何工作。
- 查找不经常更改的文档页面。
- 为设计决策研究背景资料。
- 比较已经被讨论了一段时间的方法。
在这些情况下,索引很可能拥有你所需的内容,同时你还能保持较低的实时内容风险暴露。
何时切换到实时结果
文档的建议很简短:“当你的任务依赖于最新信息时,请使用实时搜索。”
这涵盖了如下任务:
- 检查今天发布的版本。
- 阅读状态页面或事件报告的当前状态。
- 查找更新频繁的变更日志(changelog)。
- 验证修复补丁或弃用(deprecation)是否已落地。
对于单次运行,CLI 有一个标志。文档称:“在 CLI 中,传递 --search 以在单次运行中获取实时结果”。这不会改变你的默认设置。
对于持久更改,请在配置文件中设置模式。文档建议在 config.toml 中将 web_search 值设置为 live,或设置为 disabled 以关闭该工具。
如何更改模式
该设置位于 Codex 配置文件中。Codex 的配置文档列出了值的解析顺序,从最高优先级到最低优先级:
- CLI 标志和
--config覆盖。 .codex/config.toml中的项目配置文件,最接近工作目录的优先,仅限受信任的项目。- 使用
--profile选择的配置文件。 ~/.codex/config.toml中的用户配置。- 为你的工作区交付的云端管理默认值。
- 系统配置(如果存在)。
- 内置默认值。
因此,项目可以设置自己的搜索模式,配置文件可以为某种工作切换模式,而单个命令可以覆盖这两者。如果项目被标记为不可信,文档称 Codex 会跳过项目范围的 .codex/ 层,包括项目本地配置。
如果你已经使用 Codex 一段时间,请检查旧设置。配置参考将 [features] 下的遗留开关(如 web_search_cached 和 web_search_request)列为已弃用。当顶级 web_search 设置未设置时,它们仍会映射到缓存或实时模式。直接设置 web_search 可以使模式更加清晰。
网页搜索不遵循哪些网络规则
这是标题中的细节,如果你为 Codex 配置了网络限制,这一点非常重要。
文档指出:“网页搜索是一个托管工具,与沙盒化的本地命令网络相互独立。它不使用权限配置文件的网络代理或域名白名单,并且在禁用命令网络访问时仍可保持可用。”
因此,存在两个独立的系统:
- 命令网络(Command networking)。 沙盒规则决定 Codex 运行的命令(如包安装或
curl)是否可以访问网络、通过哪个代理以及访问哪些域名。 - 网页搜索(Web search)。 一个具有自身设置的托管工具。
关闭命令的网络访问不会关闭网页搜索。命令的域名白名单也不会限制搜索可以返回哪些网站。
网页搜索有自己的域名过滤器。配置参考描述了 tools.web_search 的对象形式,它可以“设置搜索上下文大小、允许的搜索域名以及大致的用户位置”。它补充说,这些过滤器“与沙盒命令的网络域名规则是分开的,并且不限制连接器或 MCP 服务器”。
网页搜索页面从另一个角度说明了同样的情况:“搜索域名过滤器不限制本地命令流量、应用、连接器或 MCP 服务器。”
如果你想同时限制两者,你需要同时进行这两项设置。我们在 Codex 规则 指南中介绍了 Codex 如何决定哪些命令可以在沙盒之外运行。
管理员如何限制搜索模式
对于托管环境,OpenAI 的文档提到了一个名为 allowed_web_search_modes 的要求。配置参考将其描述为 web_search 的允许值,并补充道:“disabled 始终是允许的;空列表实际上仅允许 disabled。”
因此,一个组织可以例如允许缓存和禁用,但不允许实时搜索。文档建议将命令网络策略与 allowed_web_search_modes、经过批准的 MCP 服务器以及应用、插件、浏览器或 Computer Use 的功能要求相结合。
在网页版 ChatGPT 中,文档指出:“工作区设置可以限制搜索是否可用。”
网页搜索如何与 Codex 记忆交互
Codex 可以将早期对话中有用的上下文转化为本地记忆。其配置参考包含一个连接记忆和搜索的设置。
记忆文档这样描述 memories.disable_on_external_context:“当为 true 时,将使用了外部上下文(如 MCP 工具调用、网页搜索或工具搜索)的对话排除在记忆生成之外。”配置参考称其默认值为 false。
因此,默认情况下,使用了网页搜索的对话仍然可以像任何其他符合条件的对话一样贡献于记忆生成。如果你希望防止引入外部内容的对话影响 Codex 的记忆,请将该选项设置为 true。文档指出,旧的键名 memories.no_memories_if_mcp_or_web_search 仍被接受作为别名。
当搜索结果是不可信输入时,这一点尤为重要。阅读了网页的对话,其内容部分来自你的项目之外。
关于提示词注入的说明
配置文档在搜索章节的末尾给出了警告:“在 Codex 中启用网络访问或网页搜索时请务必小心。提示词注入可能导致智能体获取并遵循不可信的指令。”
缓存模式是默认设置,因为它减少了这种风险暴露。当实效性更重要时,可以使用实时模式。两者都不能使网页内容变得完全可信,因此请审查 Codex 根据结果所采取的操作,尤其是在它基于这些结果运行命令之前。
人们首先尝试的操作
期望搜索结果反映今天的变化。 本地对话默认使用缓存索引。
关闭命令网络访问以停止搜索。 网页搜索是独立的,可以保持可用。
使用命令域名白名单来限制搜索。 搜索在 tools.web_search 中有自己的域名过滤器。
保留旧的功能开关。 应改为设置顶级的 web_search 值。
假设搜索永远不会影响记忆。 默认情况下,使用过网页搜索的对话可以为记忆生成提供素材。
解决方案:根据任务选择搜索模式
第 1 步:保持缓存作为默认设置
将索引用于背景研究和稳定的文档。
第 2 步:对时间敏感的检查使用实时模式
在单次运行时传递 --search,或者在你用于此类工作的配置文件中设置 live。
第 3 步:将搜索限制与网络限制分开设置
使用 tools.web_search 设置搜索域名,使用沙盒设置处理命令流量。
第 4 步:记录你验证过的内容
当实时搜索确认了一个版本、一个修复或一个弃用时,记录下结果和日期。
在 MemoryLake 中设置
网页搜索在某一时刻回答了一个问题。你从中了解到的信息(例如哪个版本引入了修复、哪个 API 已被弃用,或者你的团队信任哪个依赖项来源)是项目上下文,在搜索结束后很久仍然有用。
MemoryLake 是此类项目上下文的记忆层,例如经过验证的事实、决策及其背后的来源,统一保存在你维护的一个地方,并可供你连接的助手(如 ChatGPT、Claude Code 和 Codex)使用。
你用自己的语言亲自编写条目。不会从你的 Codex 对话、搜索结果、config.toml、Codex 记忆或任何供应商的存储中读取、写入或删除任何内容。Codex 网页搜索的工作方式与 OpenAI 描述的一致。
第 1 步:创建 API 密钥
登录并在仪表板中生成密钥。像对待任何其他凭据一样,将其存储在存储库之外。

第 2 步:上传你的第一批记忆
从你在解决方案第 4 步中写下的内容开始:你验证的事实及其时间。每个条目一个事实,并注明来源。

第 3 步:连接你的 AI 和智能体
连接 Codex、Claude Code 和你使用的其他助手。每个助手都可以利用相同的经过验证的事实,而无需再次搜索。

这在实践中改变了什么
第一个区别是减少了重复搜索。你验证过一次的事实下次即可直接使用。
第二个区别是更清晰的出处。每个条目都说明了事实的来源和时间。
第三个区别是跨工具的一致性。在 Codex 和其他助手中都可以使用相同的经过验证的事实。
Codex 网页搜索的最佳实践
保持缓存作为默认设置。 它减少了对实时内容的风险暴露。
对一次性实效性需求使用 --search。 它不会改变你的默认设置。
对重复的实时工作使用配置文件(profiles)。 在适用的地方设置模式。
单独限制搜索域名。 命令网络规则不适用于搜索。
检查遗留开关。 优先使用顶级的 web_search 设置。
决定记忆生成。 如果你希望排除搜索过的对话,请使用 memories.disable_on_external_context。
将结果视为不可信。 在根据结果采取行动之前进行审查。
结论
Codex 网页搜索在本地对话中默认使用由 OpenAI 维护的缓存索引。这降低了提示词注入的风险,但也意味着非常近期的页面可能无法反映出来。通过在 config.toml 中设置 web_search 或在单次运行时使用 --search 标志来开启实时模式,可以获取最新数据,且完全访问权限会话默认为实时模式。
网页搜索是一个托管工具,与沙盒的命令网络相互独立,因此它不使用你的网络代理或命令域名白名单,并且在命令网络访问关闭时仍可保持可用。它有自己的域名过滤器,管理员可以限制允许的模式,默认情况下,除非你将 memories.disable_on_external_context 设置为 true,否则使用过搜索的对话仍可为记忆生成提供素材。