ACP（Agent Client Protocol）让Gemini CLI无缝入驻IDEA：无需切换窗口，直接在AI Assistant中@Gemini，即可理解项目、改代码、执行命令。四步配置（装CLI→查路径→写acp.json→重启IDE），支持项目感知与终端联动，开发效率跃升！

这玩意儿能干啥？

想象一下这个场景：

你正在 IDEA 里疯狂敲代码，突然卡壳了。以前你得：切终端 → 打开 Gemini CLI → 复制代码 → 粘贴 → 等回复 → 再切回 IDEA。
现在？直接在 AI Assistant 聊天框里@Gemini，它就能看懂你的项目、帮你改代码、甚至跑终端命令！✨

这就是 Agent Client Protocol (ACP) 的魔法：让外部 AI 代理（比如 Gemini CLI）直接"住进"你的 IDE，无缝协作。

---

📋 前置条件（别跳过，否则踩坑别怪我）

要求	说明	检查命令
IntelliJ IDEA	2025.3 或更新版本（其他 JetBrains 全家桶也行）	Help → About
Node.js	建议 20+ 版本，Gemini CLI 的"粮食"	node --version
Gemini CLI	主角登场，必须先装好	gemini --version

---

🔧 四步走，集成搞定！

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

npm install -g @google/gemini-cli

装完验货：

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

💡 小贴士：如果权限报错，试试加 sudo（Mac/Linux）或用管理员身份运行终端（Windows）。

---

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

⚠️ 重点：把这个路径复制好，马上要用！如果用 nvm，确保路径指向当前激活的 Node 版本，不然 IDEA 会一脸懵："这文件呢？"

---

Step 3️⃣：配置 ACP 的"户口本" —— acp.json

JetBrains IDE 会去固定位置找这个配置文件：

系统	文件路径
macOS / Linux	~/.jetbrains/acp.json
Windows	%USERPROFILE%\.jetbrains\acp.json

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

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

🔍 配置项逐行解读：

字段	作用	为什么重要
"Gemini CLI"	在 IDEA 里显示的名字	随便起，但建议别叫"那个谁"😅
"command"	gemini 可执行文件路径	填错=找不到人，直接罢工
"args"	启动参数	--experimental-acp 是关键！没它 Gemini 会以为你要开终端聊天
"use_idea_mcp": true	允许访问 IDEA 内置 MCP 服务	✨核心功能！让 Gemini 能读你的项目结构、打开的文件
"use_custom_mcp": true	支持自定义 MCP 服务	扩展玩法，比如连数据库、调用外部 API

🤔 深度思考：为什么叫 experimental？
因为 ACP 协议还在演进中，未来可能有 breaking changes。生产环境使用建议先在小项目试水，别一上来就让它重构核心模块（血泪教训预警⚠️）。

---

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

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

🎉 看到聊天框里出现 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