告别终端!IDEA 原生支持配置 AI 代理如 Claude Code
速览
JetBrains 的 AI Assistant 插件新增对 ACP(Agent Client Protocol)的支持,允许用户配置 Claude Code、Codex 等终端 AI 代理。ACP 由 Zed 和 JetBrains 发起,旨在规范 IDE 与 AI 代理间的通信。配置后,AI 代理能完整识别全局设置(包括第三方中转站和 MCP),且避免了原终端工具的闪屏问题。用户只需安装对应适配器(如 claude-code-acp)并修改 acp.json 文件即可。
AI 深度解读
背景
对于经常使用 JetBrains 家 IDE(如 IntelliJ IDEA)的开发者来说,在终端中运行 Claude Code、Codex、Gemini CLI 等 AI 编码代理工具一直存在体验问题:这些工具只能在命令行中使用,缺乏图形界面交互,且容易发生内容闪屏(尤其是 Claude Code)。随着 AI Assistant 插件更新,JetBrains 现在支持通过 ACP(Agent Client Protocol)将任何兼容的编码代理集成到 IDE 的 AI Assistant 面板中,从而获得更流畅的 UI 交互体验。
核心内容
ACP(Agent Client Protocol)是由 Zed 和 JetBrains 联合发起的一个开放协议,旨在规范代码编辑器、集成开发环境与编码代理(AI Agent)之间的通信。简单来说,它让 AI Agent 能够与各类 IDE 友好协作。
在 JetBrains 的 AI Assistant 插件中,用户可以通过右上角下拉菜单找到「配置 ACP 智能体」功能,点击后会打开一个 acp.json 文件,用于配置要使用的 ACP 智能体。文中展示了配置完 Claude Code 和 Codex 后的示例文件内容:
{
"agent_servers": {
"Claude Code": {
"command": "claude-code-acp"
},
"Codex": {
"command": "npx",
"args": [
"@zed-industries/codex-acp"
]
}
}
}
Claude Code 配置步骤:
Zed 提供了一个针对 Claude Code 的 ACP 适配器 claude-code-acp,需要通过 npm 全局安装:
npm install -g @zed-industries/claude-code-acp
(注意:官方文档未提及 -g,但实际需要全局安装才能生效。)安装完成后,配置即可生效,在 AI Assistant 中可以看到 Claude Code 选项,并支持选择模式和模型。通过 ACP 使用 Claude Code 可以完整识别全局配置(包括第三方中转站地址、MCP 工具调用),而内置的 Claude Agent 模式只能识别第三方地址,无法读取 MCP。
Codex 配置步骤:
Zed 同样提供了 Codex 的 ACP 适配器 codex-acp。它不需要全局安装,而是直接通过 npx 启动,配置中设置 command 为 npx,args 为 ["@zed-industries/codex-acp"]。配置完成后同样可以在 AI Assistant 中选择使用,并支持模式和模型切换。
关键要点
- 所有配置均在
acp.json文件中完成,该文件可通过 AI Assistant 插件右上角菜单打开。 - Claude Code 的 ACP 适配器需通过
npm install -g @zed-industries/claude-code-acp全局安装。 - Codex 的 ACP 适配器无需安装,直接通过
npx @zed-industries/codex-acp运行。 - 通过 ACP 配置的 Claude Code 能够正常调用用户自定义的 MCP 工具和第三方中转站,而 IDE 内置的 Claude Agent 模式不支持 MCP 读取。
- ACP 方式有效解决了 Claude Code 原生 CLI 的闪屏问题,同时提供了更友好的 UI 交互体验。
- 目前支持的模式和模型选择功能均可在 AI Assistant 面板中正常使用。
意义与影响
ACP 协议的引入为 JetBrains IDE 用户提供了一种统一、标准的方式来集成各类 AI 编码代理,无需再忍受终端工具的 UI 缺陷。这不仅提升了开发效率,还通过协议层面的规范促进了不同工具之间的互操作性。对于重度依赖 JetBrains 生态的开发者而言,这意味着可以将 Claude Code、Codex 等强大的 AI 能力无缝嵌入到熟悉的工作流中,同时保留对 MCP 等高级配置的完整控制。更重要的是,ACP 作为一个由两家知名工具厂商发起的开放标准,未来有望被更多编辑器支持,进而推动整个编码代理生态的融合与进步。
