Integrations

CC Switch

CC Switch is a cross-platform desktop app that manages provider profiles for multiple terminal coding agents — Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI, and Hermes Agent — from a single tray menu. It is community-maintained and not affiliated with ezrouter.

Use CC Switch instead of editing environment variables when you need to flip between several providers (for example, official Anthropic for one task and ezrouter for another).

Install

Pick the channel for your OS:

OS	Install command / file
macOS	`brew install --cask cc-switch` (or download the DMG from Releases)
Windows	MSI installer or portable ZIP from Releases
Linux (Arch)	`paru -S cc-switch-bin`
Linux (Debian / Ubuntu)	`.deb` from Releases
Linux (Fedora / RHEL)	`.rpm` from Releases
Linux (any)	`.AppImage` from Releases

Launch CC Switch after installing; it lives in the system tray.

Add ezrouter as a provider

CC Switch ships with 50+ provider presets. ezrouter is not a built-in preset today, so add it as a custom entry:

Open the CC Switch window and pick the agent you want to configure

(start with Claude Code).

Click Add Provider → Custom.
Fill in the form:

Name: ezrouter
Base URL: https://www.ezrouter.dev/anthropic for Claude Code

and other Anthropic-surface agents; https://www.ezrouter.dev/v1 for OpenAI-surface agents like OpenCode.

API key: paste a key from the

ezrouter dashboard.

Default model (or per-tier models, if the agent supports

tiers): pick from your key's allowlist — see GET /v1/models.

Save. CC Switch writes the configuration into the target agent's

own settings file or environment, so the agent picks it up on next launch.

To switch back later, click the CC Switch tray icon and pick a different provider profile. The change applies to new agent sessions; existing running sessions keep the provider they started with.

Per-agent base URL reference

Agent	Surface	Base URL value
Claude Code	Anthropic-compat	`https://www.ezrouter.dev/anthropic`
OpenCode	OpenAI-compat	`https://www.ezrouter.dev/v1`
Codex	OpenAI-compat	`https://www.ezrouter.dev/v1`
Gemini CLI	OpenAI-compat (via ezrouter translation)	`https://www.ezrouter.dev/v1`

For Claude Code specifically, leave the trailing /v1 off the base URL — Claude Code's runtime appends the path itself. The other agents expect /v1 included. See each integration page for details: Claude Code, OpenCode.

Storage location

CC Switch keeps its own state in:

~/.cc-switch/cc-switch.db — SQLite database of provider entries
~/.cc-switch/settings.json — app settings
~/.cc-switch/backups/ — automatic backups

Your ezrouter API key lives inside the SQLite file. Treat that path the same way you would treat a .env file with secrets.

Troubleshooting

Switch did not take effect — restart the target agent. CC Switch

rewrites configuration on disk; running agent processes do not reload mid-session.

401 invalid_api_key after switching — the key in the CC Switch

profile is wrong or has trailing whitespace. Edit the profile and re-paste.

Model not found — the model name in the CC Switch profile is

not in your ezrouter key's allowlist. Query GET /v1/models.

Next steps

Claude Code — env-var configuration without a GUI.
OpenCode — /connect flow without a GUI.
API overview — surface choices

the base URLs above point at.