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
0-aiBD

  1. 打开 ccswitch：通过 cmd + 空格，输入 ccswitch，就可以看到已经安装了一个桌面应用，打开如下图：

0-IGGp

配置与使用

配置 Claude Code 使用 DeepSeek 模型

  1. 到 DeepSeek 官网（https://platform.deepseek.com/api_keys）完成注册，并创建 API Key，复制出来；

  2. 打开 ccswitch 应用，点击右上角的"+"号，然后配置如下：

0-GZSx

  • API Key：就是你上一步骤获得的 Key

  • 模型映射如下：

640-IIOL

  1. 加到 ccswitch，启用刚配置的 DeepSeek 即可。

0-iNxM

验证

当你打开终端执行 claude 时，就可以看到已经默认切到 DeepSeek V4 了。

0-Uxto

其它几个问题

它是如何实现模型切换的？

本质上非常直接：把配置内容直接写入各 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_* 环境变量

  1. 恢复 customApiKeyResponses 为空（不预批准任何第三方 Key）

  1. Claude Code 找不到环境变量 → 回退读 oauthAccount → 走订阅鉴权

所以在 cc-switch 界面里直接点切换到官方预设就行，Claude Code 无需重启（热切换）。

后面的话

我之前一篇文章写了关于如何通过修改配置文件，让 Claude Code 无缝使用国内大模型的方案，它的实现原理是通过配置文件 settings.json + ~/.zshrc 来实现 Claude Code 自由使用不同模型的方式。

这种方式相比市场上其他的工具，优点是轻量且可以自由配置，我从去年开始就一直使用，没有使用其他插件或者工具。缺点也很明显，就是需要修改配置文件，对新手还是有一些难度。

除此之外，还有一个问题不能解决，就是有一些模型并不支持 Anthropic 的协议，只支持 OpenAI 的协议，这个就没办法了，只能再加一层协议转换。

今天，我就手把手给大家演示一下，如何通过 cc-switch 这个工具，可视化地实现 Claude Code 的大模型配置。

好了，以上是今天带来的 cc-switch 的安装使用，下篇将介绍如何通过 ccswitch 接入更多的国产大模型。