Claude Code Switcher

一键切换 Claude Code AI 提供商的命令行工具

---

简介

Claude Code Switcher (ccs) 是一个专为 Claude Code 设计的 CLI 工具，帮助你在不同的 AI 提供商之间快速切换配置。无需手动编辑配置文件，一个命令即可完成切换。

主要解决的问题：

• 想试试不同的 AI 提供商（智谱、DeepSeek、MiniMax 等）
• 需要在不同项目间使用不同的 AI 配置
• 频繁切换 API 密钥和模型设置太繁琐

---

核心特性

特性	说明
🔄 一键切换	无需手动编辑，一条命令完成 AI 提供商切换
📦 预设模板	内置 9+ 热门 AI 提供商，开箱即用
💾 快照系统	保存自定义配置，随时一键恢复
🔐 安全存储	API 密钥本地加密存储，支持多凭证管理
🎨 统一交互	VSCode 风格的命令面板，操作直观流畅
🌍 环境隔离	项目级和全局配置独立存储，互不干扰
🧩 模块设计	清晰的代码架构，易于扩展新提供商

---

快速开始

安装

从 crates.io 安装

cargo install claude-code-switcher

从源码安装

git clone https://github.com/Cupnfish/claude-code-switcher.git

cd claude-code-switcher

cargo install --path .

下载预编译二进制

访问 Releases 页面，选择对应平台的二进制文件下载：

平台	文件名
Linux x86_64	ccs-x86_64-linux
Linux aarch64	ccs-aarch64-linux
macOS x86_64	ccs-x86_64-macos
macOS Apple Silicon	ccs-aarch64-macos
Windows	ccs-x86_64-windows.exe

下载后赋予执行权限：

chmod +x ccs-*

mv ccs-x86_64-linux /usr/local/bin/ccs  # 或添加到 PATH

验证安装

ccs --version

ccs --help

---

基本使用

应用预设模板

# 智谱 GLM-5（推荐）- Coding 能力对齐 Claude Opus 4.5，支持 200K 上下文

ccs apply zai

# 别名：glm, zhipu


# MiniMax M2.5 - Anthropic 兼容，高性能 AI

ccs apply minimax


# DeepSeek - 价格优惠，响应快速

ccs apply deepseek

# 别名：ds


# Fishtrip - Anthropic 兼容网关

ccs apply fishtrip

# 别名：fish


# Kimi For Coding - 专注编程场景

ccs apply kimi


# KatCoder Pro - 专业编程 AI

ccs apply kat-coder-pro

# 别名：katpro


# KatCoder Air - 轻量级快速响应

ccs apply kat-coder-air

# 别名：katair

首次使用：工具会提示输入 API 密钥，可选择保存到本地以便后续自动使用。

---

支持的 AI 提供商

提供商	命令	别名	特点	推荐度
🌟 智谱 GLM	ccs apply zai	glm, zhipu	GLM-5，200K 上下文，128K 输出，Coding 对齐 Claude Opus 4.5	⭐⭐⭐⭐⭐
🔥 MiniMax	ccs apply minimax	-	M2.5 模型，Anthropic 兼容	⭐⭐⭐⭐
🚀 DeepSeek	ccs apply deepseek	ds	价格优惠，响应快速	⭐⭐⭐⭐
🐟 Fishtrip	ccs apply fishtrip	fish	Anthropic 兼容网关	⭐⭐⭐
🎯 Kimi	ccs apply kimi	-	专注编程，响应快速	⭐⭐⭐
🔧 KatCoder Pro	ccs apply kat-coder-pro	katpro	专业编程 AI	⭐⭐⭐
💨 KatCoder Air	ccs apply kat-coder-air	katair	轻量级快速响应	⭐⭐

---

命令参考

基本命令

命令	别名	说明
ccs apply <target>	a	应用模板或快照
ccs snap <name>	s	创建快照
ccs ls	list	列出所有快照
ccs delete <name>	rm, del	删除指定快照

凭证管理

# 列出所有保存的凭证

ccs credentials list

# 或简写

ccs creds list


# 删除指定凭证（通过 ID）

ccs credentials delete <credential-id>

# 清除所有凭证

ccs credentials clear

快照管理

# 创建快照

ccs snap my-debug-config


# 查看快照列表（含详情）

ccs ls -v


# 应用快照

ccs apply my-debug-config


# 删除快照

ccs delete my-debug-config

---

高级用法

作用域控制

# 仅应用环境变量

ccs apply zai --scope env


# 仅应用常用设置（模型、权限等）

ccs apply zai --scope common


# 应用完整配置（默认行为）

ccs apply zai --scope all

其他选项

# 应用前备份当前配置

ccs apply zai --backup


# 跳过确认提示

ccs apply zai --yes


# 指定配置文件路径

ccs apply zai --settings-path ~/.claude/settings.json

高级快照

# 指定作用域创建快照

ccs snap my-env --scope env


# 添加描述

ccs snap my-config --description "开发环境配置"


# 从自定义配置文件创建

ccs snap my-custom --settings-path /path/to/settings.json

---

API 密钥配置

环境变量方式

# 智谱 GLM

export Z_AI_API_KEY="your_key"


# MiniMax

export MINIMAX_API_KEY="your_key"


# DeepSeek

export DEEPSEEK_API_KEY="your_key"


# Kimi

export KIMI_API_KEY="your_key"


# KatCoder

export KAT_CODER_API_KEY="your_key"

交互式输入

未设置环境变量时，工具会自动提示输入 API 密钥。

---

开发指南

构建与测试

# 构建

cargo build


# 发布构建

cargo build --release


# 运行测试

cargo test


# 代码检查

cargo check

cargo clippy --all-targets -- -D warnings

cargo fmt --check

添加新 AI 提供商

1. 在 src/templates/ 创建新模板文件
2. 实现 Template trait
3. 在 src/templates/mod.rs 注册模板类型
4. 添加测试到 main.rs

详见 CLAUDE.md 开发文档。

---

项目结构

src/
├── main.rs          # 入口点和核心 trait
├── cli.rs          # CLI 参数解析
├── commands.rs     # 命令实现
├── settings.rs     # 配置模型
├── snapshots.rs    # 快照系统
├── credentials.rs  # 凭证管理
├── selectors/      # 统一选择器框架
│   ├── base.rs     # 核心 trait 和实现
│   ├── navigation.rs # 导航管理
│   ├── confirmation.rs # 确认对话框
│   └── ...         # 各类选择器
├── templates/      # AI 提供商模板
│   ├── mod.rs      # Template trait 定义
│   ├── zai.rs      # 智谱 GLM
│   └── ...         # 其他提供商
└── utils.rs        # 工具函数

---

许可证

MIT License - 详见 LICENSE 文件

---

贡献

欢迎提交 Issue 和 Pull Request！

---

常见问题

• 全局配置：~/.claude/settings.json
• 项目配置：<项目目录>/.claude/settings.json
• 快照存储：~/.claude/snapshots/

ccs credentials clear    # 清除所有凭证

rm ~/.claude/settings.json  # 删除全局配置

检查网络连接，或尝试使用代理。某些提供商可能有地区限制。

---

Made with ❤️ by Cupnfish

Star ⭐ if you find this helpful!