在 JetBrains IDE 中原生调用 Claude Code,不再依赖终端命令行。通过 ACP 协议实现即插即用式 AI 编程代理集成,完整支持 MCP 工具链、多模型切换与 Plan/Act 模式,为专业开发者提供更可控、更深度的代码协作体验。
智能速览
ACP 是由 Zed 主导、Anthropic 与 Google 参与制定的开放协议,类比 LSP,统一 AI Agent 与 IDE 的通信标准
JetBrains 自 2025 年底起在 AI Assistant 插件中正式支持 ACP Client,首批兼容 IntelliJ IDEA 2024.2–2025.3.x
Claude Code 通过官方适配器 @zed-industries/claude-code-acp 实现 ACP Server,支持完整 MCP 工具(文件系统、Git、数据库等)
ACP 方式可自由切换 claude-sonnet-4.5、claude-opus-4.5 等模型,并兼容 OneAPI、GLM 等第三方中转服务
对比内置 Claude Agent,ACP 方案在工具调用能力、模型灵活性和工作模式上具备显著优势,但配置门槛略高
除 Claude Code 外,Gemini CLI、Docker cagent 等已支持 ACP,生态正快速扩展至 Cursor、Windsurf 等主流工具
精华内容
当 AI 编程代理不再被锁死在终端或封闭插件中,而是以标准化协议接入熟悉的 IDE 界面,开发者的控制权与工作流完整性才真正回归。
ACP 是什么
ACP(Agent Client Protocol)是由 Zed Industries 牵头制定的开源协议,定义了 AI Agent 与编辑器之间的 JSON-RPC 2.0 通信规范。其设计目标是终结重复适配:过去每个 Agent(如 Claude Code、Cursor)需为每款 IDE 单独开发接口;现在只要 Agent 实现 ACP Server、IDE 实现 ACP Client,即可即插即用。该协议已在 JetBrains 全家桶、Zed、VS Code 等主流环境落地,底层复用 LSP 成熟机制,确保稳定性与可维护性。
为什么选 ACP
实测显示,使用 ACP 接入 Claude Code 后,MCP 工具调用成功率提升至 100%,而内置 Claude Agent 在相同项目中仅支持 API 地址配置,无法触发本地 Python 脚本或 Git 命令。在 30 个典型重构任务中,ACP 方案平均响应延迟降低 18%,Plan 模式下任务分解准确率高出 27%。这源于 ACP Agent 作为独立进程运行,可直接访问系统资源,无需经由 IDE 插件沙箱限制。
配置全流程
需满足三要素:IntelliJ IDEA 2024.2 或更高版本、AI Assistant 插件 v2025.12+、全局安装 claude-code-acp。关键步骤包括:在 AI Assistant 面板点击「配置 ACP 智能体」生成 acp.json;将本地 claude-code-acp 可执行路径写入配置项;保存后刷新模型列表即可启用。实测在 macOS 与 Windows WSL2 环境下,从安装到首次对话成功平均耗时 6 分钟,失败主因是 pnpm 全局 bin 路径未加入系统 PATH。
能力实测对比
在 Spring Boot 项目中测试单元测试生成任务:ACP + Claude Code 生成覆盖率 82.3%,含完整 Mockito 注入逻辑;内置 Agent 生成覆盖率 61.5%,缺失事务边界与异常分支处理。在跨文件重构场景中,ACP 方案成功调用 Git diff 工具识别变更范围,准确率 94%;内置方案仅依赖 IDE 索引,对未提交修改识别率为 0。此外,ACP 支持同时配置 Gemini CLI 与 Docker cagent,可在同一项目中按需切换不同 Agent。
适用场景判断
适合三类用户:需要调用本地工具链(如数据库连接、私有 API、CI 脚本)的后端工程师;习惯 Claude Code Plan 模式进行分步编程的算法开发者;长期维护多语言混合项目的全栈团队。不适合追求开箱即用的新手或仅需基础问答功能的轻量用户——后者启用内置 Agent 仅需 1 次点击,而 ACP 配置需完成 Node.js 环境、包管理器、路径变量三项准备。
ACP 不仅是一项技术集成方案,更是开发者对 AI 工具主权的一次重申。它把选择权交还给使用者:用哪个模型、调哪些工具、走哪种工作流。随着 JetBrains 推进 per-project ACP 配置与社区适配器激增,未来一个项目对应一套定制化 AI 协作环境将成为常态。下一个值得追问的问题是:当协议层趋于统一,真正的差异化会落在哪里?