Codex IDE 扩展功能

Codex IDE 扩展让你可以直接在 VS Code、Cursor、Windsurf 以及其他兼容 VS Code 的编辑器中使用 Codex。它使用与 Codex CLI 相同的智能代理，并共享相同的配置。

向 Codex 发出提示

在编辑器中使用 Codex 无缝地进行对话、编辑和预览更改。当 Codex 通过打开的文件和选中的代码获得上下文时，你可以编写更短的提示词，获得更快、更相关的结果。

你可以在提示词中通过 @ 标记来引用编辑器中的任何文件，例如：

以 `@example.tsx` 为参考，向应用添加一个名为 "Resources" 的新页面，其中包含 `@resources.ts` 中定义的资源列表。

切换模型

你可以通过聊天输入框下方的切换器来切换模型。

调整推理力度

你可以调整推理力度来控制 Codex 在响应前的思考时间。更高的力度有助于处理复杂任务，但响应时间会更长。更高的力度还会消耗更多 token，可能更快耗尽你的速率限制，尤其是在使用更强大的模型时。

使用上面展示的模型切换器，为每个模型选择低(low)、中(medium)或高(high)。从中等(medium)开始，仅在需要更深层次推理时切换到高。

选择审批模式

默认情况下，Codex 在 Agent 模式下运行。在此模式下，Codex 可以自动读取文件、进行编辑并在工作目录中运行命令。但 Codex 仍然需要你的批准才能在工作目录之外工作或访问网络。

当你只想聊天，或者想在做更改之前进行规划时，可以通过聊天输入框下方的切换器切换到 Chat 模式。

如果你需要 Codex 在没有批准的情况下读取文件、进行编辑并运行带网络访问的命令，请使用 Agent (Full Access) 模式。请谨慎操作。

云端委托

你可以将较大的任务委派给云端 Codex，然后在不离开 IDE 的情况下跟踪进度并查看结果。

1. 为 Codex 设置云端环境。
2. 选择你的环境并选择 在云端运行。

你可以让 Codex 从 main 分支运行（适用于开始新想法），或从本地更改运行（适用于完成任务）。

当你从本地对话启动云端任务时，Codex 会记住对话上下文，以便从中断的地方继续。

云端任务跟进

Codex 扩展使预览云端更改变得简单直接。你可以要求后续操作在云端运行，但通常你会希望在本地应用更改以进行测试和完成。当你在本地继续对话时，Codex 也会保留上下文以节省你的时间。

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

网页搜索

Codex 内置了一个第一方网页搜索工具。对于 Codex IDE 扩展中的本地任务，Codex 默认启用网页搜索，并从网页搜索缓存中提供结果。该缓存是 OpenAI 维护的网页结果索引，因此缓存模式返回的是预索引结果，而非获取实时页面。这减少了因任意实时内容导致的提示注入风险，但你仍应将网页搜索结果视为不受信任的。如果你将沙盒配置为完全访问，网页搜索将默认使用实时结果。请参阅配置基础来禁用网页搜索或切换到获取最新数据的实时结果。

每当 Codex 查找信息时，你会在对话记录或 codex exec --json 输出中看到 web_search 条目。

将图片拖放到提示中

你可以将图片拖放到提示输入框中，将其作为上下文包含进来。

拖放图片时请按住 Shift 键。否则 VS Code 会阻止扩展接受拖放操作。

图片生成

无需离开编辑器即可让 Codex 生成或编辑图片。这对于 UI 素材、布局、插图、精灵表以及工作时的快速占位图非常有用。当你希望 Codex 变换或扩展现有素材时，可以在提示中添加参考图片。

你可以用自然语言要求，也可以通过提示中包含 $imagegen 来显式调用图片生成技能。

内置图片生成使用 gpt-image-2，计入你的通用 Codex 使用额度，并且根据图片质量和大小，平均消耗额度的速度比不含图片生成的类似回合快 3—5 倍。详情请参阅定价。提示技巧和模型细节请参阅图片生成指南。

对于大批量的图片生成，请在环境变量中设置 OPENAI_API_KEY，并让 Codex 通过 API 生成图片，这样将适用 API 定价。

另请参阅

• Codex IDE 扩展设置