IDE 整合

IDE 整合解決的是“終端 Agent 如何理解編輯器現場”的問題。Gemini CLI 官方提供兩條路徑：VS Code companion extension 和 Agent Client Protocol。

IDE 整合提升上下文感知和 diff 審閱體驗，但不會替代 git diff、測試和人工 review。

VS Code companion

Companion extension 會把 IDE 裡的即時上下文交給 CLI：

常用命令：

/ide install
/ide enable
/ide disable
/ide status

當 Gemini CLI 建議修改檔案時，可以直接在 IDE diff 裡審閱。你可以接受、拒絕，也可以先手動改 diff 再接受。

如果在 CLI 裡選擇本輪自動允許變更，後續變更可能不再彈出 IDE diff，需要按團隊風險偏好配置。

Agent Client Protocol 是面向 IDE 與 AI coding agent 的互操作協議。Gemini CLI 可作為 ACP agent，被支援 ACP registry 的 IDE 發現和安裝。

適合 ACP 的場景：

IDE 整合給的是編輯器現場，不是完整專案真相。最近訪問檔案、游標位置和選區只能幫助 Gemini CLI 理解你當前正在看什麼，不能替代它重新讀取相關程式碼、配置和測試。複雜任務仍然要讓它顯式列出會讀取哪些檔案。

原生 diff 也只是審閱體驗，不是質量保證。接受 diff 前還要確認檔案範圍、執行測試，並檢查是否覆蓋了 IDE 當前沒開啟的相關檔案。

如果 Gemini CLI 執行在 sandbox 中，IDE 整合還需要能訪問 IDE companion。macOS Seatbelt、Docker 或 Podman 環境要額外確認網路連通性。

先用只讀任務確認 CLI 能看到當前 workspace 和最近檔案，再讓它提出一個小 diff，確認 IDE 原生 diff 能展示、拒絕和接受都正常。sandbox 或容器中執行時，還要確認 companion 連線不會因為網路隔離失敗。

再做一次負例：關閉 IDE integration 後，讓 CLI 處理同一任務，確認它不會誤以為仍能讀取編輯器選區。這樣可以區分“專案檔案上下文”和“IDE 即時上下文”。

團隊教程裡建議把 IDE 整合作為增強體驗，而不是唯一操作路徑。讀者沒有對應 IDE 時，仍應能用純 CLI 完成同一任務。

截圖應標註 IDE、擴充套件版本和 Gemini CLI 版本，便於複查。VS Code、Open VSX、JetBrains/Zed 這類入口差異很大，教程不能只寫“開啟 IDE 整合”。

如果 CLI 不在已開啟的 IDE workspace 內執行，可能出現 workspace mismatch 或無法使用 IDE context 的錯誤。排錯時先確認 CLI cwd 和 IDE 開啟的目錄一致。