生态指南 · 2026 年 9 月 12 日
ACP 客户端与兼容编程 Agent
客户端是你面对的宿主，Agent 是编程智能，ACP 是中间的 JSON-RPC 契约。名单变化很快——以你实际运行的那一对的能力声明为准。
Client
你看着的宿主
编辑器、IDE、终端、桌面应用、网页、笔记本、手机或聊天桥。
Agent
编程进程
原生 ACP 二进制，或 claude-agent-acp、codex-acp 这类维护中的适配器。
Protocol
共享契约
initialize、session、session/prompt、session/update、权限、elicitation，以及协商后的能力。
ACP 客户端：编辑器、IDE 和其他表面
支持面远不止某一款编辑器。官方目录还跟踪终端、桌面、Web、笔记本、移动、即时通讯、框架和连接器。
编辑器与 IDE
- Zed — First-class external agent support
- JetBrains IDEs — Built-in ACP client in AI Assistant
- Visual Studio Code — ACP Client, ACP Pro, Multicoder, Poolside
- Neovim — CodeCompanion, Avante, agentic.nvim, hermes.nvim
- Emacs — agent-shell.el
- Obsidian — Agent Client, Agent Console, Copilot, Harness
- Qt Creator — Official ACP Client plugin
- Sublime Text — ACP plugin
- Visual Studio — Poolside Assistant
- Unity — Editor plugins for in-engine agent sessions
其他客户端表面
- CLI / TUI — acpx, Toad, Hydra, Martty, Nori, Hash
- Desktop & web — Kepler, Superlite, Capsule, Devin Desktop, Codeg, Panda
- Mobile — Happy, Agmente, Runmote, Shellular, VACP
- Messaging — Telegram, Discord, Slack, WeChat, QQ, Lark, Matrix
- Notebooks — Jupyter kernel, marimo, DuckDB, Alchemy
- Frameworks — LangChain Deep Agents, Koog, Mastra, LlamaIndex, ACP Kit
兼容 ACP 的 Agent 与适配器
有的 Agent 原生实现 ACP，有的包一层现有 CLI。Registry 只收录握手时声明认证方法的 Agent。
常用 Agent
- Claude Agent，经维护中的 claude-agent-acp 适配器（v0.76）
- Codex CLI，经官方 codex-acp 适配器（v1.11）
- Gemini CLI、GitHub Copilot CLI、Cursor、Grok Build
- Goose、OpenCode、Junie、Cline、Qwen Code、Kimi CLI、Factory Droid、Devin、Amp、Auggie
自己实现
- TypeScript SDK（@agentclientprotocol/sdk）1.0
- Rust SDK（agent-client-protocol）1.0，草案 v2 需显式打开
- 官方 Python、Java、Kotlin SDK
- 声明能力，不要假设每个客户端都有文件、终端或 elicitation
如何检查 ACP 兼容性
目录上有名字只是起点，不保证你需要的每个方法都实现了。
1
选定客户端表面
编辑器、IDE、TUI、桌面应用或聊天桥——能力支持并不一样。
2
看 Agent 怎么分发
原生二进制、npx/uvx 适配器，还是翻译其他协议的桥。
3
读声明的能力
关注 loadSession、session/list、session/resume、session/fork、终端和认证。
4
生产环境留在稳定 v1
生产用 protocolVersion 1。把 protocolVersion 2 当实验。
客户端与 Agent FAQ
选型或自研时的短回答。