Claude Code + 第三方模型,改一次模型要动三个地方:settings.json、.zshrc、重启终端。
有了cc-switch 这个工具,把这套流程变成一次点击。下面是安装和配置过程,
以接入 DeepSeek 为例,3 步。不废话,开干。
系统环境说明
💡 硬件:Macbook Pro 2023
芯片:Apple M2 Pro
系统:MacOS 14.5
安装
1. 访问 github 地址:https://github.com/farion1231/cc-switch ,打开终端,执行以下两条命令完成安装。
brew tap farion1231/ccswitch
brew install --cask cc-switch
2. 打开 ccswitch:通过 cmd+空格,输入:ccswitch,就可以看已经安装了一个桌面应用,打开如下图:
配置与使用
配置claude code使用deepseek模型
1. 到 deepseek 官网(https://platform.deepseek.com/api_keys),完成注册,并创建 API,复制出来;
2. 打开 ccswitch 应用,点击右上解的“+”号,然后配置如下:
- API key:就是是你上一步骤获得的 key
- 模型映射如下:
| 模型配置项 | 填写内容 | 说明 |
|---|---|---|
| 主模型(Model) | deepseek-v4-pro[1m] | 必须加 [1m],开启 100 万 Token 上下文! |
| Opus 模型 | deepseek-v4-pro[1m] | 复杂任务使用 |
| Sonnet 模型 | deepseek-v4-pro[1m] | 默认任务使用 |
| Haiku 模型 | deepseek-v4-flash | 快速/简单任务,更省钱 |
3. 加到 ccswitch,启用刚配置的 deepseek 即可
验证
当你打开终端执行claude时,就可以看到已经默认切到 deepseek v4了。
其它几个问题
它是如何实现模型切换的?
本质上非常直接:把配置内容直接写入各 CLI 工具的原生配置文件。
用户点击切换
↓
从 SQLite 数据库读取对应提供商配置
(~/.cc-switch/cc-switch.db)
↓
写入各 CLI 工具的原生配置文件
(如 Claude Code 的 ~/.claude.json)
↓
生效
这与我手动在 .zshrc 里写 alias 做的事,和 cc-switch 做的是同一件事,只是 cc-switch 加了
GUI 和自动化。
如果我拥有了 claude官方的 pro 订阅套餐,如何实现切换?
cc-switch 内置了 Official Login 预设,切换到它时会:
1. 清空所有 ANTHROPIC_* 环境变量
2. 恢复 customApiKeyResponses 为空(不预批准任何第三方 Key)
3. Claude Code 找不到环境变量 → 回退读 oauthAccount → 走你的 Pro 订阅
所以在 cc-switch 界面里直接点切换到官方预设就行,Claude Code 无需重启(热切换)。
后面的话
我之前一篇文章写了关于如何通过修改配置文件,让claude code 无缝使用国内大模型的方案,它的实现原因是通过:配置文件 settgins.json + ~/.zshrc 来实现Claude Code自由使用不同模型的方式。
这种方式对市场上其他的工具对比,优点轻量且可以自由配置,我从去年开始就直使用,没有使用其他插件或者工具。缺点也很明显,就是需要修改配置文件,对新手还有有一些难度。
除此之外,但有一个问题不能解决,就是有一些模型并不支持 Anthropic 的协议,只支持 OpenAI 的协议,这个就没办法了,只是再加一层协议转换。
今天,我就手把手给大家演示一下,如何通过 cc-Switch 这个工具,可视化的实现 Claude Code 的大模型配置。
好了,以上是今天带来 cc-switch的安装使用,下篇将介绍如何通过 ccswitch 接入更多的免费大模型。