写代码的时候，你是不是经常觉得编辑器和本地的 AI 助手像是“两条平行线”？打开 IDE 要用这个工具，切到聊天窗口又要换另一个软件。今天给大家拆解一个开箱即用的解决方案：通过 ACP（Agent Client Protocol，代理客户端协议）把 AI 编码代理直接“长”进 Zed 和 JetBrains 系列编辑器里。全程无需挂载第三方插件，纯粹依靠编辑器与 AI 的原生握手协议，配置极简，效率拉满。

核心概念：ACP 到底解决了什么？

传统插件开发容易把 AI 锁死在特定生态里。ACP 则是一套开放标准，它明确规定了分工：编辑器只负责提供对话界面、差异对比（diffs）和最终确认权；背后的 AI 只要实现这个协议，就能直接坐上去干活。对于开发者来说，这意味着“一次接入，到处通用”，不再被厂商绑定。

AtlariX 就是一个完美践行此协议的开源 AI 编码代理。它仅靠一条命令 atlarix acp 就能响应请求。下面教你如何在两大主流编辑器中快速部署。

第一步：安装命令行客户端

由于 ACP 机制是以本地程序形式启动 AI 进程的，我们需要先安装 Atlarix 的 CLI（命令行工具）。任选一种适合你系统的安装方式：
– Node.js 环境：npm i -g atlarix
– macOS/Linux Homebrew：brew install amariahak/atlarix/atlarix
– 或者前往官方一键安装页获取脚本：CLI 安装页

安装完成后，在终端输入 atlarix --version，看到版本回显即表示就绪。

第二步：Zed 编辑器配置

Zed 对配置文件的解析非常直观，只需修改一个 JSON 文件：
1. 打开 Zed 设置目录，找到 ~/.config/zed/settings.json。
2. 将以下配置段落粘贴进去。注意保持 JSON 语法的括号和引号对应：

// 定义自定义代理服务器，指定命令行为 atlarix 并追加 acp 参数
"agent_servers": { 
  "Atlarix": { 
    "type": "custom", 
    "command": "atlarix", 
    "args": ["acp"] 
  } 
}

1. 保存文件后，激活右侧的 Agent Panel（代理面板）。
2. 创建新线程，在下拉列表中选中 Atlarix。
3. 首次交互会触发浏览器跳转授权，登录后即可永久复用。

第三步：JetBrains 全家桶（IDEA/PyCharm/WebStorm/GoLand）接入

只要你使用的 JetBrains 产品内置了 AI Assistant 功能，操作路径同样清晰：
1. 在编辑器右侧打开 AI 聊天框，点击顶部代理菜单。
2. 依次选择 More Agents → Add Custom Agent。
3. 系统会自动生成或打开 ~/.jetbrains/acp.json，在此填入以下配置：

// 请将 /path/to/atlarix 替换为你实际获取到的绝对路径
"agent_servers": { 
  "Atlarix": { 
    "command": "/path/to/atlarix", 
    "args": ["acp"] 
  } 
}

💡 如何获取正确的绝对路径？
– macOS / Linux 终端执行：which atlarix
– Windows PowerShell 执行：where atlarix

拿到路径后替换占位符即可。重点提示：此方式完全绕过了官方订阅墙，你不需要购买 JetBrains AI 服务也能流畅使用高级 AI 代理。

接入后的真实体感

连接建立后，编辑器不会变得臃肿，反而会因为底层协议的支持带来原生级体验：
– 工作模式原生映射：Build（构建）、Explore（探索）、Plan（规划）、Debug（调试）、Review（审查）五种模式，会直接出现在编辑器自带的模式选择器中。选哪个，AI 就按对应范式输出。
– 改动零风险：所有代码修改和指令执行，必须先经过编辑器弹出的权限审批弹窗。你不点头，文件系统不会发生任何变更。
– 可视化计划执行：开启 Plan 模式后，AI 生成的实施步骤会渲染为编辑器原生的计划列表。点击执行按钮，模式选择器会自动切至 Build 模式，带你一步步跑完流程。
– 上下文智能跳转：AI 回复中提及的文件名和行号，点击即可直接锚定到代码具体位置。过往对话记录也会无缝同步至编辑器的侧边栏历史面板。

账号管理与多端同步

AtlariX 支持双通道登录，灵活应对不同场景：
– 编辑器内唤起浏览器授权登录
– 终端手动运行 atlarix login

两种方式最终都在本机完成凭证绑定。登录成功后，AI 会自动加载你的个人账户余额、已购模型额度以及你自己的 API Key。数据流转全程闭环，不经过第三方中转。

值得注意的是，会话状态是云端实时同步的。你在 Zed 里创建的对话，在 JetBrains 或 Atlarix 独立客户端打开仍是同一个 Session。其他 Atlarix 实例甚至能通过消息总线与它互通。编辑器仅仅是一个更顺手的话筒，真正的算力大脑始终在线。

补充说明

目前 Atlarix 已向 ACP 注册中心提交收录，未来 Zed 与 JetBrains 有望实现“注册中心一键发现安装”。在此之前，手动写入配置文件是最稳妥高效的方案。对于暂不支持 ACP 协议的 VS Code、Cursor、Kiro 和 Windsurf，AtlariX 团队也专门开发了原生扩展插件，详细适配方法可查阅 编辑器指南。

技术演进的终局一定是打破孤岛。拥抱开放协议，把 AI 能力彻底嵌入你的日常研发流水线。动手配一次，你会重新定义高效编程的标准。

直达网址：https://www.atlarix.dev/blogs/add-coding-agent-zed-jetbrains-agent-client-protocol