IDEA 2026.1 通过 ACP 接入 Claude Code

splend21 Lv1
  2026-04-01 22:59:39 2026-04-01 22:59:39 Created   2026-04-02 22:50:36 2026-04-02 22:50:36 Updated    

IDEA通过ACP接入ClaudeCode有一段时间了，虽然使用终端功能更加强大一点，当然我也考虑过一些插件，比如CCGUI，ClaudeCode官方的 JetBrains 插件 ，但总是感觉在IDEA里用的舒服，这几天还将IDEA从2025.3更新到了2026.1，遇到了一些问题，今天在这里记录一下。

什么是ACP

ACP (Agent Client Protocol) 是一个开放协议，用于标准化代码编辑器（IDE）与AI编程智能体之间的通信。

它由 JetBrains 和 Zed 联合开发，旨在实现”任意智能体 × 任意编辑器”的互操作性，打破供应商锁定

准备工作

  1. IDE 版本：IntelliJ IDEA 2024.2 到 2025.3.x 或更高版本。ACP 支持从 2025 年底开始逐步集成，确保你的 IDEA 已更新到支持 ACP 的构建。
  2. AI Assistant 插件：确保已安装并启用
  3. Claude Code：已安装并能正常运行
  4. 安装 ACP 适配器：@agentclientprotocol/claude-agent-acp（原@zed-industries/claude-code-acp，现已废弃）
1
pnpm add -g @agentclientprotocol/claude-agent-acp

注意一定要是全局安装

如何在IDEA中使用ACP

打开 AI Assistant 的聊天面板，点击右上角选择下拉框，你会看到 「添加自定义智能体」 选项。

image-20260402224554408

点击后，IDE 会自动打开一个 acp.json 配置文件，填写如下内容。

1
2
3
4
5
6
7
{
  "agent_servers": {
    "Claude Code": {
      "command": "C:/Users/28109/AppData/Local/pnpm/claude-agent-acp.CMD"
    }
  }
}

注意 “command” 是 全局 bin 目录里看到 claude-agent-acp 可执行命令路径，这里要替换成你自己的

全局bin目录通过如下命令查看

1
pnpm bin -g

最终就可以达到如下的效果：

image-20260402224721016

在最下方可以切换不同的模型，切换ClaudeCode的不同模式，这一点和CLI中是一样的，这里我采用的模型是智谱的GLM模型，不同厂商的模型可以统一使用开源工具CCSwitch方便地管理，这里就不过多赘述了，感兴趣的读者可以自行探索~

Comments
On this page
IDEA 2026.1 通过 ACP 接入 Claude Code