Appearance
Codex IDE 扩展功能详解：引用编辑器上下文（@file）、按任务类型切换模型（gpt-5.4/gpt-5.4-mini）和推理强度（low/medium/high）、在 Chat 和 Agent 模式间灵活切换、把重型任务委托给 Codex Cloud 在 IDE 里追踪、以及 Web Search 缓存模式与图片拖拽输入。
Codex IDE 扩展功能详解
Codex IDE 扩展为 VS Code、Cursor、Windsurf 和其他 VS Code 兼容编辑器提供 AI Agent 能力，与 Codex CLI 使用同一 Agent 和配置。
使用编辑器上下文 Prompt
Codex 能感知编辑器里打开的文件和选中的代码，写更短的 Prompt 就能得到更准确的结果。
用 @file 引用文件：
text
参考 @example.tsx，在应用里添加一个名为 "Resources" 的新页面，资源列表从 @resources.ts 里读取切换模型
使用对话输入框下方的模型切换器更换模型。
调整推理强度
通过同一个切换器调整推理强度（low / medium / high），控制 Codex 在回复前的思考深度。
- 更高强度可以提升复杂任务的质量，但响应时间更长
- 更高强度消耗更多 token，可能加快达到速率限制，尤其是高能力模型
建议：从 medium 开始，只在需要更深分析时才切换到 high。
选择审批模式
默认模式是 Agent——Codex 可以自动读文件、编辑代码、在工作目录里运行命令，工作目录之外或访问网络时才需要你批准。
只想聊天或规划（不想让 Codex 改代码）时，切换到 Chat 模式。
| 模式 | 权限范围 |
|---|---|
| Chat | 仅对话，不执行操作 |
| Agent | 工作目录内自动读写运行，超出范围需审批 |
| Agent (Full Access) | 包含网络访问，无审批（谨慎使用） |
委托到 Cloud
把耗时较长的任务推给 Codex Cloud 执行，在 IDE 里追踪进度和 Review 结果，无需离开编辑器。
步骤：
- 在 Cloud 环境配置 里设置一个云端环境
- 选择环境，点击 Run in the cloud
可以从 main 分支运行（适合从零开始的新想法），也可以从本地改动运行（适合接着当前进度完成任务）。
从本地对话开始 Cloud 任务时，Codex 会记住对话上下文，Cloud 端可以接续继续工作。
跟进 Cloud 任务
Cloud 任务完成后，IDE 扩展支持直接预览改动。常见工作流是：把 Cloud 改动应用到本地，本地测试和收尾。切回本地继续对话时，Codex 保留之前的上下文，无需重新描述背景。
也可以在 Codex Cloud 界面 查看所有 Cloud 任务。
Web Search
Codex IDE 扩展内置 Web Search 工具，本地任务默认开启，使用缓存模式（OpenAI 维护的预索引结果）。
缓存模式返回的是已索引的历史结果，而不是实时抓取——减少了来自任意网页内容的 Prompt 注入风险，但结果可能不是最新的。即便如此，仍应把 Web 结果视为不可信来源。
配置 Full Access 沙箱 后，Web Search 默认切换为实时模式。
禁用 Web Search 或强制使用实时模式：参考 基础配置。
Codex 调用 Web Search 时，在 transcript 或 codex exec --json 输出里会出现 web_search 条目。
拖拽图片输入
把图片拖拽到 Prompt Composer 里作为上下文。
注意：在 VS Code 里，普通拖拽会被编辑器拦截，需要按住
Shift再拖拽图片，Codex 扩展才能接收。
常见问题
Q: Agent 模式和 Agent (Full Access) 的区别是什么？
A: Agent 模式限制在工作目录内自动运行，访问网络或工作目录外的资源需要你批准。Agent (Full Access) 去掉了这些限制，包括网络访问，没有审批步骤——适合在隔离环境或明确信任的场景使用，日常开发不建议开启。
Q: 切换到 Chat 模式有什么实际用处？
A: 规划阶段（想先讨论方案再决定是否执行）或者只想问问题、理解代码时用 Chat 模式，避免 Codex 在你还没想清楚的时候就开始改文件。
Q: Cloud 任务的结果怎么应用到本地？
A: Cloud 任务完成后，IDE 扩展会显示预览 diff，点击应用即可把改动 apply 到本地文件。之后可以继续本地对话，Codex 会保留 Cloud 阶段的上下文。