ACP adapter for Claude Agent SDK
claude-agent-acp
An Agent Client Protocol adapter that runs a Claude Agent SDK agent inside Zed and other ACP-compatible editors
Install
npm install @agentclientprotocol/claude-agent-acp@previewPreview build from the README. The stable version is published on npm under the same name without the tag.
This is third-party code. Review the repository files before installing.
What it does
The adapter implements an ACP agent on the official Claude Agent SDK, so any compatible client can work with Claude like a built-in assistant. It supports @-mentions, images, tool calls with permission prompts, edit review, TODO lists, terminals, custom slash commands and client MCP servers. Nested subagents appear as separate sessions when the client supports it. Protocol extensions carry long-running session goals, structured errors and model settings.
Who it is for. For developers who want to use Claude in Zed, JetBrains or another ACP client instead of the terminal.
Good fit when
- You work in an ACP-capable editor and want a Claude agent in the side panel
- You want to review agent edits in the editor UI
- You build your own ACP client and need a ready agent to test against
Not a fit when
- Claude Code in the terminal is enough for you
- You have no access to the Anthropic API or a Claude subscription
Example request
Set up Claude as an external agent in my editor via ACPLimitations
It runs on Claude Agent SDK, so it needs access to Anthropic, which is unavailable from Russia without a VPN. Separate subagent sessions appear only when the client supports them. Preview builds are published from every commit and may be unstable.
How to disable. Remove the agent from the ACP client settings and run npm uninstall @agentclientprotocol/claude-agent-acp if you installed the package manually.
Security check
- The agent edits files and runs terminal commands
- Sends project code to the Anthropic API
README in short
The README briefly describes the adapter and lists the supported protocol features, including several extensions with their own docs. It shows how to install a preview build from npm. A separate section explains how client and adapter negotiate subagent sessions. Apache 2.0 licensed.
FAQ
What is ACP?
Agent Client Protocol, an open protocol for editors to talk to agents, similar to how LSP connects editors to language servers.
How do I try unreleased changes?
Install the package with the preview tag, published on every push to main.
Related
Open-source personal AI assistant on your own machine: answers in Telegram, Slack, Discord and WhatsApp, extended with skills and plugins
A self-improving agent from Nous Research with a TUI, messaging gateway, cron jobs and skills it writes itself
An open source coding agent for the terminal and desktop with build and plan modes
Open prompt library with a Claude Code plugin, MCP server and CLI: search, fetch and improve prompts and skills from an agent