一个用于在不同的 Claude Code API 配置之间进行切换的命令行工具。
- 列出所有可用的API配置并提示选择
- 支持交互式菜单（光标上下移动选择）
- 支持手动输入序号
- 优化的界面排版：配置名称、API密钥、URL都进行了对齐美化
- 安全的密钥显示：API密钥只显示前8位和后4位，中间用...代替
- 彩色高亮显示：不同信息用不同颜色标识，当前激活配置用✓标记
- 通过命令行直接添加新的API配置
- 切换当前使用的API配置
- 显示当前配置
- 显示版本信息
- 模型设置功能
- 交互式选择或直接设置模型
- 支持删除模型设置
- 查看当前模型和可用模型列表
- WebDAV网盘集成
- 配置WebDAV网盘连接设置
- 上传配置文件到WebDAV网盘
- 配置切换后可选择同步到网盘
- 🔔 Webhook通知系统
- 与Claude Code Hooks深度集成
- 支持飞书、Slack、企业微信、Discord等主流平台
- 智能事件过滤，只推送重要通知
- 用户交互和任务完成实时监控
- 一键配置，零学习成本
- 错误处理和帮助提示
npm install -g claude-code-switcher工具需要以下配置文件，都位于 ~/.claude/ 目录下：
存储所有可用的Claude API配置，格式如下：
[
{
"name": "wenwen-ai",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
"ANTHROPIC_BASE_URL": "https://code.wenwen-ai.com",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
}
}
},
{
"name": "zone",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
"ANTHROPIC_BASE_URL": "https://zone.veloera.org/pg",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
}
}
}
]存储当前使用的配置，格式如下：
{
"env": {
"ANTHROPIC_BASE_URL": "https://zone.veloera.org/pg",
"ANTHROPIC_AUTH_TOKEN": "sk-XXXXXXX",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
},
"model": "claude-opus-4-20250514"
}注意：切换配置时，整个 settings.json 文件会被选中配置的 config 对象完全替换。
存储WebDAV网盘连接设置，格式如下：
{
"url": "https://your-webdav-api.com",
"username": "your-username",
"password": "your-password"
}存储webhook通知设置，支持多个webhook并行推送：
{
"webhooks": [
{
"name": "项目通知",
"url": "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-id",
"enabled": true,
"events": ["claude_hooks"],
"format": "feishu",
"retries": 3,
"timeout": 5000
}
]
}ccs add <alias> <key> <url>通过命令行直接添加新的API配置到配置文件中。
参数说明：
alias: 配置别名，用于标识该配置key: Claude API 密钥 (如: sk-xxxxxxx)url: API 基础URL (如: https://api.example.com)
使用示例：
# 添加一个新的配置
ccs add my-api sk-xxxxxxxxxxxxxxxx https://api.example.com
# 添加wenwen-ai配置
ccs add wenwen-ai sk-xxxxxxxxxxxxxxxx https://code.wenwen-ai.com
# 添加zone配置
ccs add zone sk-xxxxxxxxxxxxxxxx https://zone.veloera.org/pg输出示例：
成功添加配置: my-api
配置详情:
{
"name": "my-api",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxx",
"ANTHROPIC_BASE_URL": "https://api.example.com",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
}
}
}
注意事项：
- 如果别名已存在，新配置将覆盖原有配置
- 添加的配置会自动包含默认的权限设置和模型配置
- 配置会立即保存到
~/.claude/apiConfigs.json文件中
ccs current输出示例：
当前激活的配置: zone
配置详情:
{
"name": "zone",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
"ANTHROPIC_BASE_URL": "https://zone.veloera.org/pg",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"HTTPS_PROXY": "http://127.0.0.1:7890",
"HTTP_PROXY": "http://127.0.0.1:7890"
},
"permissions": {
"allow": [],
"deny": []
}
}
}
ccs list输出示例：
? 请选择要切换的配置: (Use arrow keys)
> 1. [wenwen-ai ] sk-xxxx...XXXX https://code.wenwen-ai.com (当前)
2. [zone ] sk-yyyy...YYYY https://zone.veloera.org/pg
3. [co.yes.vg ] sk-zzzz...ZZZZ https://co.yes.vg/api
4. [a-generic ] sk-aaaa...AAAA https://a-generic.be-a.dev/api
──────────────
输入序号...
? 请选择要切换的配置: 2. [zone ] sk-yyyy...YYYY https://zone.veloera.org/pg
当前选择的配置:
{
"name": "zone",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-xxxx",
"ANTHROPIC_BASE_URL": "https://zone.veloera.org/pg",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
}
}
}
? 确认切换到此配置? Yes
成功切换到配置: zone
交互方式:
- 光标选择: 使用键盘上下箭头选择配置，按Enter确认
- 手动输入: 选择"输入序号..."选项，然后输入配置的序号
# 打开API配置文件
ccs open api
# 打开配置目录
ccs open dir此命令支持跨平台：
- macOS: 使用
open命令 - Windows: 使用
start命令 - Linux: 使用
xdg-open命令
ccs use <序号>例如：
ccs use 2输出示例：
当前选择的配置:
{
"name": "zone",
"config": {
"env": {
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx",
"ANTHROPIC_BASE_URL": "https://zone.veloera.org/pg",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"permissions": {
"allow": [],
"deny": []
}
}
}
? 确认切换到此配置? Yes
成功切换到配置: zone
# 交互式选择模型
ccs model
# 直接设置模型
ccs model claude-opus-4-20250514
# 删除模型设置
ccs model delete交互式选择示例：
? 请选择要设置的模型:
> claude-opus-4-20250514
──────────────
删除模型设置
取消
成功设置模型: claude-opus-4-20250514
ccs model-current输出示例：
当前模型: claude-opus-4-20250514
ccs model-list输出示例：
可用的模型:
- claude-opus-4-20250514 (当前)
# WebDAV 子命令方式（推荐）
ccs webdav config # 配置WebDAV网盘设置
ccs webdav upload # 上传配置到WebDAV网盘
ccs webdav download # 从网盘下载配置
ccs webdav list # 列出网盘中的文件
ccs webdav sync # 双向同步配置
# 兼容性命令
ccs webdav-config
ccs webdav-upload
ccs webdav-download核心特性：
- ✅ 多平台支持：飞书、Slack、企业微信、Discord等主流协作工具
- 🎯 智能过滤：避免消息轰炸，只推送重要节点通知
- 🔧 Claude Code 深度集成：监听代码操作、任务完成等关键事件
- 🚀 一键配置：交互式向导，零学习成本
- ⚡ 并行推送：支持多个webhook同时通知，提升协作效率
子命令使用：
# Webhook 管理
ccs webhook add <url> [name] # 添加webhook URL
ccs webhook list # 显示当前配置
ccs webhook push <message> # 推送测试消息
ccs webhook hooks # 配置Claude Code Hooks监听
ccs webhook remove # 删除webhook配置快速配置示例：
# 1. 添加通知端点（支持多个平台）
ccs webhook add "https://open.feishu.cn/open-apis/bot/v2/hook/your-id" "飞书通知"
ccs webhook add "https://hooks.slack.com/services/YOUR/SLACK/WEBHOOK" "Slack通知"
# 2. 配置智能监听（一键设置Claude Code Hooks）
ccs webhook hooks
# 3. 验证配置
ccs webhook push "🎉 Webhook配置完成，开始智能通知！"支持的触发事件：
- 📋 ExitPlanMode: 用户确认执行计划时
- ✅ TodoWrite: 任务完成状态更新时
- 📝 Edit/Write: 文件编辑和创建时
- 🛠️ Bash: 重要命令执行时
- 🔄 配置切换: API配置变更时
智能过滤级别：
- 🧠 智能过滤（推荐）：仅推送关键节点，避免干扰
- 🤝 用户确认类：专注人工决策时刻
- ✅ 任务完成类：跟踪项目进度
- 📢 全部事件：详细监控（调试用）
应用场景：
- 🏢 团队协作：实时通知开发进展，关键节点及时沟通
- 📊 项目管理：自动跟踪任务完成，里程碑提醒
- 🔧 运维审计：记录重要操作，确保可追溯性
- 📈 效率提升：自动化工作记录，减少手动汇报
配置文件结构：
{
"webhooks": [
{
"name": "项目通知",
"url": "https://open.feishu.cn/open-apis/bot/v2/hook/your-id",
"enabled": true,
"events": ["claude_hooks"],
"format": "feishu",
"retries": 3,
"timeout": 5000
}
]
}故障排除：
- 推送失败: 检查网络连接和webhook URL有效性
- 消息不显示: 确认机器人已加入群聊且有发言权限
- 频率过高: 使用智能过滤模式，调整监听事件
📖 详细文档：
ccs --version
# 或
ccs -v输出示例：
ccs 版本: 1.0.0
ccs --help输出示例：
Usage: ccs [options] [command]
Claude配置切换工具
Options:
-v, --version 显示版本信息
-h, --help display help for command
Commands:
list 列出所有可用的API配置并提示选择
add <alias> <key> <url> 添加新的API配置
use <index> 设置当前使用的API配置
current 显示当前激活的配置
open <type> 打开配置文件位置 (type: api|dir)
model [modelName] 设置或查看当前模型 (可选: 直接指定模型名称，使用 "delete" 删除模型设置)
model-current 显示当前设置的模型
model-list 列出所有可用的模型
webdva-config 配置Webdva网盘设置
upload 上传配置文件到Webdva网盘
help [command] display help for command
当输入不存在的命令时，会显示错误信息和可用命令列表：
ccs unknown输出示例：
错误: 未知命令 'unknown'
可用命令:
list
add
use
current
webdva-config
upload
使用 --help 查看更多信息
- 确保
~/.claude/apiConfigs.json和~/.claude/settings.json文件存在并包含有效的配置信息 - 工具会自动创建
~/.claude目录（如果不存在） - 确认操作时默认为"是"，直接按Enter键即可确认
- 切换配置时会完全替换
settings.json文件内容