---
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="/zh-Hant/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)
