Codex IDE Features：编辑器内功能地图

适用场景

这篇手册帮助你理解 IDE Extension 里常见控件：文件引用、模型切换、reasoning effort、approval mode、cloud delegation。

你可以把它当作 IDE 里的 Codex 控制台说明书。

功能总览

| 功能 | 解决什么问题 | 建议 | | --- | --- | --- | | 文件引用 | 指定 Codex 应该看哪些文件 | 用 @file 明确上下文 | | 选区上下文 | 只让 Codex 看局部代码 | 适合函数级修改 | | 模型切换 | 根据任务复杂度选模型 | 简单任务不用过度升配 | | Reasoning effort | 控制思考深度 | 默认 medium，复杂任务再 high | | Approval mode | 控制能否改文件和跑命令 | 先 Chat 后 Agent 更稳 | | Cloud delegation | 把大任务交给云端 | 适合长任务和 PR |

文件引用

官方示例展示了在 prompt 中引用文件的方式：

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

中文可以这样写：

请参考 @example.tsx 的页面结构，在应用里新增 Resources 页面，数据来源参考 @resources.ts。保持现有设计风格。

比起粘贴整段代码，引用文件更稳定，也更容易让 Codex 找到相关 imports、类型和样式。

模型和推理强度

IDE Extension 可以在输入框下方切换模型，并调整 reasoning effort。使用建议：

• low：简单解释、小改动、低风险任务。
• medium：默认选择，适合大多数编码任务。
• high：复杂调试、跨模块改造、安全分析。

推理越高，响应可能越慢，也会更快消耗额度。不要把 high 当默认值。

审批模式

官方文档说明，默认是 Agent 模式。在这个模式下，Codex 可以读取文件、编辑代码，并在工作目录里运行命令；越过工作目录或访问网络时仍需要审批。

常见选择：

| 模式 | 适合场景 | | --- | --- | | Chat | 解释、计划、评审，不想让它改文件 | | Agent | 让 Codex 正常编辑和运行命令 | | Agent Full Access | 少数需要更高权限且你理解风险的任务 |

第一次处理不熟悉项目时，先用 Chat 模式让 Codex 分析，再切 Agent 修改。

Cloud delegation

IDE Extension 可以把更大的任务交给 Codex Cloud。常见流程：

1. 配置 cloud environment。
2. 在 IDE 中选择环境。
3. 选择 Run in the cloud。
4. 让 Codex 从 main 或本地改动出发。
5. 在 IDE 中跟踪结果并应用 diff。

适合场景：

• 长时间运行测试。
• 大范围重构。
• 从本地改动继续完成任务。
• 想把结果作为 PR 或 diff 审查。

常见错误

不要在 Agent Full Access 下做你没有把握的任务。更高权限不是更高质量。

不要只用自然语言描述“当前文件”。如果文件关键，直接引用或把选区加入上下文。

不要把所有文件都引用进来。上下文太多反而会让任务发散。

小结

IDE Extension 的能力可以理解为“上下文精确 + 控制灵活”。用文件引用和选区缩小范围，用模型和 reasoning effort 控制成本，用审批模式控制风险，用 cloud delegation 承接大任务。