zed-claude-code

Zed Claude Code acts as a translation layer between Claude Code via the ACP (Agent Client Protocol) and MCP (Model Context Protocol). It exposes MCP-based tooling to Zed users and translates tool invocations and results between Claude's SDK and the Zed environment. Primary capabilities include file operations (read, write, edit with diff visualization), multi-edit batching, permission-based tool execution, and caching to improve performance. The server runs an internal MCP tool HTTP interface that coordinates with the Claude Code SDK, enabling session management, tool calls, and results streaming. You can run the server directly with NPX or BunX and configure Zed to point at it for external-agent integrations.

How to use the tooling: start the server with npx zed-claude-code or bunx zed-claude-code, then configure Zed to load the agent by specifying command and arguments in agent_servers. The agent will handle translation of tool requests from Claude into MCP tool calls, perform file operations and other tasks through the MCP interface, and return results along with location and diff data for display in Zed. The server also supports a permissive workflow where users approve or deny tool executions within Zed, and it will auto-install dependencies like @anthropic-ai/claude-code on first run if needed.

Prerequisites:

• Node.js 18+ (for development and runtime of the MCP server)
• npm (comes with Node.js)
• Claude Code (for local usage and testing) and authentication configured

Install and run:

1. Clone the repository (optional for usage, not required for single-shot usage via npx): git clone https://github.com/suxxes/zed-claude-code.git cd zed-claude-code

2. Install dependencies: npm install

3. Build (if you're developing or running from source): npm run build

4. Run in development mode (optional): npm run dev

5. Run tests (optional): npm test

Usage without cloning the repo (recommended for end users):

• Run the MCP server directly via NPX: npx zed-claude-code
• Or via BunX (if you prefer BunX): bunx zed-claude-code

6. If configuring in Zed, add the agent server entry with command and args as shown in the README/example.

Notes and tips:

• The server will automatically install @anthropic-ai/claude-code on first run if not present.
• Ensure Node.js 18+ is installed for compatibility with TypeScript and tooling.
• For external agent configuration in Zed, use the agent_servers object with command and args matching the MCP payload (e.g., { "command": "npx", "args": ["zed-claude-code"] }).
• If you encounter authentication or session errors, verify Claude Code login status and API key configuration as described in the Security section of the README.
• MCP tool names follow the mcp__zcc__* naming convention for internal clarity; maintain snake_case in external APIs while keeping camelCase internally.
• Use the provided diff visualization and location data to review file changes; always confirm permissions via the User approval workflow when attempting tool execution.