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 | @agentclientprotocol/claude-agent-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
- Set up authentication (API key or account login)
The plugin resolves bare command names through your login shell's PATH, so path configuration is often not needed. If the agent is not found automatically, use which (macOS/Linux) or where.exe (Windows) to find the path and configure it in Settings → Agent Client.
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 ⋮ menu in the chat header. To change the default agent for new chat views, go to Settings → Agent Client → Default agent.