English
主导航

Codex IDE 扩展功能

使用 Codex IDE 扩展可以做什么

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

提示 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

切换模型

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

Codex model switcher

调整推理力度

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

使用上方显示的同一模型切换器,并为每个模型选择 low, medium, or high 。当你需要更深入的分析时,请从 medium,并仅切换到 high 开始。

选择审批模式

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

当你只想聊天,或者想在做出更改前进行规划时,请通过聊天输入框下方的切换器切换到 Chat 使用聊天输入框下方的切换器。

Codex approval modes

如果你需要 Codex 在无需批准的情况下读取文件、进行编辑、运行命令并访问网络,请使用 Agent (Full Access)。在执行此操作之前请务必谨慎。

云委托

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

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

你可以让 Codex 从 main (适用于开启新想法),或者根据你的本地更改运行(适用于完成任务)。

Start a cloud task from the IDE

当你从本地对话启动云端任务时,Codex 会记住对话上下文,以便它能从你上次停下的地方继续。

云端任务跟进

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

Load a cloud task into the IDE

你还可以在以下位置查看云端任务: Codex 云界面.

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

每当 Codex 查找内容时,您会在记录中看到 web_search 条目,或者在 codex exec --json 输出中看到它们。

将图像拖放到提示词中

你可以将图像拖放到提示词编辑器中,以将其作为上下文包含在内。

按住 Shift 的同时放置图像。否则 VS Code 会阻止扩展接受放置操作。

图像生成

无需离开编辑器,即可要求 Codex 生成或编辑图像。这在你工作时处理 UI 素材、布局、插图、精灵图和快速占位符时非常有用。当你希望 Codex 转换或扩展现有素材时,可以在提示词中添加参考图像。

您可以使用自然语言提问,或者通过包含以下内容来显式调用图像生成技能: $imagegen in your prompt.

内置图像生成使用 gpt-image-2,会计入你的常规 Codex 使用额度,并且根据图像质量和尺寸,平均比不含图像生成的类似轮次快 3-5 倍地消耗包含额度。详情请参阅 定价。有关提示技巧和模型详情,请参阅 图像生成指南.

对于大批量的图像生成,请在您的环境变量中设置 OPENAI_API_KEY 并要求 Codex 通过 API 生成图像,以便适用 API 定价。

另请参阅