Codex IDE 扩展让你可以在 VS Code、Cursor、Windsurf 以及其他兼容 VS Code 的编辑器中直接使用 Codex。它使用与 Codex CLI 相同的智能体,也共享同一套配置。
结合编辑器上下文写提示词
你可以直接在编辑器中用 Codex 聊天、改代码并预览改动。当 Codex 获得打开文件和选中代码这类上下文后,你通常可以写更短的提示词,并得到更快、更相关的结果。
你可以在提示词中通过打标签的方式引用编辑器中的任意文件,例如:
Use @example.tsx as a reference to add a new page named "Resources" to the app that contains a list of resources defined in @resources.ts
在模型之间切换
你可以使用聊天输入框下方的切换器切换模型。

调整推理强度
你可以调整推理强度,以控制 Codex 在回应之前会思考多久。更高的推理强度对复杂任务可能更有帮助,但响应也会更慢;同时它会消耗更多 tokens,也会更快用掉你的速率限制,特别是在使用能力更强的模型时。
仍然是在上面的模型切换器里,为每个模型选择 low、medium 或 high。建议从 medium(中) 开始,只有在你确实需要更多深度时再切到 high(高)。
选择审批模式
默认情况下,Codex 运行在智能体模式。在这个模式里,Codex 可以自动读取文件、修改代码并在工作目录中运行命令。但如果需要在工作目录之外工作,或者访问网络,它仍然需要你的审批。
如果你只是想聊天,或者想在动手前先规划,可以通过聊天输入框下方的切换器切换到 Chat(聊天)。

如果你需要 Codex 在无需审批的情况下读取文件、修改代码并以带网络访问的方式运行命令,可以使用 Agent (Full Access)。这里的 Agent 表示智能体模式。启用前请谨慎。
云端委派
你可以把更大的任务交给云端 Codex 处理,同时仍然留在 IDE 中跟踪进度和评审结果。
- 先为 Codex 设置一个 Codex 云端环境。
- 选好要使用的环境,然后在 IDE 中选择 Run in the cloud(在云端运行)。
你既可以让 Codex 从 main 开始运行(适合尝试新想法),也可以从你当前的本地改动出发运行(适合把现有任务继续做完)。

当你从本地对话发起云任务时,Codex 会记住当前对话上下文,因此它能从你上次停下来的地方继续。
跟进云任务
Codex 扩展让预览云端改动变得很直接。你可以继续要求后续步骤仍在云端运行,但很多时候你会想把这些改动拉回本地,再测试和收尾。当你在本地继续这段对话时,Codex 同样会保留上下文,帮你节省时间。

你也可以在 Codex 云端界面 中查看这些云任务。
Web 搜索
Codex 自带第一方 Web 搜索工具。对于 Codex IDE 扩展中的本地任务,默认会启用 Web 搜索,并从 Web 搜索缓存提供结果。这个缓存是 OpenAI 维护的网页结果索引,因此缓存模式返回的是预索引结果,而不是直接抓取实时页面。这能降低从任意实时内容中遭遇提示词注入的风险,但你仍应把 Web 结果视为不可信输入。如果你把沙箱配置为完全访问,Web 搜索会默认切换到实时结果。要关闭 Web 搜索,或切换到实时抓取最新数据的模式,请参见基础配置。
只要 Codex 做了网页检索,你都会在转录记录或 codex exec --json 输出中看到 web_search 条目。
把图片拖进提示词
你可以把图片拖放到提示词输入框中,把它们作为上下文提供给 Codex。
拖放图片时请按住 Shift,因为 VS Code 默认会阻止扩展直接接受拖放。