手把手教你把 Gemini CLI 塞进 IntelliJ IDEA:ACP 集成指南
发布时间:2026-11-02 | 浏览:1
手把手教你把 Gemini CLI 塞进 IntelliJ IDEA:ACP 集成指南
微信 微博 分享文章到微博 复制链接 复制链接到剪贴板
🎯 先说人话:这玩意儿能干啥?
你正在 IDEA 里疯狂敲代码,突然卡壳了。以前你得:切终端 → 打开 Gemini CLI → 复制代码 → 粘贴 → 等回复 → 再切回 IDEA。 现在? 直接在 AI Assistant 聊天框里@Gemini ,它就能看懂你的项目、帮你改代码、甚至跑终端命令!✨
这就是 Agent Client Protocol (ACP) 的魔法:让外部 AI 代理(比如 Gemini CLI)直接"住进"你的 IDE,无缝协作。
📋 前置条件(别跳过,否则踩坑别怪我)
Step 1️⃣:安装 Gemini CLI(如果还没装)
💡 小贴士:如果权限报错,试试加 sudo (Mac/Linux)或用管理员身份运行终端(Windows)。
Step 2️⃣:找到 gemini 可执行文件的"真实住址"
ACP 配置需要 绝对路径 ,不能玩"我以为你知道"的游戏。
🍎 macOS / 🐧 Linux 用户:
⚠️ 重点:把这个路径复制好,马上要用!如果用 nvm ,确保路径指向 当前激活的 Node 版本 ,不然 IDEA 会一脸懵:“这文件呢?”
Step 3️⃣:配置 ACP 的"户口本" —— acp.json
JetBrains IDE 会去固定位置找这个配置文件:
新建或编辑文件,填入以下内容 (记得替换 command 里的路径!):
🤔 深度思考 :为什么叫 experimental ? 因为 ACP 协议还在演进中,未来可能有 breaking changes。生产环境使用建议先在小项目试水,别一上来就让它重构核心模块(血泪教训预警⚠️)。
Step 4️⃣:重启 IDEA,召唤 Gemini!
重启 IntelliJ IDEA (配置生效的仪式感)
打开 AI Assistant 面板(通常在右侧工具栏)
找到 Agent 选择器 (下拉菜单或 ⋯ 更多按钮)
选择 “Gemini CLI”
🎉 看到聊天框里出现 Gemini CLI 标识?恭喜,集成成功!
📦 附:一键配置脚本(懒人福利)
macOS / Linux 用户 ,复制粘贴这条命令,自动创建 acp.json (记得先改路径!):
在此一键设置昵称,即可参与社区互动!
*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。
*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。
与10000+优质创作者共同成长