CCS - Claude Code Switch

Lightweight CLI to switch between AI model providers for Claude Code.

Features

• Switch between Anthropic (OAuth) and custom API providers (GLM, etc.)
• Interactive provider management: ccs add, ccs remove
• Self-update: ccs update
• Simple commands: ccs glm, ccs anthropic
• Shell aliases: claude-glm, claude-anthropic, ccm, ccc
• Auto-clean: removes large cache files on startup
• Config validation: Zod schema validation with helpful error messages
• No TTY issues: runs Claude in foreground (fixes "suspended tty output" bug)
• MCP Sync: Automatically syncs MCP servers across all providers
• Resource Sync: Shares commands, settings, plugins, skills, agents, CLAUDE.md across providers

Installation

NOTE: The npm package cc-switch is not yet published to npm. Please use the manual install or one-line install method.

Option 1: One-line install (Recommended)

curl -fsSL https://raw.githubusercontent.com/MakFly/ccm-manager/main/install.sh | bash

This will:

• Clone the repository to ~/.ccs
• Install dependencies (bun or npm required)
• Create a default .ccsignore file to prevent OOM errors

Option 2: Manual install

# Clone
git clone https://github.com/MakFly/ccm-manager.git ~/.ccs

# Install dependencies
cd ~/.ccs && bun install

# Add to ~/.zshrc or ~/.bashrc
echo 'export PATH="$HOME/.ccs/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(ccs alias)"' >> ~/.zshrc
source ~/.zshrc

Option 3: npm/bun (Not yet available)

# With bun (faster)
bun install -g cc-switch

# Or with npm
npm install -g cc-switch

Coming soon: The npm package will be published once stable. For now, please use Option 1 or 2.

Updating

# Update to latest version
cd ~/.ccs && git pull

# Rebuild
bun install
bun run build

Quick Start

# Add a new provider interactively
ccs add glm

# List all providers
ccs list

# Switch to a provider
ccs glm

# Run Claude with current provider
ccs

# Run Claude with a specific provider
ccs run glm

Commands

Command	Description
ccs	Run Claude with current provider
ccs status	Show current provider
ccs list / ccs ls	List all providers
ccs use <provider>	Switch to a provider
ccs run [provider]	Run Claude (optional provider switch)
ccs add <key>	Add a new provider interactively
ccs remove <key> / ccs rm	Remove a provider
ccs sync [provider]	Sync shared resources & MCP servers
ccs sync --all	Sync all providers
ccs update	Update CCS to latest version
ccs alias	Generate shell aliases
ccs alias -i	Show shell setup instructions
ccs config	Show config file path

Shell Aliases

After running eval "$(ccs alias)":

ccm glm          # = ccs glm (switch provider)
ccc              # = ccs run (run Claude)
ccc glm          # = ccs run glm
claude-glm       # Direct provider alias
claude-anthropic # Direct provider alias

Configuration

Config is stored at ~/.ccs/config.json (or $CCS_CONFIG_PATH if set).

Example Configuration

{
  "current": "anthropic",
  "providers": {
    "anthropic": {
      "name": "Anthropic (OAuth)",
      "type": "oauth",
      "configDir": "~/.claude"
    },
    "glm": {
      "name": "GLM-4.7",
      "type": "api_key",
      "description": "GLM-4.7 via Z.AI",
      "configDir": "~/.claude-glm",
      "env": {
        "ANTHROPIC_AUTH_TOKEN": "your-token",
        "ANTHROPIC_MODEL": "glm-4.7",
        "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic"
      }
    }
  }
}

Provider Types

Type	Description	Required Fields
oauth	Anthropic OAuth login	configDir
api_key	Custom API provider	configDir, env with API credentials

Environment Variables for Providers

For api_key providers, you can set:

Variable	Description
ANTHROPIC_AUTH_TOKEN	Authentication token
ANTHROPIC_API_KEY	API key
ANTHROPIC_MODEL	Model name
ANTHROPIC_BASE_URL	API endpoint URL

Adding Providers

Interactive (Recommended)

ccs add my-provider
# Follow the prompts

Manual

Edit ~/.ccs/config.json directly.

Environment Variables

Variable	Description
CCS_CONFIG_PATH	Custom config file path

Auto-Cleanup

CCS automatically cleans up large cache directories before launching Claude:

• shell-snapshots/ if > 10MB
• debug/ if > 5MB

This prevents Claude from slowing down due to accumulated cache files.

Resource Sync

CCS automatically syncs shared resources from ~/.claude to all provider config directories:

Resource	Type	Description
commands/	symlink	Custom slash commands
settings.json	symlink	Status line, plugins config
plugins/	symlink	Installed plugins
skills/	symlink	User skills
agents/	symlink	Custom agents
CLAUDE.md	symlink	User instructions
AGENTS.md	symlink	Agent instructions
prompts/	symlink	Prompt templates

Manual Sync

# Sync all providers
ccs sync --all

# Sync with force (recreate symlinks)
ccs sync --all --force

# Sync specific provider
ccs sync glm

MCP Server Sync

CCS automatically syncs MCP servers from ~/.claude.json to all provider config directories.

When you run ccs run glm, your MCP servers (web-search, assistant-ui, etc.) are automatically available.

Adding MCP Servers (Important!)

Always use -s user flag to add MCP servers globally:

# HTTP server
claude mcp add my-server -s user --transport http https://api.example.com/mcp

# stdio server (npx)
claude mcp add next-devtools -s user -- npx next-devtools-mcp@latest

# stdio server with args
claude mcp add assistant-ui -s user -- npx -y @assistant-ui/mcp-docs-server

MCP Scopes

Flag	Scope	Synced by CCS	Storage
-s user	Global	✅ Yes	~/.claude.json
-s local	Project (private)	❌ No	Project config
-s project	Project (shared)	❌ No	.mcp.json

Rule: Always use -s user so CCS syncs MCP servers to all providers.

How it works

1. MCP servers are stored in ~/.claude.json (source of truth)
2. On each ccs run <provider>, MCP servers are merged into ~/<provider-config>/.claude.json
3. New servers are added, existing servers are updated

Verify MCP Sync

# Check MCP servers for a specific provider
CLAUDE_CONFIG_DIR=~/.claude-glm claude mcp list

Troubleshooting

"TTY suspended" issues

CCS runs Claude with stdio: 'inherit', which fixes terminal issues. If you still have problems, ensure you're running ccs directly (not through a pipe).

Config validation errors

If your config is invalid, CCS will show detailed errors:

[ccs] Invalid config.json:
  - providers.glm.env.ANTHROPIC_BASE_URL: Invalid url
[ccs] Using default config. Fix your config.json or delete it to regenerate.

Reset to defaults

Delete the config file to reset:

rm ~/.ccs/config.json

Uninstall

# Remove the installation directory
rm -rf ~/.ccs

# Remove lines from ~/.zshrc or ~/.bashrc:
#   export PATH="$HOME/.ccs/bin:$PATH"
#   eval "$(ccs alias)"

Requirements

• Bun or Node.js >= 18
• Claude Code CLI installed

License

MIT - See LICENSE for details.