ACP adapter for Claude Agent SDK CLI
claude-agent-acp
An Agent Client Protocol adapter that runs a Claude Agent SDK agent inside Zed and other ACP-compatible editors
- 2,706 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The agent edits files and runs terminal commands
- Sends project code to the Anthropic API
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-agent-acpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The agent edits files and runs terminal commands
- Sends project code to the Anthropic API
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.
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.
Discussion
No questions or reviews yet.
Related
CLI toolsAn engineering system for coding agents: 71 agents, 311 skills, hooks, memory, rules and the AgentShield security scanner
One runtime for Claude Code, Codex, OpenCode and more: a run counts as done only when checks the agent did not write pass
A read-only MCP server for the HeyClaude registry: an agent finds skills, MCP servers and hooks and gets ready install commands
Multi-agent orchestration for Claude Code: teams, roles, autopilot and task routing across skills and subagents
claude-code-sub-agents
Claude Code Subagents Collection
A collection of specialized subagents for Claude Code: frontend, backend, data, infrastructure, testing, security
CCS
CCS - Claude Codex Switch
A CLI that switches Claude Code between accounts, providers and local models without editing configs
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.