type
Post
status
Published
date
May 13, 2026
slug
cc-switch
summary
介绍 cc-switch 桌面应用的安装与配置，以接入 DeepSeek 为例演示 3 步流程，实现 Claude Code 一键切换大模型；附带工作原理说明与官方 Pro 订阅热切换方式。
tags
AI
工具
category
技术分享
icon
password
Tweet Link
Staus
类型
平台
Claude Code + 第三方模型，改一次模型要动三个地方：settings.json、.zshrc、重启终端。
有了cc-switch 这个工具，把这套流程变成一次点击。下面是安装和配置过程，
以接入 DeepSeek 为例，3 步。不废话，开干。
系统环境说明
硬件：Macbook Pro 2023
芯片：Apple M2 Pro
系统：MacOS 14.5
安装
- 访问 github 地址：https://github.com/farion1231/cc-switch ，打开终端，执行以下两条命令完成安装。
- 打开 ccswitch：通过 cmd+空格，输入：ccswitch，就可以看已经安装了一个桌面应用，打开如下图：
配置与使用
配置claude code使用deepseek模型
- 到 deepseek 官网（https://platform.deepseek.com/api_keys），完成注册，并创建 API，复制出来；
- 打开 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 | 快速/简单任务，更省钱 |
- 加到 ccswitch，启用刚配置的 deepseek 即可
验证
当你打开终端执行claude时，就可以看到已经默认切到 deepseek v4了。
其它几个问题
它是如何实现模型切换的？
本质上非常直接：把配置内容直接写入各 CLI 工具的原生配置文件。
这与我手动在 .zshrc 里写 alias 做的事，和 cc-switch 做的是同一件事，只是 cc-switch 加了
GUI 和自动化。
如果我拥有了 claude官方的 pro 订阅套餐，如何实现切换？
cc-switch 内置了 Official Login 预设，切换到它时会：
- 清空所有 ANTHROPIC_* 环境变量
- 恢复 customApiKeyResponses 为空（不预批准任何第三方 Key）
- Claude Code 找不到环境变量 → 回退读 oauthAccount → 走你的 Pro 订阅
所以在 cc-switch 界面里直接点切换到官方预设就行，Claude Code 无需重启（热切换）。
后面的话
我之前一篇文章写了关于如何通过修改配置文件，让claude code 无缝使用国内大模型的方案，它的实现原因是通过：配置文件 settgins.json + ～/.zshrc 来实现Claude Code自由使用不同模型的方式。
这种方式对市场上其他的工具对比，优点轻量且可以自由配置，我从去年开始就直使用，没有使用其他插件或者工具。缺点也很明显，就是需要修改配置文件，对新手还有有一些难度。
除此之外，但有一个问题不能解决，就是有一些模型并不支持 Anthropic 的协议，只支持 OpenAI 的协议，这个就没办法了，只是再加一层协议转换。
今天，我就手把手给大家演示一下，如何通过 cc-Switch 这个工具，可视化的实现 Claude Code 的大模型配置。
好了，以上是今天带来 cc-switch的安装使用，下篇将介绍如何通过 ccswitch 接入更多的免费大模型。
- 作者:可夫小子
- 链接:https://koffuxu.com/article/cc-switch
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
相关文章
