claude-code-config-switcher
Switch between multiple Claude Code providers (Kimi, GLM, MiniMax, etc.) with a single command.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/guyskk--claude-code-config-switcher)HTML
<a href="/listings/guyskk--claude-code-config-switcher"><img src="/api/listings/guyskk--claude-code-config-switcher/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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 --versionOption B: Download from [Releases](https://github.com/guyskk/claude-code-config-switcher/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
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 203 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # ccc - Claude Code Configuration Switcher
- [English](README.md) | [中文文档](README-CN.md)
- #### 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)
- ```bash
- 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](https://github.com/guyskk/claude-code-config-switcher/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:
- ```json
- {
- "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
- ```bash
- # 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:
- ```bash
- # 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.
- ```bash
- # 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
- ```json
- {
- "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/`) |
- ```bash
- # Debug with custom config directory
- CCC_CONFIG_DIR=./tmp ccc glm
- ```
- ## Building from Source
- ```bash
- # 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.