APITokenRouter

Connect CC Switch to APITokenRouter

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.

New accounts start with a $0 balance — top up before your first request. Top up from $5. If a request returns 402 with "wallet balance is insufficient", your balance is empty — your base URL and key are fine. Top up and retry.

1. Install CC Switch

Use version 3.16.5 or later.

macOS users can install it with Homebrew:

plaintext
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

If macOS Gatekeeper blocks the first launch, open System Settings, go to Privacy & Security, and allow the app.

2. Connect Claude Code CLI

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

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

Add the APITokenRouter provider

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

CC Switch Claude Code tab

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

Select the APITokenRouter preset provider

  1. Enter your APITokenRouter API key.

Enter the APITokenRouter API Key

  1. Click Add to save.

Enable the APITokenRouter provider

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

Enable APITokenRouter

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 APITokenRouter 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 APITokenRouter in Preset providers, or search for APITokenRouter.

Select APITokenRouter for Claude Desktop

  1. Enter your API key.

Enter the API Key for Claude Desktop

  1. Click Add to save.

Enable the APITokenRouter provider

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

Enable APITokenRouter for Claude Desktop

Fully restart Claude Desktop before using it.

4. Connect Codex

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

If CC Switch and Codex are already installed:

Add the APITokenRouter provider

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

Select APITokenRouter for Codex

  1. Paste the API key you created in the APITokenRouter dashboard.
  2. Click Add to save.

Enable the APITokenRouter provider

Return to the Codex tab and click Enable on the APITokenRouter 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 APITokenRouter. CC Switch does not support OpenCode connection yet.

7. Connect OpenClaw

See Connect OpenClaw to APITokenRouter.

8. Connect Hermes Agent

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

Add the APITokenRouter provider

  1. Open CC Switch and switch to the Hermes tab.
  2. Click Add provider.
  3. Fill in:
    1. Provider ID: teamorouter
    2. Provider name: APITokenRouter
    3. Website, optional: https://apitokenrouter.com
    4. API mode: keep OpenAI Chat Completions
    5. API endpoint: https://apitokenrouter.com/v1
    6. API key: paste the key you created in the APITokenRouter dashboard
  4. Fetch the APITokenRouter 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-5-5 first if you want it as the default.
  5. Click Add to save.

Enable the APITokenRouter provider

Return to the Hermes tab and click Enable on the APITokenRouter 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 APITokenRouter in Hermes

Run:

plaintext
hermes setup

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

plaintext
teamorouter (apitokenrouter.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.

Pay with USDT or USDC

You don't need a credit card to use CC Switch with APITokenRouter. Top up your balance with USDT, USDC or ETH straight from an exchange app (Binance, OKX and others) or any wallet: click Pay with crypto in the top-up dialog, pick a coin and network, and send. The minimum is $5 (USDT on BEP20), and no browser extension is needed. Step by step: Pay for Claude and GPT APIs with crypto (USDT).

Ready? Three steps to startLog in to the console · top up · create an API key
Get API KeyView Pricing
DiscordGet community help instantly
Join Discord
Connect CC Switch to APITokenRouter · Docs