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

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

Claude Code Switcher

一个用于管理 Claude Code 设置快照和模板的 CLI 工具，让你轻松在不同的 AI 提供商之间切换。

🎯 为什么需要这个工具？

Claude Code 支持多个 AI 提供商，但切换模型和配置比较麻烦。这个工具让你可以：

🔄 轻松切换：在不同 AI 提供商之间一键切换
📦 模板管理：内置多个热门 AI 提供商的预设模板
💾 快照功能：保存和恢复你自己的配置组合
🌍 环境隔离：项目级和全局配置分离

🚀 快速开始

安装

方法一：从源码安装

git clone https://github.com/Cupnfish/claude-code-switcher.git
cd claude-code-switcher
cargo install --path .

方法二：从 crates.io 安装

cargo install claude-code-switcher

安装完成后，你就可以使用 ccs 命令了。

基本使用

1. 应用预设模板（推荐）

# 应用智普 GLM 模板（强烈推荐）
ccs apply glm

# 应用 MiniMax Anthropic 模板（推荐）
ccs apply minimax

# 应用 MiniMax OpenAI 模板
ccs apply minimax-openai

# 应用 DeepSeek 模板
ccs apply deepseek

# 应用 Kimi For Coding 模板
ccs apply kimi

# 应用 Moonshot K2 Thinking 模板
ccs apply k2-thinking

# 应用 K2Sonnet 模板
ccs apply k2sonnet

# 应用 Longcat 模板
ccs apply longcat

# 应用 万擎 KAT-Coder 模板
ccs apply kat-coder

关于凭证存储：当使用模板时，如果环境变量未设置，工具会提示你输入 API 密钥。你可以选择将凭证保存到加密的本地存储中，下次使用时会自动提示你是否使用已保存的凭证。

2. 管理保存的凭证

# 列出所有保存的凭证
ccs credentials list

# 删除某个凭证（使用 ID）
ccs credentials delete <credential-id>

# 清除所有凭证（用于解决加密格式不兼容问题）
ccs credentials clear

# 或者使用简写
ccs creds list
ccs creds delete <credential-id>
ccs creds clear

保存的凭证使用 AES-256-GCM 加密存储在本地，每个凭证包含：

API 密钥（加密存储）
Endpoint ID（仅 KatCoder 需要）
创建时间和最后使用时间
可选的凭证名称

3. 创建自己的快照

# 创建当前设置的快照
ccs snap my-config

# 应用快照
ccs apply my-config

4. 管理快照

# 查看所有快照
ccs ls -v

# 删除快照
ccs delete my-config

🔑 API 密钥配置

在使用模板之前，需要先设置对应的环境变量：

# 智普 GLM（推荐）
export Z_AI_API_KEY="your_api_key_here"

# MiniMax
export MINIMAX_API_KEY="your_api_key_here"

# DeepSeek
export DEEPSEEK_API_KEY="your_api_key_here"

# Kimi For Coding
export KIMI_API_KEY="your_api_key_here"

# K2Sonnet
export K2_SONNET_API_KEY="your_api_key_here"

# Longcat
export LONGCAT_API_KEY="your_api_key_here"

# 万擎 KAT-Coder
export KAT_CODER_API_KEY="your_api_key_here"
export WANQING_ENDPOINT_ID="your_endpoint_id_here"  # 格式: ep-xxx-xxx

💡 提示：如果没有设置环境变量，工具会交互式地提示你输入 API 密钥。

🎯 推荐配置

🌟 智普 GLM（强烈推荐）

智普是目前最推荐的选择：

💰 性价比高：有编程套餐，便宜好用
🚀 性能优秀：响应速度快，代码生成质量高
📊 上下文充足：支持200k上下文长度

🔥 MiniMax（推荐）

MiniMax 是另一个优秀的选择，支持兼容的 API：

💰 性价比高：提供有竞争力的价格
🚀 性能优秀：响应速度快，支持流式输出和函数调用
📊 API 兼容：支持 Anthropic 和 OpenAI 两种 API 格式
🔧 功能丰富：支持工具调用、流式响应等高级功能

🔧 万擎 KAT-Coder

万擎 KAT-Coder 是一个编程专用模型：

🎯 专注编程：针对代码生成和开发任务优化
🔧 灵活配置：支持自定义推理点(endpoint)，可根据需求配置
💰 按需使用：基于 WanQing 平台，按实际使用量计费
⚡ 易于集成：遵循标准 Anthropic Claude API 格式

使用说明：

需要设置 KAT_CODER_API_KEY 环境变量
需要设置 WANQING_ENDPOINT_ID 环境变量（格式：ep-xxx-xxx）
使用 ccs apply kat-coder 命令应用配置

其他选择

Kimi For Coding：月之暗面的编程专用模型，支持思考模式，响应速度快
DeepSeek：价格便宜，但上下文长度有限（目前128k）
K2Sonnet：平衡的性能和价格
Longcat：特定的优化模型

📁 作用域说明

默认情况下，所有配置都应用到项目级别（.claude/settings.json）：

# 默认应用到项目目录
ccs apply glm

# 应用到全局配置（需要手动指定路径）
ccs apply glm --settings-path ~/.claude/settings.json

🔧 高级用法

自定义模型

# 使用指定模型
ccs apply glm --model glm-4-plus
ccs apply deepseek --model claude-3-5-sonnet-20241022

备份当前设置

# 应用前先备份
ccs apply glm --backup

快照管理

# 创建不同范围的快照
ccs snap my-env --scope env        # 仅环境变量
ccs snap my-full --scope all       # 所有设置
ccs snap my-common --scope common  # 常用设置（默认）

# 从自定义文件创建快照
ccs snap my-config --settings-path /path/to/settings.json

📋 可用命令

命令	别名	说明
`ccs ls`	`ccs list`	列出所有快照
`ccs snap <name>`	`ccs s`	创建快照
`ccs apply <target>`	`ccs a`	应用快照或模板
`ccs delete <name>`	`ccs rm, del`	删除快照
`ccs credentials <cmd>`	`ccs creds <cmd>`	管理保存的凭证

凭证管理子命令：

ccs credentials list - 列出所有保存的凭证
ccs credentials delete <id> - 删除指定凭证

🛠️ 开发

# 构建
cargo build

# 运行
cargo run -- <command>

# 测试
cargo test

# 发布构建
cargo build --release

📝 许可证

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！

💡 小贴士：建议把常用的 API 密钥添加到 shell 配置文件中（如 .bashrc、.zshrc），这样就不需要每次都输入了。

claude-code-switcher 0.2.1