1\. 安装并检查

从 CC Switch CLI 官方发布页下载与系统架构匹配的版本。解压后先查看帮助：

cc-switch --version
cc-switch --help
cc-switch provider --help

不同版本的子命令可能变化，以下命令应以当前 --help 输出为准。

2\. 备份 Claude Code 配置

mkdir -p "$HOME/cc-switch-backup"
cp -p ~/.claude/settings.json "$HOME/cc-switch-backup/claude-settings.json" 2>/dev/null || true

3\. 使用交互界面

直接运行：

cc-switch

在交互界面中选择 Providers，新增自定义 Provider，然后填写：

Name: 青云TOP API
Base URL: https://top.qingyuntop.ai
API Key: 青云TOP API 创建的专用令牌
Model: /v1/models 返回的 Anthropic 模型 ID

保存后把 青云TOP API 切换为当前 Provider，再完全退出并重启 Claude Code。

4\. 查看当前状态

先从帮助中确认当前版本支持的命令，再列出 Provider 和当前选中项。不要猜测 Provider ID，也不要把真实 API Key 放在命令行参数中。

5\. 恢复

在 CC Switch CLI 中切回原 Provider。若需要恢复文件，确认 Claude Code 和 CC Switch 都已退出，再使用备份覆盖对应配置。