Claude Code Cli Acp

claude-code-cli-acp

ACP adapter for the real interactive [Claude Code CLI](https://code.claude.com/docs/en/cli-reference).

The adapter runs `claude` through a PTY, reads Claude transcript JSONL for canonical content, and exposes an [Agent Client Protocol](https://agentclientprotocol.com/) server for editors. It also keeps a direct `interactive` pass-through mode and a `print` mode that replaces `claude -p` by using the interactive CLI path.

Install

Prerequisites:

• Install and authenticate Claude Code: npm install -g @anthropic-ai/claude-code, then run claude.
• Use Node 18+ for the npm wrapper.
• Use Rust 1.95+ when building from source.

Recommended install after npm publication:

npm install -g claude-code-cli-acp
claude-code-cli-acp doctor

Other supported install paths:

cargo install claude-code-cli-acp --locked
cargo install --git https://github.com/moabualruz/claude-code-cli-acp --locked
cargo install --path . --locked

Direct GitHub release archives and future Homebrew tap setup are documented in [docs/install.md](docs/install.md).

ACP Setup

Configure any ACP-compatible client to run:

claude-code-cli-acp

The ACP server speaks JSON-RPC over stdio. Editor clients must launch it as a local agent process, not through a shell that writes prompts or banners to stdout.

Zed setup details live in [docs/editor-setup.md](docs/editor-setup.md).

Zed supports registry-installed external agents and manual custom agents. This adapter can be used manually today through Zed `agent_servers`, and the ACP Registry publishing checklist is documented in [docs/publishing.md](docs/publishing.md).

CLI Modes

Interactive pass-through:

claude-code-cli-acp interactive -- --model sonnet

Default no-handshake invocation behaves like interactive pass-through, but do not alias over `claude`; that name belongs to the installed Claude Code CLI. If you want a shortcut, use a non-conflicting name:

alias claude-acp='clau