claude-code-switcher-0.12.3 is not a library.

Visit the last successful build: claude-code-switcher-0.4.1

Claude Code Switcher

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

简介

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

主要解决的问题：

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

核心特性

特性	说明
一键切换	无需手动编辑，一条命令完成 AI 提供商切换
预设模板	内置 12+ 热门 AI 提供商，开箱即用
快照系统	保存自定义配置，随时一键恢复
安全存储	API 密钥本地加密存储，支持多凭证管理
交互式 TUI	全屏交互式浏览器，支持键盘快捷键操作
环境隔离	项目级和全局配置独立存储，互不干扰
模块设计	清晰的代码架构，易于扩展新提供商

快速开始

安装

从 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.1（推荐）- Coding 能力对齐 Claude Opus 4.6，支持 200K 上下文

ccs apply zai

# 别名：glm, zhipu


# MiniMax - Anthropic 兼容，高性能 AI

ccs apply minimax


# DeepSeek V4 - 思考模式，V4 Pro/Flash 模型，1M 上下文，价格优惠

ccs apply deepseek

# 别名：ds


# Fishtrip - Anthropic 兼容网关

ccs apply fishtrip

# 别名：fish


# Kimi - 专注编程场景（支持 K2、K2 Thinking 等服务）

ccs apply kimi


# KatCoder - 支持 Pro/Air 两种规格

ccs apply kat-coder


# SeedCode - 字节跳动编程模型

ccs apply seed-code


# Duojie - 多提供商聚合

ccs apply duojie

# 别名：dj


# Zenmux - 多提供商路由

ccs apply zenmux


# AnyRouter - 智能路由配置

ccs apply anyrouter

# 别名：anyr, ar


# OpenRouter - 开放模型选择

ccs apply openrouter

# 别名：or

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

支持的 AI 提供商

提供商	命令	别名	特点	推荐度
智谱 GLM	`ccs apply zai`	`glm`, `zhipu`	GLM-5.1，200K 上下文，128K 输出，Coding 对齐 Claude Opus 4.6	⭐⭐⭐⭐⭐
MiniMax	`ccs apply minimax`	-	Anthropic 兼容，支持中国区/国际区	⭐⭐⭐⭐
DeepSeek V4	`ccs apply deepseek`	`ds`	思考模式，V4 Pro/Flash 模型，1M 上下文，价格优惠	⭐⭐⭐⭐
OpenRouter	`ccs apply openrouter`	`or`	开放模型选择，支持多种模型	⭐⭐⭐⭐
AnyRouter	`ccs apply anyrouter`	`anyr`, `ar`	智能路由，支持中国区/Fallback	⭐⭐⭐⭐
SeedCode	`ccs apply seed-code`	`seedcode`	字节跳动编程模型	⭐⭐⭐
Fishtrip	`ccs apply fishtrip`	`fish`	Anthropic 兼容网关	⭐⭐⭐
Kimi	`ccs apply kimi`	`k2`, `moonshot`	统一 Moonshot 服务（K2, K2 Thinking, Kimi For Coding）	⭐⭐⭐
KatCoder	`ccs apply kat-coder`	`kat`	支持 Pro/Air 两种规格	⭐⭐⭐
Duojie	`ccs apply duojie`	`dj`	多提供商聚合	⭐⭐⭐
Zenmux	`ccs apply zenmux`	-	多提供商路由	⭐⭐⭐
Longcat	`ccs apply longcat`	-	LongCat 聊天配置	⭐⭐

命令参考

基本命令

命令	别名	说明
`ccs apply <target>`	`a`	应用模板或快照
`ccs ls`	`list`, `l`	交互式快照浏览器（创建、应用、删除快照）
`ccs creds list`	`ccs creds ls`	交互式凭证浏览器

快照管理

快照管理通过交互式 TUI 浏览器完成：

# 打开快照浏览器

ccs ls

在交互式界面中可以：

浏览所有快照
创建新快照
应用快照
删除快照

凭证管理

# 打开凭证浏览器（交互式管理）

ccs credentials list

# 或简写

ccs creds list


# 清除所有凭证

ccs credentials clear

高级用法

作用域控制

# 仅应用环境变量

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 deepseek --model "claude-3-5-sonnet-20241022"


# 指定配置文件路径

ccs apply zai --settings-path ~/.claude/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 提供商

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

详见 CLAUDE.md 开发文档。

项目结构

src/
├── main.rs          # 入口点和核心 trait
├── cli.rs           # CLI 参数解析
├── commands.rs      # 命令实现
├── settings.rs      # 配置模型
├── snapshots.rs     # 快照系统
├── credentials.rs   # 凭证管理
├── utils.rs         # 工具函数
├── selectors/       # 交互式选择器框架
│   ├── base.rs      # 核心 trait 和实现
│   ├── confirmation.rs # 确认服务
│   ├── error.rs     # 选择器错误类型
│   ├── snapshot.rs  # 快照选择器（TUI）
│   ├── credential.rs # 凭证选择器（TUI）
│   └── template.rs  # 模板选择器
├── templates/       # AI 提供商模板
│   ├── mod.rs       # Template trait 定义与注册
│   ├── zai.rs       # 智谱 GLM
│   ├── deepseek.rs  # DeepSeek
│   ├── minimax.rs   # MiniMax
│   ├── kimi.rs      # Kimi/Moonshot
│   ├── kat_coder.rs # KatCoder
│   ├── fishtrip.rs  # Fishtrip
│   ├── longcat.rs   # Longcat
│   ├── seed_code.rs # SeedCode
│   ├── zenmux.rs    # Zenmux
│   ├── duojie.rs    # Duojie
│   ├── anyrouter.rs # AnyRouter
│   └── openrouter.rs # OpenRouter

许可证

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!

claude-code-switcher 0.12.3