如何将Gemini CLI集成到IntelliJ IDEA？2026年ACP协议配置全教程

🎯 先用人话说明：这个集成能做什么？

想象一个场景：你在 IDEA 里疯狂写代码，突然卡壳了。以前你必须：切换到终端 → 打开 Gemini CLIA command-line interface for Google's Gemini AI model, providing code generation and technical support. → 复制代码 → 粘贴 → 等待回复 → 再切回 IDEA。现在？直接在 AI Assistant 聊天框里 @Gemini，它就能看懂你的项目、帮你改代码，甚至执行终端命令！✨

这就是 Agent Client Protocol (ACPAgent Client Protocol（代理客户端协议），一种让外部AI代理集成到IDE中的协议。) 的魔力：让外部 AI 代理（例如 Gemini CLI）直接“住进”你的 IDE，实现无缝协作。

---

📋 前置条件（别跳过，否则容易踩坑）

---

🔧 四步完成集成

Step 1️⃣ 安装 Gemini CLI（如果还未安装）

npm install -g @google/gemini-cli

安装后验证：

gemini --version
# 看到版本号？恭喜，第一步完成！✅

---

Step 2️⃣ 找到 gemini 可执行文件的“真实路径”

ACP 配置需要绝对路径，不能模糊。

🍎 macOS / 🐧 Linux 用户：

which gemini
# 示例输出：/Users/yourname/.nvm/versions/node/v22.16.0/bin/gemini

🪟 Windows 用户：

where gemini
# 示例输出：C:\Program Files\nodejs\gemini.cmd

---

Step 3️⃣ 配置 ACP 的“户口本” —— acp.json

JetBrains IDE 会从固定位置读取此配置文件：

新建或编辑文件，填入以下内容（记得替换 command 里的路径）：

{
  "agent_servers": {
    "Gemini CLI": {
      "command": "/你的/实际/路径/gemini",
      "args": [
        "--experimental-acp"
      ],
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}

🔍 配置项逐行解读

---

Step 4️⃣ 重启 IDEA，召唤 Gemini！

1. 重启 IntelliJ IDEA（配置生效的必要步骤）
2. 打开 AI Assistant 面板（通常在右侧工具栏）
3. 找到 Agent 选择器（下拉菜单或 ⋯ 更多按钮）
4. 选择 “Gemini CLI”

---

📦 附：一键配置脚本（懒人福利）

macOS / Linux 用户，复制粘贴以下命令，自动创建 acp.json（记得先确认路径正确）：

mkdir -p ~/.jetbrains && cat > ~/.jetbrains/acp.json << 'EOF'
{
  "agent_servers": {
    "Gemini CLI": {
      "command": "$(which gemini)",
      "args": ["--experimental-acp"],
      "use_idea_mcp": true,
      "use_custom_mcp": true
    }
  }
}
EOF

---

总结

通过以上四个步骤，你可以将 Gemini CLI 深度集成到 JetBrains IDE 中，借助 ACP 协议实现 AI 助手与 IDE 的双向协作。从项目结构感知到终端命令执行，这一集成显著提升了开发效率。建议在非生产项目上先进行体验，并持续关注 ACP 协议的演进。

常见问题（FAQ）

集成Gemini CLI到IntelliJ IDEA需要哪些前置条件？

需要IntelliJ IDEA 2025.3或更新版本、Node.js 20+、以及已安装的Gemini CLI（通过npm install -g @google/gemini-cli）。

如何配置acp.jsonJetBrains IDE的配置文件，用于注册外部AI代理，需放置在指定路径。文件来注册Gemini CLI？

新建~/.jetbrains/acp.json（Windows为%USERPROFILE%.jetbrains\acp.json），填入包含gemini绝对路径的JSON，并添加--experimental-acp参数。

集成后如何在IDEA中使用Gemini CLI？

重启IDEA后，在AI Assistant聊天框中输入@Gemini，即可直接与项目交互，如修改代码或执行终端命令。