ccs — Claude Code Switcher

A fast, single-binary CLI launcher for Claude Code and Codex that lets you interactively select a model provider before each session — no more juggling shell aliases.

Select provider
[Recent]   All     ←/→ switch list, ↑/↓ move, Enter select, Esc cancel

  TOOL     PROVIDER   MODEL
> claude   DeepSeek   deepseek-v4-pro
  claude   DeepSeek   deepseek-v4-flash
  claude   Mimo       mimo-v2.5-pro

Features

• Interactive three-column menu — tool / provider / model, with Recent / All lists switched by left and right arrows
• Direct selection via -p <id> to skip the menu
• Resume support — -r maps to claude -r or codex resume automatically
• Dry-run mode — -n prints the exact command and env vars without launching
• Config-driven — add or remove providers by editing ~/.config/ccs/config.toml; no recompile needed
• Remembers last choice — the previous selection is highlighted by default
• Zero runtime deps — single static binary, ~1 MB

Requirements

• macOS or Linux (uses exec(2) — Unix only)
• claude and/or codex in PATH
• Rust 1.70+ (for building from source)

Installation

From crates.io (recommended)

cargo install ccs-rs

From source

git clone https://github.com/xuzhu-591/ccs.git
cd ccs
cargo build --release
cp target/release/ccs ~/.local/bin/   # or any directory in $PATH

⚠️ Do not install as cc — that name is reserved for the system C compiler and will break your Rust/C toolchain.

Verify

ccs --version

Updating

With cargo-update (recommended):

cargo install cargo-update
cargo install-update ccs-rs   # update ccs-rs only
# cargo install-update -a     # or update all installed crates

Without extra tools:

cargo install ccs-rs --force

Configuration

On first run, ccs generates a template config at ~/.config/ccs/config.toml.
Edit it to add your API keys and desired providers.

# ~/.config/ccs/config.toml

[[providers]]
id              = "deepseek-pro"
provider        = "DeepSeek"
model           = "deepseek-v4-pro"
executable      = "claude"
supports_resume = true
base_args       = ["--dangerously-skip-permissions"]

[providers.env]
ANTHROPIC_BASE_URL             = "https://api.deepseek.com/anthropic"
ANTHROPIC_AUTH_TOKEN           = "YOUR_DEEPSEEK_API_KEY"
ANTHROPIC_MODEL                = "deepseek-v4-pro"
ANTHROPIC_DEFAULT_OPUS_MODEL   = "deepseek-v4-pro"
ANTHROPIC_DEFAULT_SONNET_MODEL = "deepseek-v4-pro"
ANTHROPIC_DEFAULT_HAIKU_MODEL  = "deepseek-v4-flash"
CLAUDE_CODE_SUBAGENT_MODEL     = "deepseek-v4-pro"
CLAUDE_CODE_EFFORT_LEVEL       = "max"

Config fields

Resume behaviour

Usage

Usage: ccs [OPTIONS] [PASSTHROUGH]...
       ccs <COMMAND>

Commands:
  list      List all configured providers
  validate  Validate config and check executables in PATH
  edit      Open the config file in $EDITOR (falls back to vi)

Arguments:
  [PASSTHROUGH]...  Arguments passed through to claude/codex

Options:
  -r, --resume         Resume the last session
  -p, --provider <ID>  Skip the menu and use a specific provider ID
  -n, --dry-run        Print the command that would run, without executing
      --show-secrets   Reveal masked secret values in dry-run / list output
  -h, --help           Print help
  -V, --version        Print version

Examples

# Interactive provider selection
ccs

# Resume last session with the same interactive selection
ccs -r

# Jump straight to a specific provider
ccs -p deepseek

# Resume with a specific provider
ccs -p deepseek-pro -r

# Debug: see exactly what command would be executed
ccs -p codex -r -n

# Reveal the real API key in dry-run output (default is masked)
ccs -p deepseek -n --show-secrets

# Pass extra arguments to the underlying tool
ccs -p deepseek -- --print "explain this code"

# Inspect all configured providers
ccs list

# Make sure every provider's executable is in PATH
ccs validate

# Edit your config in $EDITOR (falls back to vi)
ccs edit

Recent selections

ccs remembers the last 3 provider IDs you used and shows them in a dedicated Recent list. The menu defaults to the most recent provider, and left and right arrows switch between Recent and All providers. The list is stored as plain lines (newest first) in ~/.config/ccs/recent.

Secret masking

By default, --dry-run and ccs list mask values whose env-key contains any of token, key, secret, or password (case-insensitive). The output looks like ***masked (len=42)*** so you can paste logs without leaking keys. Pass --show-secrets to reveal the real value.

Dry-run output example

[dry-run] env:
  ANTHROPIC_AUTH_TOKEN=***masked (len=19)***
  ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
  ...
[dry-run] cmd:
  claude --dangerously-skip-permissions --print 'explain this code'

Adding a custom provider

Add a new [[providers]] block to ~/.config/ccs/config.toml:

[[providers]]
id              = "my-provider"
provider        = "MyService"
model           = "my-model-v1"
executable      = "claude"
supports_resume = true
base_args       = ["--dangerously-skip-permissions"]

[providers.env]
ANTHROPIC_BASE_URL   = "https://api.myservice.com/v1"
ANTHROPIC_AUTH_TOKEN = "sk-..."

No recompile needed — changes take effect immediately on the next run.

Project structure

ccs/
├── src/
│   ├── main.rs                  # All logic (~270 lines)
│   └── default_providers.toml  # Template config embedded in the binary
├── Cargo.toml
├── Cargo.lock
├── LICENSE
├── README.md
└── CONTRIBUTING.md

Contributing

See CONTRIBUTING.md.

License

MIT