一、前言

IDEA的AI Assistant,可以理解成类似于cursor的agent那种形式吧,对于习惯用Claude Code的人,如果想在IDEA中体验GUI版的Claude Code,可以将Claude Code以AI Assistant的形式来用。

因为IDEA 2025.3 版本的AI Assistant支持了ACP(Agent Client Protocol),ACP大概可以理解成是一种规范各种Cli Agent一种协议吧,比如Claude Code、Codex、Gemini Cli等。所以只要把CC支持上ACP,就可以实现。

成品演示图:

Image_2025-12-26_22-49-56_zsqzt5lq.zka

二、教程

0. 首先保证Claude Code可用

保证命令行版Claude Code可用,后续AI Assistant中用Claude Code其实就是用的你本机安装的Claude Code,所以MCP啊,提示词啊这些配置都会用上

1. 安装IDEA 2025.3 版本,并激活

本文不赘述安装和激活步骤了

2. 设置IDEA区域为“美洲”

设置 - 搜索“区域”就能看到了,理论上非国内应该都可以。这一步是防止AI Assistant风控

3. “激活”AI Assistant

首先你激活了IDEA,IDEA是能用了,但AI Assistant是订阅制的,所以初始是用不了的,这时候需要登录jetbrain账号(新注册的也行,反正不用绑卡啥都不用),登录后会提示你免费试用(如果有试用机会的话)或升级订阅(给钱!),都不要管。

打开 设置 - 工具 - AI Assistant - Models And API Keys,第三方服务商中随便输一个能用的apikey和url。不要怕,不会用到这个apikey的额度,这一步只是告诉IDEA“我不用你的订阅,我有自己的key,快给我用”。

4. 安装claude-code-acp

这一步可以理解成是给CLaude Code套一层acp。

执行:

npm install @zed-industries/claude-code-acp

后续如果不行就执行全局试试:

npm install -g @zed-industries/claude-code-acp

5. 在AI Assistant中配置acp

经过第3步,你现在可以打开AI Assistant的面板窗口了,在面板右上角三个点的按钮中,选择“配置ACP智能体”

然后就会自动打开acp.json​文件,在里面配置claude-code-acp​即可,如:

{
    "agent_servers": {
        "Claude Code": {
            "command": "claude-code-acp.cmd"
        }
    }
}

PS: 其中Windows的话就是claude-code-acp.cmd​,Mac的话就是claude-code-acp

6. 聊天窗口选择Claude Code,开始体验

创建AI Assistant聊天窗口,左下角选择“Claude Code”,注意不是“Claude Agent”。如果聊天窗口出现权限设置和模型设置,就说明成功了

三、随便叨叨

目前这种方式用Claude Code,比cc官方插件、各种第三方插件,体验都要好,mcp能用,UI交互好,对我来说基本可以了。当然也没有命令行版的功能齐全了,比如斜杠命令用不了,没有statusline等。只能说多一个选择多一个出路。

另外这个方案应该也有一定的局限性,毕竟claude-code-acp不是A社官方出的,所以A社更新,这个acp不一定会及时更新,但zed家出品,应该也比很多个人开发者出品的更新要频繁吧(我猜)