ccs - Claude Code Provider Switcher

One command to switch between Claude API providers in Claude Code CLI.

Why ccs?

If you use multiple Claude API providers (Anthropic, OpenRouter, Z.AI, etc.), switching between them means manually editing ~/.claude/settings.json every time. CCS makes this a single command.

Demo

$ ccs

==============================
  Claude Provider Switcher
==============================

Available providers:

  1) Z.AI (GLM)  [ACTIVE]
     Default: opus | Top model: glm-5.1
     URL: https://api.z.ai/api/anthropic

  2) AgentRouter (Claude)
     Default: haiku | Top model: claude-opus-4-6
     URL: https://agentrouter.org/

  T) Toggle providers
  +) Add provider
  M) Modify provider
  R) Remove provider
  0) Exit

Select provider [0-T]:

Features

• Interactive menu — switch providers, toggle visibility, add/modify/remove entries
• 11 pre-configured providers — Anthropic, Z.AI, DeepSeek, Qwen, Kimi, and more
• Zero config editing — manage everything from the CLI (ccs add, ccs modify, ccs remove)
• Auto-installs dependencies — jq is installed automatically via your package manager
• Cross-shell support — bash, zsh, and fish

Table of Contents

• Requirements
• Installation
• Usage
• Configuration
• Included Providers
• Claude Code Settings
• Uninstallation
• Contributing
• License
• Changelog

Requirements

• jq — JSON processor (installed automatically by the installer)
• git — required for both quick install and manual install method
• Claude Code CLI installed

Installation

Quick Install

curl -fsSL https://raw.githubusercontent.com/kmmuntasir/ccs/main/quick-install.sh | bash

Then restart your shell or run source ~/.bashrc (or source ~/.zshrc, or source ~/.config/fish/config.fish for Fish) to enable the ccs command.

Manual Install

git clone https://github.com/kmmuntasir/ccs.git
cd ccs
./install.sh

Restart your shell or run source ~/.bashrc (or source ~/.zshrc, or source ~/.config/fish/config.fish for Fish) to enable the ccs command.

Or manually:

mkdir -p ~/.ccs
cp ccs.sh ~/.ccs/ccs.sh
cp config.template.json ~/.ccs/config.json
chmod +x ~/.ccs/ccs.sh
# Add to your shell config:
# ccs() { ~/.ccs/ccs.sh "$@"; }

The installer will:

• Install jq via your system package manager if not found (supports brew, apt-get, yum, pacman)
• Copy ccs.sh to ~/.ccs/
• Create ~/.ccs/config.json from template (skipped if already exists)
• Create ~/.claude/settings.json from template (skipped if already exists)
• Add the ccs shell function to ~/.bashrc, ~/.zshrc, and ~/.config/fish/config.fish (whichever exist)

Usage

Interactive Menu

ccs

The menu only shows enabled providers. Use T to toggle which providers are visible.

Command-Line Arguments

Switch to a provider by key or number:

ccs glm           # Switch to provider by key
ccs 2             # Switch to provider by number
ccs T             # Toggle providers (lowercase 't' also works)
ccs add           # Interactively add a new provider (auto-enabled)
ccs modify        # Select and modify a provider interactively
ccs modify glm    # Modify a specific provider by key
ccs remove        # Select and remove a provider interactively
ccs remove glm    # Remove a specific provider by key
ccs current       # Show the currently active provider
ccs -h, --help    # Show help message

Notes:

• Switching to a disabled provider by key will show an error with a hint to enable it first
• Switching to the currently active provider is a no-op
• You cannot remove the currently active provider (switch away first)
• URLs are automatically normalized with a trailing slash

Configuration

Edit ~/.ccs/config.json:

{
  "providers": {
    "glm": {
      "label": "Z.AI (GLM)",
      "enabled": true,
      "auth_token": "your-api-key",
      "base_url": "https://api.z.ai/api/anthropic",
      "haiku_model": "glm-4.7",
      "sonnet_model": "glm-5-turbo",
      "opus_model": "glm-5.1",
      "default_model": "opus"
    }
  }
}

Provider Fields

ccs modify can change all fields including enabled, letting you toggle visibility without using the T menu.

Included Providers

Template includes 11 providers (all disabled by default — enable them and add your API keys):

Add more providers by running ccs add or editing ~/.ccs/config.json directly.

Claude Code Settings

After switching, ~/.claude/settings.json is updated with:

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key",
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5-turbo",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.1",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_TELEMETRY": "1"
  },
  "model": "opus",
  "skipDangerousModePermissionPrompt": false
}

The template also sets these optional env vars:

• CLAUDE_CODE_DISABLE_1M_CONTEXT — disables 1M context window
• CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC — blocks non-essential network requests
• DISABLE_TELEMETRY — disables telemetry

These are set in the initial settings.template.json and are not modified by provider switching. Edit ~/.claude/settings.json directly to change them.

Restart Claude Code after switching providers.

Uninstallation

./uninstall.sh

This removes ~/.ccs/ and the ccs shell function from your shell config files (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish).

Or manually:

rm -rf ~/.ccs
# Also remove this line from your shell config files:
# ccs() { ~/.ccs/ccs.sh "$@"; }

Note: This does not remove ~/.claude/settings.json.

Troubleshooting

CCS requires jq. Re-run the installer or install manually:

brew install jq          # macOS
sudo apt install jq      # Linux

The shell function wasn't added or your shell wasn't restarted:

source ~/.bashrc   # or ~/.zshrc

Restart Claude Code after switching providers.

Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines.

Acknowledgments

Built with jq and ShellCheck.

License

GNU General Public License v3