ccm (Claude Code API Config Manager) 是一个命令行工具,帮助开发者快速管理和切换多个 Claude Code API 配置。如果你经常在不同的 API 提供商(如 DeepSeek、智谱AI、MiniMax、Kimi、通义千问 等)之间切换,或者需要为不同项目使用不同的 API 配置,这个工具将大大提高你的效率。
- 多配置管理 - 添加、列出、删除多个 API 配置
- 快速切换 - 一条命令在不同配置间切换
- 环境变量自动设置 - 自动配置平台特定的环境变量
- 智能参数识别 - 自动识别 Token、Base URL 和模型参数
- 跨平台支持 - Windows、Linux、macOS
- AOT 编译 - 发布为原生可执行文件,启动快速
- 一键安装 - 支持交互式安装和静默安装 (
install -y)
Linux / macOS
curl -fsSL https://gitee.com/morilong/claude-code-api-config-manager/raw/master/scripts/install.sh | bashWindows (PowerShell)
irm https://gitee.com/morilong/claude-code-api-config-manager/raw/master/scripts/install.ps1 | iexWindows (CMD)
curl -fsSL https://gitee.com/morilong/claude-code-api-config-manager/raw/master/scripts/install.cmd -o install.cmd && install.cmd && del install.cmdLinux / macOS
curl -fsSL https://raw.githubusercontent.com/morilong/ClaudeCodeApiConfigManager/master/scripts/install-github.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/morilong/ClaudeCodeApiConfigManager/master/scripts/install-github.ps1 | iexWindows (CMD)
curl -fsSL https://raw.githubusercontent.com/morilong/ClaudeCodeApiConfigManager/master/scripts/install-github.cmd -o install-github.cmd && install-github.cmd && del install-github.cmd从 Releases 页面下载对应平台的压缩包:
| 平台 | 架构 | 下载链接 |
|---|---|---|
| Windows | x64 | ccm-win-x64.zip |
| Windows | x86 | ccm-win-x86.zip |
| Windows | ARM64 | ccm-win-arm64.zip |
| Linux | x64 | ccm-linux-x64.tar.gz |
| Linux | ARM64 | ccm-linux-arm64.tar.gz |
| macOS | x64 | ccm-osx-x64.tar.gz |
| macOS | ARM64 | ccm-osx-arm64.tar.gz |
解压后执行安装
- Windows:双击
ccm.exe - Linux/macOS:
./ccm
# 克隆仓库
git clone https://gitee.com/morilong/claude-code-api-config-manager.git
cd claude-code-api-config-manager
或
git clone https://github.com/morilong/ClaudeCodeApiConfigManager.git
cd ClaudeCodeApiConfigManager
# 发布为可执行程序
dotnet publish -c Releaseccm ls默认自带了 DeepSeek、智谱AI、MiniMax、Kimi、通义千问 的配置模板,只需修改 API Token 即可使用:
ccm st <name> <token>
# 示例
ccm st ds sk-xxx
一键切换配置并启动 Claude Code:
# 普通模式
ccm-claude zhipu
# 跳过权限确认模式
ccm-claude zhipu -y
# 简写形式
ccm-c zhipu
ccm-c zhipu -y| 命令 | 说明 |
|---|---|
ccm-claude <config> |
切换配置 + 启动 claude |
ccm-claude <config> -y |
切换配置 + claude --dangerously-skip-permissions |
ccm-c |
ccm-claude 的简写 |
# 临时模式(仅在当前终端生效)
ccm use ds
# 永久模式(当前终端 + 新终端)
ccm use ds -p# 智谱AI
ccm add zhipu xxx https://open.bigmodel.cn/api/anthropic glm-4.7
# DeepSeek
ccm add ds sk-xxx https://api.deepseek.com/anthropic deepseek-chat
# MiniMax
ccm add minimax xxx https://api.minimaxi.com/anthropic MiniMax-M2.1
# Kimi
ccm add kimi sk-xxx https://api.moonshot.cn/anthropic kimi-k2.5
# 通义千问Coder
ccm add qwen3 sk-xxx https://dashscope.aliyuncs.com/apps/anthropic qwen3-coder-plus
# 通义千问Coder Coding Plan
ccm add qwen3-coding sk-xxx https://coding.dashscope.aliyuncs.com/apps/anthropic qwen3-coder-plus配置自定义参数:
ccm add ds sk-xxx https://api.deepseek.com/anthropic deepseek-chat API_TIMEOUT_MS=600000
- 格式:KEY=VALUE(如:API_TIMEOUT_MS=600000)
ccm cccm rm test1ccm v| 命令 | 别名 | 描述 | 使用示例 |
|---|---|---|---|
list |
ls |
列出所有已保存的配置 | ccm ls |
setToken |
st |
修改指定配置的 API Token | ccm st zhipu xxx |
add |
添加新的 API 配置 | ccm add zhipu xxx https://open.bigmodel.cn/api/anthropic glm-4.7 |
|
use |
切换到指定配置(设置环境变量) | ccm use zhipu |
|
current |
c |
查看当前使用的配置详情 | ccm c |
ccm-claude |
ccm-c |
一键切换配置并启动 Claude | ccm-c zhipu / ccm-c zhipu -y |
remove |
rm / del |
删除指定配置 | ccm rm test1 |
uninstall |
卸载 ccm 软件本身 | ccm uninstall |
|
v |
查看版本信息 | ccm v |
工具会设置以下环境变量:
| 环境变量 | 说明 |
|---|---|
ANTHROPIC_AUTH_TOKEN |
API 认证令牌 |
ANTHROPIC_BASE_URL |
API 基础 URL |
ANTHROPIC_MODEL |
模型名称 |
| 自定义参数 | 通过 KEY=VALUE 添加的额外环境变量 |
配置文件位置:
| 平台 | 位置 |
|---|---|
| Windows | 可执行文件目录/settings.json |
| Linux/macOS | ~/.config/ClaudeCodeApiConfigManager/settings.json |
配置文件格式:
{
"configs": [
{
"name": "zhipu",
"authToken": "your_zhipu_api_key",
"baseUrl": "https://open.bigmodel.cn/api/anthropic",
"model": "glm-4.7",
"customParams": {}
},
{
"name": "ds",
"authToken": "sk-xxx",
"baseUrl": "https://api.deepseek.com/anthropic",
"model": "deepseek-chat",
"customParams": {
"API_TIMEOUT_MS": 600000
}
}
],
"activeConfigName": "zhipu"
}使用用户级环境变量,设置后需要重启程序或打开新的终端窗口才能生效。
- 自动检测用户的 Shell(bash/zsh/fish)
- 在
~/.ccm/目录生成环境变量脚本 - 自动在 Shell 配置文件中添加初始化代码
- 执行
source命令重新加载配置
支持的 Shell:
- Bash:
~/.bashrc或~/.bash_profile - Zsh:
~/.zshrc - Fish:
~/.config/fish/config.fish
- .NET 10.0 - 跨平台框架
- System.CommandLine (v2.0.2) - CLI 命令解析
- Spectre.Console (v0.54.0) - 控制台美化和交互
- System.Text.Json - JSON 序列化(Source Generation)
- AOT 编译 - 提前编译为本机代码
# 构建项目
dotnet build
# 运行项目
dotnet run -- add test sk-xxx https://api.example.com model-name
# 发布为可执行文件
dotnet publish -c ReleaseClaudeCodeApiConfigManager/
├── Program.cs # 应用入口点
├── Commands/
│ └── CommandBuilder.cs # CLI 命令构建器
├── Models/
│ ├── ConfigModels.cs # API 配置数据模型
│ └── SettingsContext.cs # JSON 序列化上下文
├── Services/
│ ├── ConfigRepository.cs # 配置文件存储服务
│ ├── ConfigService.cs # 配置业务逻辑服务
│ ├── CommandHelper.cs # 命令参数解析辅助
│ ├── Constants.cs # 全局常量
│ ├── VersionHelper.cs # 版本信息管理
│ ├── IConsoleOutput.cs # 控制台输出接口
│ ├── ConsoleStyles.cs # 控制台样式常量
│ ├── Platform.cs # 平台检测和路径管理
│ ├── WindowsEnvironmentManager.cs # Windows 环境变量管理
│ ├── UnixEnvironmentManager.cs # Unix 环境变量管理
│ ├── InstallService.cs # 安装/卸载服务
│ ├── InitService.cs # 初始化向导服务
│ └── InstallPromptService.cs # 安装提示服务
└── ClaudeCodeApiConfigManager.csproj
A: Windows 使用用户级环境变量,设置后需要重启程序或打开新的终端窗口。
A: 需要重新加载 Shell 配置文件,例如:source ~/.bashrc 或 source ~/.zshrc。
A: 直接复制配置文件即可。
- Windows 在可执行文件目录
- Linux/macOS 在
~/.config/ClaudeCodeApiConfigManager/
A: 编辑 .claude.json 文件:
- Windows:
C:\Users\%username%\.claude.json - Linux:
~/.claude.json
在第一个 { 后面添加一行:
"hasCompletedOnboarding": true,
A: https://gitee.com/morilong/windows-sdk-ucrt-redistributable-dlls