---
title: "掌握 IDE 扩展功能"
description: "梳理 Codex IDE extension 的核心功能，包括编辑器上下文、local/cloud 模式、图片输入和代码审查。"
verifiedAt: "2026-05-06"
---

import { Cards, Card } from 'fumadocs-ui/components/card';

Codex IDE extension 让你在 VS Code、Cursor、Windsurf 和其他 VS Code-compatible editors 中直接使用 Codex。它和 Codex CLI 使用同一个 agent，也共享同一套 configuration。

> [!TIP]
> IDE 扩展最适合“边看代码边改”。长任务、后台任务和团队自动化不要硬塞在本地编辑器里完成。

<Cards>
  <Card title="IDE features" href="https://developers.openai.com/codex/ide/features">
    官方 IDE extension 功能总览。
  </Card>
  <Card title="CLI App IDE Cloud" href="/docs/codex/understanding/cli-app-ide-cloud">
    判断什么时候留在 IDE，什么时候交给 App 或 Cloud。
  </Card>
  <Card title="IDE settings" href="https://developers.openai.com/codex/ide/settings">
    配置模型、审批、上下文和本地行为。
  </Card>
</Cards>

## 它适合什么

```mermaid
flowchart LR
    Editor["open files / selection"] --> Prompt["short prompt"]
    Prompt --> Agent["Codex IDE agent"]
    Agent --> Diff["preview changes"]
    Diff --> LocalTest["local test / review"]
    Agent --> Cloud["optional cloud delegation"]
```

IDE 扩展适合：

- 读当前文件和选中代码。
- 小范围编辑。
- 预览 diff。
- 结合编辑器上下文补代码。
- 从本地对话把大任务交给 cloud。

不适合：

- 无人值守定时任务。
- 大范围后台重构。
- 没有本地验证方式的生产修复。
- 需要长期并行探索的多分支任务。

## Prompting Codex

在编辑器里可以 chat、edit 和 preview changes。当 Codex 能拿到 open files 和 selected code 作为 context 时，你可以写更短的 prompts。

也可以在 prompt 中用 `@file` 引用文件：

```text
参考 @example.tsx，为应用新增一个名为 "Resources" 的页面，页面内容使用 @resources.ts 中定义的资源列表。
```

用 IDE 时不要把整段文件复制进 prompt。优先选中代码、打开相关文件、用 `@file` 明确引用。

## 模型和 reasoning

模型可以用 chat input 下方的 switcher 切换。

Reasoning effort 控制 Codex 在回答前思考多久。更高 effort 对复杂任务有帮助，但响应更慢，也会使用更多 tokens，更快消耗 rate limits。

默认从 `medium` 开始。只有当任务需要更深分析、设计权衡或复杂 bug 分诊时，再切到 `high`。

## Approval mode

默认 `Agent` mode 下，Codex 可以：

- 读取文件。
- 修改文件。
- 在 working directory 内运行命令。

如果要在 working directory 外工作，或访问 network，仍需要你的 approval。

只想聊天或先 planning 时，切到 `Chat`。需要无审批读取、修改、运行带 network access 的命令时，才考虑 `Agent (Full Access)`。启用前先确认 Git 状态、任务范围和回滚方式。

## Cloud delegation

IDE 可以把较大任务交给 cloud 中的 Codex，然后在 IDE 里跟踪进度和 review 结果。

常见用法：

1. 设置 cloud environment。
2. 选择 environment。
3. 点击 `Run in the cloud`。

可以从 `main` 分支启动，适合新想法；也可以从 local changes 启动，适合完成正在进行中的任务。

从 local conversation 启动 cloud task 时，Codex 会带上 conversation context。云端完成后，你可以 preview cloud changes，继续 cloud follow-up，或把 changes 应用到本地再测试收尾。

## Web search

Codex 内置 first-party web search tool。IDE local tasks 默认启用 web search，并从 OpenAI 维护的 web search cache 返回结果，而不是直接抓取实时页面。

这个设计减少任意 live content 带来的 prompt injection 暴露面，但网页结果仍要当作不可信内容处理。

如果 sandbox 配成 full access，web search 默认使用 live results。需要关闭 web search 或切换 live/cached 模式时，到配置页处理。

## 图片输入和生成

你可以把图片拖进 prompt composer 作为 context。VS Code 里拖放图片时按住 `Shift`，否则编辑器可能阻止 extension 接受 drop。

也可以让 Codex 在 IDE 里生成或编辑图片。适合：

- UI assets。
- layout 草图。
- illustrations。
- sprite sheets。
- 开发阶段临时视觉素材。

图片生成会计入 Codex usage limits。模型名、限额倍率和价格都属于高频变化信息，实际使用前看官方 pricing 和 image generation guide。

## 验收清单

- prompt 使用了 open files、selection 或 `@file`，没有粘贴整段无关上下文。
- 选择的模型和 reasoning effort 匹配任务难度。
- Agent / Chat / Full Access 模式选择符合风险。
- Cloud task 有明确 environment、起始分支和回收方式。
- Web search 结果被当作不可信输入处理。
- 图片生成不会把敏感界面或私有素材误发给不该使用的环境。
- 最终 diff 在 IDE 中 preview，并在本地或 cloud 里完成验证。

## See also

- [Codex IDE extension settings](https://developers.openai.com/codex/ide/settings)
- [Codex App automations](https://developers.openai.com/codex/app/automations)
- [Image generation guide](https://developers.openai.com/api/docs/guides/image-generation)
