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,针对每个模型选择 lowmediumhigh。默认先从 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 里切换。你可以对不同模型分别选择 lowmediumhigh 的 reasoning effort。

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

图片拖不进 VS Code 怎么办?

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