在 JetBrains IDE 中通过 ACP 协议集成 Claude Code等外部工具

随着 AI 编程助手日渐普及，编辑器正在从"简单的聊天窗口"向"可插拔的智能代理平台"演进。JetBrains 推出的 ACP（Agent Client Protocol） 就是这个趋势中的关键。它允许 IDE 与不同的 AI agent 统一通信，让开发者在熟悉的 JetBrains 环境中自由选择和切换 AI 工具。

本文将介绍 ACP 的概念、在 JetBrains IDE 中的使用方法，并结合 Claude Code 的具体接入案例，为你提供完整的操作指南。

什么是 ACP？

JetBrains 官方将 ACP 描述为一种连接 IDE 和 AI agent 的开放协议。它的作用类似于 LSP（Language Server Protocol）对语言服务器的作用：IDE 负责提供上下文和编辑器状态，AI agent 负责理解项目、提出代码修改建议、执行命令并返回结果。

ACP 的设计目标是打破厂商绑定，让开发者可以在同一 IDE 中自由切换不同 AI agent。JetBrains 提供了 ACP Registry，集中分发兼容的 agent，使安装和管理更方便。

ACP 兼容 agent 有两种接入方式：

通过 Registry 安装：直接在 IDE 内部选择想用的 agent，系统自动下载和配置。
自定义 agent 配置 ：在 acp.json 中手动添加 agent 命令、参数和环境变量，支持内部或非公开的 agent。

ACP 对 JetBrains 用户的意义

过去，大多数 AI 工具只能通过独立窗口或终端使用，无法深度嵌入 IDE 流程。而 ACP 的出现，使 AI agent 能够以原生方式融入编辑器，直接在代码上下文中提供建议、诊断和修改。

值得注意的是，ACP 兼容 agent 不依赖 JetBrains AI 服务订阅，这对已有自己偏好模型或团队内部工具的用户非常实用。JetBrains 也提供了完整的管理功能，包括 agent 安装、更新、卸载和日志收集，使其成为可持续维护的集成方案。

Claude Code 在 JetBrains 中的使用

如果你希望在 JetBrains IDE 中使用 Claude Code，官方提供了专用插件，而不仅仅依赖 ACP。该插件支持 IntelliJ IDEA、PyCharm、Android Studio、WebStorm、PhpStorm、GoLand 等 IDE，提供了丰富的功能：

差异查看与选区上下文共享
代码诊断和自动修复建议
与外部 Claude Code 终端交互

安装方式也很简单：从 JetBrains Marketplace 安装 Claude Code 插件，重启 IDE 后即可使用。安装完成后，你可以在 IDE 内的集成终端运行 claude 命令，或者在外部终端通过 /ide 连接到当前 IDE。

总结两条使用路径：

官方 JetBrains 插件：专为 Claude Code 提供，功能全面且稳定。
ACP 兼容 agent：适合希望尝试其他 AI agent 或团队内部工具的用户。两者互不冲突，反而可以互补。

如何在 JetBrains IDE 中接入 ACP agent

通过 Registry 安装 agent
打开 IDE 内的 AI Chat 界面，选择 "Install From ACP Registry"，在 Agents 页面中选择所需 agent。系统会自动下载所需文件，并在首次使用时完成授权。
添加自定义 agent
如果 Registry 中没有想用的 agent，可以选择 "Add Custom Agent"，IDE 会生成 ~/.jetbrains/acp.json，用户可手动配置 agent 命令、参数和环境变量。

⚠️ 注意：当前 JetBrains 文档指出，ACP agent 暂不支持 WSL 环境，请在 Windows 用户中谨慎操作。

演示：在Windows中将Claude Code加入自定义agent

确保电脑中已安装并配置好**Nodejs** 和**Claude Code**
bash 复制代码
```
npm i -g @anthropic-ai/claude-code
```
安装claude code的acp适配器
bash 复制代码
```
npm i -g @agentclientprotocol/claude-agent-acp
```
在IDE中打开AI聊天 窗口，点击右上角的三个点，再点击"添加自定义智能体 "
修改弹出的acp.json ，配置自定义智能体的名称、指令（注意把"用户"换成实际用户名）
保存文件后即可在代理列表 中看到选项
选择刚刚添加的智能体Claude Code，并测试

谁适合使用 ACP？

ACP 特别适合以下用户：

想在多个 AI agent 之间自由切换的开发者
希望接入团队内部或私有 agent 的团队
追求 AI 工具与 IDE 上下文、文件操作和诊断深度集成的用户

对于这类用户，ACP 提供了比传统插件更灵活的集成方式，同时保持 JetBrains 原生 IDE 的工作体验。

结语

JetBrains 的 ACP 并不是一个简单的聊天插件，而是 IDE 与 AI agent 的标准化接口。对于 Claude Code 等成熟工具，官方提供了稳定插件；而对于其他 AI 工具或内部 agent，ACP 提供了开放的接入方式。未来，选择 AI 编程助手不再只是"能不能用"，而是"今天我想用哪一个 agent"。