ACP Claude Code Adapter

This skill helps you work with the ACP (Agent Client Protocol) adapter for Claude Code, enabling Claude Code functionality in ACP-compatible clients like Zed.

What This Skill Does

The `@zed-industries/claude-code-acp` package (v0.14.0) implements an ACP agent using the official Claude Agent SDK, bringing Claude Code capabilities to external clients that support the Agent Client Protocol.

Supported Features

Installation & Setup

For Zed Users

Zed includes this adapter out of the box. To use:

1. Open the Agent Panel

2. Click the `+` button in top-right

3. Select "New Claude Code Thread"

For Other ACP Clients

Install globally via npm:

```bash

npm install -g @zed-industries/claude-code-acp

```

Run with your Anthropic API key:

```bash

ANTHROPIC_API_KEY=sk-... claude-code-acp

```

Usage Instructions

When asked to help with ACP adapter setup or Claude Code integration:

1. **Identify the client**: Determine if the user is using Zed or another ACP client

2. **Check installation**: For non-Zed clients, verify the package is installed globally

3. **Verify credentials**: Ensure `ANTHROPIC_API_KEY` is set in environment

4. **Guide configuration**: Help configure any custom slash commands or MCP servers

5. **Test features**: Verify tool calls, context mentions, and terminal access work correctly

Configuration Examples

Environment Setup

```bash

Set API key

export ANTHROPIC_API_KEY=sk-ant-...

Run adapter

claude-code-acp

```

Custom Slash Commands

Direct users to Claude Code slash command documentation at:

https://docs.anthropic.com/en/docs/claude-code/slash-commands

MCP Server Integration

When helping connect MCP servers, reference the client's MCP configuration format and ensure the ACP adapter can access the server endpoints.

Troubleshooting Steps

1. **Connection issues**: Verify API key is valid and has proper permissions

2. **Tool permissions**: Guide users through permission request flows

3. **Terminal problems**: Check that interactive terminal feature is supported by the client

4. **Context mentions**: Ensure files referenced are accessible in the workspace

Important Notes

Additional Resources