ccc - Claude Code Configuration Switcher

English | 中文文档

Recommended LLMs

• 小米顶尖模型 MiMo V2.5-Pro 等，通过我的邀请码注册：双方各得 ¥10 API 体验金 + 首单 9 折。邀请码：2DZZC9。注册： https://platform.xiaomimimo.com?ref=2DZZC9 （注册后自动填入 · 体验金 40 天有效）

• 智谱 Coding Plan，国内顶流编程大模型，20+主流工具全适配，性价比拉满！👉立即参与「拼好模」：https://www.bigmodel.cn/glm-coding?ic=S8PMS595T0

Why ccc?

ccc is a CLI tool that provides seamless provider switching for Claude Code. Switch between Kimi, GLM, MiniMax, and other providers with one command.

Quick Start

1. Install

Option A: One-line install (Linux / macOS)

OS=$(uname -s | tr '[:upper:]' '[:lower:]'); ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/'); curl -LO "https://github.com/guyskk/claude-code-config-switcher/releases/latest/download/ccc-${OS}-${ARCH}" && sudo install -m 755 "ccc-${OS}-${ARCH}" /usr/local/bin/ccc && rm "ccc-${OS}-${ARCH}" && ccc --version

Option B: Download from Releases

Download the binary for your platform (ccc-darwin-arm64, ccc-linux-amd64, etc.) and install to /usr/local/bin/.

2. Configure

If you already have ~/.claude/settings.json, the first time you run ccc it will prompt to migrate and automatically generate the ccc config at ~/.claude/ccc.json.

You can also create the config file manually:

{
  "settings": {
    "permissions": {
      "defaultMode": "bypassPermissions"
    }
  },
  "providers": {
    "glm": {
      "env": {
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY_HERE",
        "ANTHROPIC_MODEL": "glm-4.7"
      }
    },
    "kimi": {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY_HERE",
        "ANTHROPIC_MODEL": "kimi-k2-thinking"
      }
    }
  }
}

Security Warning: bypassPermissions allows Claude Code to execute tools without confirmation. Only use this in trusted environments.

3. Use

# Show help
ccc --help

# Switch to a provider and run Claude Code
ccc glm

# Run with current provider
ccc

# Pass any Claude Code arguments
ccc glm -p

4. Validate (Optional)

Verify your provider configuration:

# Validate current provider
ccc validate

# Validate all providers
ccc validate --all

Patch Command: Replace claude with ccc

Make ccc your default Claude Code by replacing the system claude command.

# Replace claude command with ccc (requires sudo)
sudo ccc patch

# After patching, `claude` command now uses ccc
claude --help    # Shows ccc help

# Restore original claude command
sudo ccc patch --reset

Configuration

Config file location, default: ~/.claude/ccc.json

Configuration Merge Strategy

When you run ccc, your existing settings.json is read and deep-merged with ccc.json. Priority: user settings.json > provider > base settings. Your manual edits, plugins, and hooks are preserved; provider env is passed via command line and never written into settings.json.

Environment Variable Handling

Claude Code's settings.json env field overrides environment variables passed by ccc when launching claude. To ensure provider env takes precedence, ccc passes provider env via the --settings CLI parameter, which has higher priority than settings.json.

This means:

• Your settings.json env is preserved as-is (ccc never modifies it)
• Provider env automatically overrides conflicting keys via --settings
• Non-conflicting keys in settings.json still work normally

{
  "settings": {
    "permissions": {
      "defaultMode": "bypassPermissions"
    },
    "alwaysThinkingEnabled": true
  },
  "claude_args": ["--verbose"],
  "current_provider": "glm",
  "providers": {
    "glm": {
      "env": {
        "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY_HERE",
        "ANTHROPIC_MODEL": "glm-4.7"
      }
    },
    "kimi": {
      "env": {
        "ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
        "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY_HERE",
        "ANTHROPIC_MODEL": "kimi-k2-thinking",
        "ANTHROPIC_SMALL_FAST_MODEL": "kimi-k2-0905-preview"
      }
    }
  }
}

Config Fields

Field	Description
settings	Shared Claude Code config template for all providers
claude_args	Fixed arguments to pass to Claude Code (optional)
current_provider	Currently used provider (auto-managed by ccc)
providers.{name}	Provider-specific Claude Code configuration

Provider Configuration

Each provider only needs to specify the fields it wants to override. Common fields:

Field	Description
env.ANTHROPIC_BASE_URL	API endpoint URL
env.ANTHROPIC_AUTH_TOKEN	API key/token
env.ANTHROPIC_MODEL	Main model to use
env.ANTHROPIC_SMALL_FAST_MODEL	Fast model for quick tasks

How merging works: Provider settings are deep-merged with the base template. Provider env takes precedence over settings.env.

Environment Variables

Variable	Description
CCC_CONFIG_DIR	Override config directory (default: ~/.claude/)

# Debug with custom config directory
CCC_CONFIG_DIR=./tmp ccc glm

Building from Source

# Build for all platforms
./build.sh --all

# Build for specific platforms
./build.sh -p darwin-arm64,linux-amd64

# Custom output directory
./build.sh -o ./bin

Supported platforms: darwin-amd64, darwin-arm64, linux-amd64, linux-arm64

License

MIT License - see LICENSE file for details.