Claude Code Config Switcher

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)

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:
Security Warning: bypassPermissions allows Claude Code to execute tools without confirmation. Only use this in trusted environments.

3. Use

4. Validate (Optional)

Verify your provider configuration:

Patch Command: Replace claude with ccc

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

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…