CC-Switch 安装与使用指南:在 Claude Code 中轻松切换 AI 模型
一、CC-Switch 是什么
CC-Switch 是一款专为 Claude Code 设计的代理切换工具。它让你无需反复修改配置文件,就能在多个 AI 模型/供应商之间一键切换。
二、安装过程
1. 下载
从 GitHub Releases 页面下载对应系统的版本:
-
Windows:推荐
.msi安装版 或.zip便携版 -
macOS:
.dmg或.tar.gz -
Linux:
.AppImage、.deb或.rpm
2. 安装
Windows 用户直接运行 .msi 按向导安装即可,便携版解压即用。
3. 首次打开
启动后会看到内置的默认配置:
-
Claude Official:Anthropic 官方 API(不支持路由)
-
default:第三方代理(如
api.xiaomimimo.com)
三、配置自己的 API Key
清理旧配置(重要)
如果之前在终端里配置过 Claude Code 的 API,建议先清理,避免冲突:
-
删除
~/.claude/settings.json中的env配置 -
检查并删除系统环境变量中的
ANTHROPIC_API_KEY等 -
重启终端验证:直接运行
claude应提示Not logged in
在 CC-Switch 中添加配置
-
点击配置项进入编辑
-
修改 JSON 中的
ANTHROPIC_AUTH_TOKEN为你自己的 API Key -
保存即可
四、切换模型
CC-Switch 支持多供应商配置,你可以:
-
添加官方 Claude、第三方代理、SiliconFlow 等不同渠道
-
点击任意配置即可用该配置启动 Claude Code
-
不同项目/场景快速切换,无需改文件
Claude Code 内部有 5 个模型角色(Default/Opus/Sonnet/Haiku/Custom),具体映射到哪个模型由你的中转站配置决定。
五、总结
CC-Switch 解决了 Claude Code 多模型切换的痛点,核心优势:
-
✅ 可视化界面,告别手动改配置
-
✅ 一键切换不同供应商
-
✅ 环境变量隔离,不污染系统配置
更多推荐



所有评论(0)