在 IntelliJ IDEA 中通过 ACP 协议接入 Claude Code，实现 IDE 原生使用 Claude AI 编程助手

1. ACP 是什么

ACP（Agent Client Protocol）是 AI 代理与 IDE 的标准通信协议，类似 LSP，让 AI 工具与编辑器“即插即用”，无需为每个 IDE 单独开发插件。

2. 代理客户端协议的工作原理

代理客户端协议允许代理和客户端通过暴露双方可调用的方法和发送通知来相互通知事件来通信。 通信模型： 该协议遵循 JSON-RPC 2.0 规范，包含两种类型的消息： 方法 ：期望结果或错误的请求-响应对 通知 ：单向消息，不期待回复

3. 支持范围

• • IDE：JetBrains 全家桶
• • AI 代理：Claude Code、Gemini CLI、Docker's cagent 等
• • 底层：基于 JSON-RPC 2.0，通过 stdin/stdout 通信

4. 为什么要用 ACP 接入 Claude Code

• • 在 IDEA 原生 UI 里用 Claude Code，不用切终端
• • 完整支持 MCP 工具（文件读写、Git、数据库、自定义 API）
• • 可自由切换模型、支持自定义 API 中转站
• • 拥有 Plan / Code 专属工作模式

5. 完整配置步骤

1. 1. 更新 IDEA 并启用 AI Assistant 插件
2. 2. 全局安装适配器：pnpm install -g @zed-industries/claude-agent-acp
3. 3. 在 AI Assistant 打开右上角点击「配置 ACP 智能体」生成 acp.json
4. 4. 填写 claude-agent-acp 绝对路径
5. 5. 重启后即可在模型列表选择 Claude Code

以上功能需要在claude中配置好模型，比如火山引擎方舟 Coding Plan，目前用了下来如果不是高强度使用，只要使用方舟Coding Plan lite即可.获取9折优惠，可回复【邀请码】

npm install -g @anthropic-ai/claude-code

然后再参考自动化助手ark-helper，配置完成即可。

6. ACP 对比 IDEA 内置 Agent

• • ACP：支持 MCP、模型自由、Plan 模式、配置稍复杂
• • 内置：开箱即用、功能有限、不支持完整 MCP

7. 常见问题

• • 失败：检查命令是否为绝对路径、环境变量、Claude Code 本身可运行
• • 无响应：查看日志、检查进程是否启动

8. 适用人群

JetBrains IDE 重度用户、需要 Claude Code 完整工具链、想在 IDE 内一站式开发。