Connect CC Switch to TeamoRouter

CC Switch is an open-source desktop app that manages provider configuration for Claude Code, Claude Desktop, Codex, Gemini CLI, OpenCode, OpenClaw, and Hermes Agent in one panel.

1. Install CC Switch 3.16.5 or later

macOS users can install it with Homebrew:

brew install --cask cc-switch

Or download the installer from CC Switch Releases:

• macOS: .dmg or .zip
• Windows: .msi installer or portable .zip
• Linux: .deb, .rpm, or .AppImage

2. Connect Claude Code CLI

For installing Claude Code from scratch, see Connect Claude Code CLI to TeamoRouter.

If CC Switch and Claude Code are already installed, add TeamoRouter as a Claude Code provider:

Add the Claude Code CLI provider in CC Switch

1. Open CC Switch and switch to the Claude Code tab.

2. Click the orange plus button in the top-right corner.
3. Find TeamoRouter in Preset providers, or search for TeamoRouter.

4. Enter your TeamoRouter API key.

5. Click Add to save.

Enable TeamoRouter in the Claude Code tab

Return to the Claude Code tab, click Enable on the TeamoRouter provider card, and open Claude Code.

3. Connect Claude Desktop

Install Claude Desktop from the Claude download page:

• macOS: download the .dmg, or run brew install --cask claude
• Windows: download and run the .exe installer

If CC Switch and Claude Desktop are already installed:

Add the provider

1. Open CC Switch and switch to the Claude Desktop tab.
2. Click the orange plus button in the top-right corner.
3. Find TeamoRouter in Preset providers, or search for TeamoRouter.

4. Enter your API key.

5. Click Add to save.

Enable TeamoRouter

Return to the Claude Desktop tab and click Enable on the TeamoRouter provider card. CC Switch will confirm that the switch succeeded and that Claude Desktop must be restarted.

Fully restart Claude Desktop before using it.

4. Connect Codex

For installing Codex from scratch, see Connect Codex CLI to TeamoRouter.

If CC Switch and Codex are already installed:

Add the provider

1. Open CC Switch and switch to the Codex tab.
2. Click Add provider.
3. Find TeamoRouter in Preset providers, or search for TeamoRouter.

4. Paste the API key you created in the TeamoRouter dashboard.
5. Click Add to save.

Enable TeamoRouter

Return to the Codex tab and click Enable on the TeamoRouter provider card. Codex does not hot-switch providers, so restart the running Codex terminal process.

5. Connect Gemini CLI

Gemini CLI support in CC Switch is still under development.

6. Connect OpenCode

See Connect OpenCode to TeamoRouter. CC Switch does not support OpenCode connection yet.

7. Connect OpenClaw

See Connect OpenClaw to TeamoRouter.

8. Connect Hermes Agent

If CC Switch and Hermes Agent are already installed, add TeamoRouter as a Hermes provider:

Add the provider in CC Switch

1. Open CC Switch and switch to the Hermes tab.
2. Click Add provider.
3. Fill in:
   1. Provider ID: teamorouter
   2. Provider name: TeamoRouter
   3. Website, optional: https://teamorouter.com
   4. API mode: keep OpenAI Chat Completions
   5. API endpoint: https://api.teamorouter.com/v1
   6. API key: paste the key you created in the TeamoRouter dashboard
4. Fetch the TeamoRouter model list or add models manually. Each model needs a model ID and display name. The first model becomes the top-level model.default; put claude-opus-4-7 first if you want it as the default.
5. Click Add to save.

Enable the provider

Return to the Hermes tab and click Enable on the TeamoRouter provider card. CC Switch writes the configuration to ~/.hermes/config.yaml by default. You can override this path in CC Switch settings. Restart the Hermes process completely.

Switch to TeamoRouter in Hermes

Run:

hermes setup

In the provider wizard, use the arrow keys to reach the custom provider at the bottom of the list:

teamorouter (api.teamorouter.com/v1) - model-name

Press Enter or Space to select it. The selected row displays an active marker. Then run hermes to start a session.