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 打开的目录一致。