cc-provider-switcher

Switch Claude Code between AI providers with one command.

ccs deepseek          # switch to DeepSeek
ccs minimax china     # switch to MiniMax (China region)
ccs status            # show current provider

Install

npm install -g cc-provider-switcher

Or use without installing:

npx cc-provider-switcher deepseek

Updating

npm install -g cc-provider-switcher@latest

npm update won't cross major versions — always use @latest to get the newest release.

Quick start

1. Install: npm i -g cc-provider-switcher
2. Add API keys: ccs config
3. Switch provider: ccs deepseek
4. Check status: ccs status

Thinking & effort support

ccs sets ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES so Claude Code knows which thinking features a provider supports. No extra steps needed after switching.

Providers with effort control (DeepSeek, GLM, Qwen, Kimi, StepFun):

ccs deepseek
# Claude Code now exposes /effort controls (low / medium / high)
# Use /effort high inside Claude Code — DeepSeek maps it to reasoning_effort internally

ccs glm
# Same, plus max_effort tier available

MiniMax — adaptive thinking:

ccs minimax
# MiniMax decides when to think based on task complexity — nothing to configure
# Note shown: "Only adaptive/disabled thinking (enabled returns 400)"

Seed/Doubao — thinking on/off only:

ccs seed
# Thinking is either on or off, no granular effort control

Commands

| Command | Description | |---------|-------------| | ccs <provider> [region] | Switch Claude Code to a provider (user-level) | | ccs project <provider> [region] | Switch for current project only | | ccs list | List all available providers | | ccs status | Show current provider, model, and API key | | ccs config | Interactive API key setup | | ccs reset | Remove ccs-managed settings | | ccs reset --project | Reset project-level settings | | ccs reset --all | Reset both user and project settings | | ccs doctor | Diagnose environment issues | | ccs account save <name> | Save current Claude credentials | | ccs account switch <name> | Restore saved credentials | | ccs account list | List saved credential profiles | | ccs account delete <name> | Delete a saved profile |

Providers

| Name | Key | Aliases | Thinking | Regions | |------|-----|---------|----------|---------| | DeepSeek | deepseek | ds | effort | global | | MiniMax | minimax | mm | adaptive | global, china | | Kimi | kimi | kimi2 | effort | global, china | | Qwen | qwen | — | effort | global, china | | GLM | glm | glm5 | effort | global, china | | Seed/Doubao | seed | doubao | on/off | global | | StepFun | stepfun | sf | effort | global | | OpenRouter | openrouter | or | passthrough | global | | Claude (Anthropic) | claude | anthropic, sonnet | native | global |

Thinking column:

• effort — reasoning_effort levels (low/medium/high)
• adaptive — adaptive thinking only (enabled causes 400 on this provider)
• on/off — thinking enabled/disabled, no effort control
• native — Claude Code's built-in detection applies
• passthrough — depends on the model routed through OpenRouter

Model mapping

When Claude Code picks haiku/sonnet/opus, ccs maps them to the actual model IDs below:

| Provider | Haiku | Sonnet | Opus | |----------|-------|--------|------| | DeepSeek | deepseek-v4-flash | deepseek-v4-flash | deepseek-v4-pro | | MiniMax | MiniMax-M3 | MiniMax-M3 | MiniMax-M3 | | Kimi | kimi-k2.7-code-highspeed | kimi-k2.7-code-highspeed | kimi-k2.7-code | | Qwen | qwen3.7-plus | qwen3.7-plus | qwen3.7-max | | GLM | glm-5.2 | glm-5.2 | glm-5.2 | | Seed/Doubao | ark-code-latest | ark-code-latest | ark-code-latest | | StepFun | step-3.7-flash | step-3.7-flash | step-3.7-flash | | OpenRouter | anthropic/claude-haiku-4.5 | anthropic/claude-sonnet-4.6 | anthropic/claude-opus-4.8 | | Claude (Anthropic) | claude-haiku-4-5-20251001 | claude-sonnet-4-6 | claude-opus-4-8 |

Override any ID via providerOverrides in ~/.ccs/config.json — see Override model IDs.

Configuration

API keys

Run ccs config for interactive setup, or set environment variables:

export DEEPSEEK_API_KEY=sk-...
export MINIMAX_API_KEY=eyJ...
export KIMI_API_KEY=sk-...

Config file: ~/.ccs/config.json (permissions: 0600)

{
  "keys": {
    "deepseek": "sk-...",
    "minimax": "eyJ..."
  },
  "defaults": {
    "region": "global"
  }
}

Override model IDs

Update model IDs without waiting for a release:

{
  "providerOverrides": {
    "deepseek": {
      "defaultModel": "deepseek-v4"
    }
  }
}

What ccs writes

ccs modifies only the env block in Claude Code settings. It never touches other fields (permissions, hooks, etc.).

User-level: ~/.claude/settings.json Project-level: .claude/settings.local.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTED_CAPABILITIES": "effort,thinking",
    "ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES": "effort,thinking",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES": "effort,thinking"
  },
  "ccsManaged": true
}

Multi-account management

Save and restore Claude Pro credentials:

ccs account save work       # save current credentials as "work"
ccs account save personal   # save as "personal"
ccs account switch work     # restore "work" credentials
ccs account list            # list all saved accounts
ccs account delete personal # delete "personal"

Credentials are stored in ~/.ccs/accounts/ with 0600 permissions.

Adding providers

Add an entry to src/providers/providers.json and submit a PR:

{
  "myprovider": {
    "name": "My Provider",
    "baseUrl": "https://api.myprovider.com/anthropic",
    "defaultModel": "my-model-v1",
    "aliases": ["mp"],
    "keyEnvVar": "MYPROVIDER_API_KEY",
    "models": {
      "sonnet": "my-model-v1",
      "opus": "my-model-v1",
      "haiku": "my-model-v1"
    },
    "supportedCapabilities": ["effort", "thinking"],
    "thinkingNote": "Optional note shown after ccs switch"
  }
}

Optional fields:

• supportedCapabilities — Claude Code capability strings to declare (effort, thinking, adaptive_thinking, max_effort). Sets ANTHROPIC_DEFAULT_*_MODEL_SUPPORTED_CAPABILITIES env vars so Claude Code enables effort/thinking controls.
• thinkingNote — shown as an info line after switching, to warn about provider-specific limits.
• regions — map of region name → base URL.
• optional — if true, missing API key is not a fatal error (used for Claude native).

License

MIT