TOKENOPENTOKENOPEN
User GuideAPI ReferenceHelp & Support
AI Apps

CC Switch - Unified AI CLI Manager

Use CC Switch to manage Claude Code, Codex, OpenClaw, Hermes, and other AI CLI configurations in one place

CC Switch is an open-source unified AI CLI management tool. It helps you centrally manage provider switching, model selection, and configuration for Claude Code, Codex, OpenClaw, Hermes, and other clients, reducing the cost of manual config file changes.

Most AI CLI tools require you to restart the terminal or the corresponding CLI after switching configurations. Claude Code usually supports hot switching directly.


1. About CC Switch

  • Manage providers, models, and API endpoints for multiple AI CLI tools in one place
  • Supports graphical switching and reduces the need to manually edit json, toml, and .env files
  • Suitable for workflows that use Claude Code, Codex, OpenClaw, and Hermes together

2. Download

Common installation methods:

  • Windows: download the .msi installer or the portable .zip
  • macOS: prefer the .dmg, or use brew install --cask cc-switch
  • Linux: choose .deb, .rpm, or .AppImage based on your system

3. AI CLI Integration

The screenshots below are based on the current UI version. Button positions or labels may differ slightly across versions, but the overall flow is the same: create a Provider first, then fill in the API configuration and enable it.

Claude Code

  1. Open CC Switch and create or import a Provider
  2. Choose Claude Code as the target tool
  3. Fill in the API Key, Base URL, model, and other settings
  4. Enable the Provider, then return to Claude Code

Recommended settings:

Base URL: https://www.tokenopen.ai
API Key: sk-your-token
Model: claude-sonnet-4-6 / any other enabled model

Add Provider:

Claude Code Add Provider

Fill in API settings:

Claude Code API Settings

Codex

  1. Create or duplicate a Provider in CC Switch
  2. Choose Codex as the target tool
  3. Configure the OpenAI-compatible endpoint, API Key, and model
  4. Enable it, then restart Codex CLI

Recommended settings:

Base URL: https://www.tokenopen.ai/v1
API Key: sk-your-token
Model: gpt-5.4 / gpt-5.5 / any other enabled model

Add Provider:

Codex Add Provider

Fill in API settings:

Codex API Settings

OpenClaw

  1. Create a new Provider in CC Switch
  2. Choose OpenClaw as the target tool
  3. Fill in the API endpoint, key, and model
  4. Enable it, then reopen OpenClaw

Recommended settings:

Base URL: https://www.tokenopen.ai/v1
API Key: sk-your-token
Model: gpt-5.4 / claude-sonnet-4-6 / any other enabled model

Add Provider:

OpenClaw Add Provider

Fill in API settings:

OpenClaw API Settings

Hermes

  1. Create a Provider in CC Switch
  2. Choose Hermes as the target tool
  3. Configure the Base URL, API Key, and default model
  4. Enable the configuration, then restart Hermes CLI or the related process

Recommended settings:

Base URL: https://www.tokenopen.ai/v1
API Key: sk-your-token
Model: gpt-5.5 / claude-sonnet-4-6 / other long-context models

Add Provider:

Hermes Add Provider

Fill in API settings:

Hermes API Settings


Notes

  • If one Provider needs to be reused across multiple tools, prefer maintaining it centrally inside CC Switch
  • OpenAI-compatible tools usually use https://www.tokenopen.ai/v1
  • Claude-compatible tools usually use https://www.tokenopen.ai

Last updated on