OpenAI Codex IDE 扩展把 Codex 直接带进 VS Code、Cursor、Windsurf 等兼容编辑器,适合在编辑器里聊天、修改代码、预览结果和把任务交给云端执行。这里重点说明怎么切换模型、怎么选 Agent/Chat/Agent (Full Access) 模式、web search 默认行为、图片拖放限制,以及图像生成的额度和计费差异。

OpenAI Codex IDE 扩展功能

OpenAI Codex IDE 扩展可以直接在 VS Code、Cursor、Windsurf 以及其他 VS Code-compatible editors 中使用。它和 Codex CLI 使用同一个 agent,也共享同一套配置。

用 Codex 在编辑器里写提示词

你可以在编辑器里直接用 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

怎么切换模型

你可以在聊天输入框下方的 switcher 里切换模型。

怎么调整 reasoning effort

你可以调整 reasoning effort,控制 Codex 在回复前思考多久。更高的 effort 适合更复杂的任务,但响应会更慢,也会使用更多 tokens,更快消耗 rate limits,尤其是在更高能力的模型上。

还是用上面的 model switcher,针对每个模型选择 low、medium 或 high。默认先从 medium 开始,只有在需要更深入推理时再切到 high。

怎么选择 approval mode

默认情况下,Codex 运行在 Agent mode。这个模式下,Codex 可以读取文件、修改文件,并在 working directory 中自动运行命令。只有在需要访问 working directory 外部内容或访问网络时,Codex 才需要你的批准。

如果你只是想聊天,或者想先规划再修改,切到聊天输入框下方 switcher 里的 Chat。

注意:如果你让 Codex 在不需要批准的情况下读取文件、修改文件并使用网络访问运行命令,可以使用 Agent (Full Access)。启用前要谨慎。

怎么把任务交给云端

你可以把更大的任务交给云端里的 Codex 执行,然后在 IDE 里跟踪进度和查看结果,不用离开编辑器。

  1. 先为 Codex 配置一个 cloud environment。
  2. 选择你的 environment,然后点 Run in the cloud。

你可以让 Codex 从 main 开始运行,适合启动新想法;也可以基于本地改动运行,适合继续完成一个任务。

当你从本地对话发起 cloud task 时,Codex 会记住上下文,方便接着上次的内容继续做。

云端任务怎么继续处理

Codex extension 让你预览云端改动更直接。你可以继续要求它在云端执行后续步骤,但很多时候更常见的做法是把改动应用到本地,再测试和收尾。你在本地继续对话时,Codex 也会保留上下文,减少重复说明。

你也可以在 Codex cloud interface 里查看云端任务。

Codex 自带 first-party web search tool。对于 Codex IDE Extension 里的本地任务,Codex 默认启用 web search,并通过 web search cache 提供结果。这个 cache 是 OpenAI 维护的网页结果索引,缓存模式返回的是预先索引好的结果,不会去抓取实时页面。这样可以降低来自任意实时网页内容的 prompt injection 风险,但网页结果仍然应该当作不可信内容处理。

如果你把 sandbox 配置成 full access,web search 默认会改为 live results。要关闭 web search,或者切换到抓取最新数据的 live results,请查看 Config basics。

每当 Codex 查找内容时,你会在 transcript 或 codex exec --json 输出里看到 web_search items。

怎么把图片拖进提示词

你可以把图片直接拖到 prompt composer 里,作为上下文的一部分。

拖拽图片时要按住 Shift。否则 VS Code 会阻止扩展接收这个 drop。

图像生成

你可以不离开编辑器就让 Codex 生成或编辑图片。这个能力适合 UI assets、layout、illustration、sprite sheets,以及工作中快速做 placeholder。想让 Codex 改造或扩展已有素材时,可以把参考图也加到提示词里。

你可以用自然语言提需求,也可以在提示词中显式加入 $imagegen 来调用 image generation skill。

内置图像生成使用 gpt-image-2,会计入你的通用 Codex usage limits。它消耗 included limits 的速度平均比不使用图像生成的类似轮次快 3 到 5 倍,具体取决于 image quality 和 size。更多信息见 Pricing;提示词写法和模型说明见 image generation guide。

如果你要批量生成更多图片,可以在环境变量里设置 OPENAI_API_KEY,然后让 Codex 通过 API 生成图片,这样就按 API pricing 计费。

相关内容

常见问题

OpenAI Codex IDE 扩展怎么切换模型?

在聊天输入框下方的 model switcher 里切换。你可以对不同模型分别选择 low、medium 或 high 的 reasoning effort。

本地任务默认启用 web search,并优先返回 web search cache 里的预索引结果,而不是实时抓取页面。这样能降低 prompt injection 风险,但网页结果仍然不能当作可信来源直接使用。

图片拖不进 VS Code 怎么办?

拖拽图片时要按住 Shift,否则 VS Code 会拦截这个 drop,扩展收不到图片。