跳到主要内容

本文为非官方中文翻译,内容以 OpenAI 官方英文文档为准。
官方来源:https://developers.openai.com/codex/ide/features

Codex IDE extension 功能

你可以使用 Codex IDE extension 完成的事情

Codex IDE extension 让你可以在 VS Code、Cursor、Windsurf 以及其他兼容 VS Code 的编辑器中直接使用 Codex。它使用与 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

在模型之间切换

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

Codex model switcher

调整推理强度

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

使用上面展示的同一个模型切换器,并为每个模型选择 lowmediumhigh。建议从 medium 开始,只有在你需要更深入的处理时再切换到 high

选择批准模式

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

当你只想聊天,或者希望在进行更改之前先规划时,请使用聊天输入框下方的切换器切换到 Chat

Codex approval modes

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

云端委派

你可以将更大的任务卸载到云中的 Codex,然后无需离开 IDE 即可跟踪进度并审查结果。

  1. 为 Codex 设置一个云环境
  2. 选择你的环境,并选择 Run in the cloud

你可以让 Codex 从 main 运行(适合开始新想法),也可以基于你的本地更改运行(适合完成某项任务)。

从 IDE 启动云任务

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

云任务后续处理

Codex 扩展让预览云端更改变得很直接。你可以要求后续操作继续在云端运行,但通常你会希望将更改应用到本地,以便测试并完成工作。当你在本地继续对话时,Codex 同样会保留上下文,从而节省你的时间。

将云任务加载到 IDE 中

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

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

每当 Codex 进行查询时,你都会在转录记录或 codex exec --json 输出中看到 web_search 条目。

将图片拖放到提示中

你可以将图片拖放到提示编辑器中,将它们作为上下文包含进去。

拖放图片时按住 Shift。否则 VS Code 会阻止扩展接收拖放内容。

图像生成

你可以让 Codex 在不离开编辑器的情况下生成或编辑图像。这对于 UI 资源、布局、插图、sprite sheet,以及你在工作过程中快速制作占位图都很有用。当你希望 Codex 转换或扩展现有资源时,可以在提示中添加参考图像。

你可以使用自然语言提出请求,或者在提示中包含 $imagegen 来显式调用图像生成 skill。

内置图像生成功能使用 gpt-image-2,会计入你的一般 Codex 使用限制,并且平均会比不包含图像生成的类似轮次快 3-5 倍地消耗已包含限额,具体取决于图像质量和尺寸。详情请参阅定价。有关提示技巧和模型详情,请参阅图像生成指南

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

另请参阅