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 里跟踪进度和查看结果,不用离开编辑器。
- 先为 Codex 配置一个 cloud environment。
- 选择你的 environment,然后点 Run in the cloud。
你可以让 Codex 从 main 开始运行,适合启动新想法;也可以基于本地改动运行,适合继续完成一个任务。
当你从本地对话发起 cloud task 时,Codex 会记住上下文,方便接着上次的内容继续做。
云端任务怎么继续处理
Codex extension 让你预览云端改动更直接。你可以继续要求它在云端执行后续步骤,但很多时候更常见的做法是把改动应用到本地,再测试和收尾。你在本地继续对话时,Codex 也会保留上下文,减少重复说明。
你也可以在 Codex cloud interface 里查看云端任务。
Web search
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。
Codex 在 IDE 里为什么默认会查 web search?
本地任务默认启用 web search,并优先返回 web search cache 里的预索引结果,而不是实时抓取页面。这样能降低 prompt injection 风险,但网页结果仍然不能当作可信来源直接使用。
图片拖不进 VS Code 怎么办?
拖拽图片时要按住 Shift,否则 VS Code 会拦截这个 drop,扩展收不到图片。