Agent Setup Overview
Agent Client supports multiple AI agents through the Agent Client Protocol (ACP). This section covers how to set up each supported agent.
Supported Agents
| Agent | Provider | Package |
|---|---|---|
| Claude Code | Anthropic | @zed-industries/claude-code-acp |
| Codex | OpenAI | @zed-industries/codex-acp |
| Gemini CLI | @google/gemini-cli | |
| Custom Agents | Various | Any ACP-compatible agent |
Common Setup Steps
All agents follow a similar setup pattern:
- Install the agent package via npm
- Find the installation path using
which(macOS/Linux) orwhere.exe(Windows) - Configure the path in Settings → Agent Client
- Set up authentication (API key or account login)
WSL Mode (Windows)
For Windows users, we recommend using WSL Mode for better compatibility:
- Install WSL
- Install Node.js and agents inside WSL
- Enable WSL Mode in Settings → Agent Client
- Use Linux-style paths (e.g.,
/usr/local/bin/node)
Switching Agents
Once you have multiple agents configured, you can switch between them using the dropdown in Settings → Agent Client.