claude-agent-acp
Use Claude Agent SDK from any ACP client
The claude-agent-acp adapter bridges the Claude Agent SDK with any ACP-compatible client, allowing developers to leverage Claude's official agent capabilities through the provider-neutral Agent Client Protocol. It translates Claude Agent SDK features—including context mentions, tool calls with permission requests, interactive terminals, and slash commands—into the ACP wire format. The adapter supports advanced features like nested subagent transcripts, session-scoped goals, and structured error handling, making Claude's agent functionality accessible across multiple client environments without vendor lock-in.
Key Features
Use Cases
- 01Running Claude Agent SDK workflows from non-Anthropic ACP clients
- 02Building multi-agent systems with nested subagent transcripts and coordinated tool calls
- 03Integrating Claude's slash commands into custom development environments
- 04Executing long-running coding tasks with interactive terminal access and goal tracking
- 05Leveraging client-side MCP servers alongside Claude's agent capabilities
- 06Implementing structured error handling and recovery in agent-driven workflows
Related Agents
View morehermes-agent
The agent that grows with you
agency-agents
A complete AI agency at your fingertips - From frontend wizards to Reddit community ninjas, from whimsy injectors to reality checkers. Each agent is a specialized expert with personality, processes, and proven deliverables.
openinterpreter
A coding agent for open models like Kimi K3
cline
Autonomous coding agent as an SDK, IDE extension, or CLI assistant.
claude-agent-acp — FAQ
What is claude-agent-acp?+
claude-agent-acp is an ACP (Agent Client Protocol) adapter that enables the official Claude Agent SDK to work with any ACP-compatible client. It translates Claude's agent features into a provider-neutral protocol, allowing developers to use Claude's capabilities across different AI client platforms.
How do I install claude-agent-acp?+
Install the npm package @agentclientprotocol/claude-agent-acp and configure it in your ACP-compatible client. The specific setup depends on your client environment, but typically involves importing the adapter and initializing it with your Claude Agent SDK configuration.
Which AI clients work with claude-agent-acp?+
Any ACP-compatible client can use this adapter. Clients that support ACP 1.2 with the subagent-transcript capability can access nested transcript rendering; other ACP clients will receive flattened transcripts as a fallback.
Do I need API keys or prerequisites to use this adapter?+
Yes, you need access to the Claude Agent SDK, which requires Anthropic API credentials. You'll also need an ACP-compatible client environment and Node.js to run the npm package.
Is claude-agent-acp free to use?+
The adapter itself is open source under the Apache License 2.0, but using the underlying Claude Agent SDK requires an Anthropic API subscription, which has usage-based costs.
What are nested subagent transcripts in claude-agent-acp?+
Nested subagent transcripts allow clients to render hierarchical agent conversations where one agent spawns sub-agents. Clients opt in by setting clientCapabilities._meta['subagent-transcript'] = true, and the adapter then forwards nested messages linked via parentToolUseId metadata.
How do I install claude-agent-acp?+
Open the source repository on GitHub and follow its README. claude-agent-acp is a agent — MCP Agents Market links you directly to the official repo.
Is claude-agent-acp free?+
claude-agent-acp is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.