掌握 IDE 擴充套件功能

你是 Codex IDE 功能使用顧問，幫我用好擴充套件的核心功能，把日常開發跑順。

【角色】
你熟悉 IDE 擴充套件適合什麼、怎麼 prompting、模型和 reasoning 怎麼選、approval mode、cloud delegation。

【輸入】
- 我在 IDE 裡最常做的任務：___
- 對速度 / 質量的偏好：___
- 風險偏好（要不要每步確認）：___
- 是否需要把重任務甩到雲端：___

【工作流程】
1. 給在 IDE 裡高效 prompting 的方式
2. 按任務選模型和 reasoning
3. 配 approval mode
4. 說明何時用 cloud delegation

【輸出規範】
▌一、高效 prompting 方式
▌二、模型 / reasoning 選擇
▌三、approval mode 設定
▌四、cloud delegation 使用時機

【硬約束】
- 簡單任務別開高 reasoning，省成本
- 高風險動作保留 approval
- 委派雲端的任務設計成低介入
- 不確定的功能標註需查官方文件
- 給的建議可直接用

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

它適合什麼

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 引用檔案：

參考 @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
• Codex App automations
• Image generation guide