OpenAI Codex 中文文档(4.14更新)
联系我
官方文档

Codex IDE 扩展功能

你可以在 Codex IDE 扩展中做什么

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 模型切换器

调整推理强度

你可以调整推理强度,以控制 Codex 在回应之前会思考多久。更高的推理强度对复杂任务可能更有帮助,但响应也会更慢;同时它会消耗更多 tokens,也会更快用掉你的速率限制,特别是在使用能力更强的模型时。

仍然是在上面的模型切换器里,为每个模型选择 lowmediumhigh。建议从 medium(中) 开始,只有在你确实需要更多深度时再切到 high(高)

选择审批模式

默认情况下,Codex 运行在智能体模式。在这个模式里,Codex 可以自动读取文件、修改代码并在工作目录中运行命令。但如果需要在工作目录之外工作,或者访问网络,它仍然需要你的审批。

如果你只是想聊天,或者想在动手前先规划,可以通过聊天输入框下方的切换器切换到 Chat(聊天)

Codex 审批模式切换器

如果你需要 Codex 在无需审批的情况下读取文件、修改代码并以带网络访问的方式运行命令,可以使用 Agent (Full Access)。这里的 Agent 表示智能体模式。启用前请谨慎。

云端委派

你可以把更大的任务交给云端 Codex 处理,同时仍然留在 IDE 中跟踪进度和评审结果。

  1. 先为 Codex 设置一个 Codex 云端环境
  2. 选好要使用的环境,然后在 IDE 中选择 Run in the cloud(在云端运行)

你既可以让 Codex 从 main 开始运行(适合尝试新想法),也可以从你当前的本地改动出发运行(适合把现有任务继续做完)。

从 IDE 启动云任务

当你从本地对话发起云任务时,Codex 会记住当前对话上下文,因此它能从你上次停下来的地方继续。

跟进云任务

Codex 扩展让预览云端改动变得很直接。你可以继续要求后续步骤仍在云端运行,但很多时候你会想把这些改动拉回本地,再测试和收尾。当你在本地继续这段对话时,Codex 同样会保留上下文,帮你节省时间。

把云任务加载到 IDE 中

你也可以在 Codex 云端界面 中查看这些云任务。

Web 搜索

Codex 自带第一方 Web 搜索工具。对于 Codex IDE 扩展中的本地任务,默认会启用 Web 搜索,并从 Web 搜索缓存提供结果。这个缓存是 OpenAI 维护的网页结果索引,因此缓存模式返回的是预索引结果,而不是直接抓取实时页面。这能降低从任意实时内容中遭遇提示词注入的风险,但你仍应把 Web 结果视为不可信输入。如果你把沙箱配置为完全访问,Web 搜索会默认切换到实时结果。要关闭 Web 搜索,或切换到实时抓取最新数据的模式,请参见基础配置

只要 Codex 做了网页检索,你都会在转录记录或 codex exec --json 输出中看到 web_search 条目。

把图片拖进提示词

你可以把图片拖放到提示词输入框中,把它们作为上下文提供给 Codex。

拖放图片时请按住 Shift,因为 VS Code 默认会阻止扩展直接接受拖放。

另请参见


来源:https://developers.openai.com/codex/ide/features