DeepAI · 环境准备 › CC Switch 配置

CC Switch 配置

图形化配置网关、一键切换供应商

这是什么,为什么要做

Claude Code 装好之后,还不知道去哪里连、用谁的账号。「接入网关」就是告诉它两件事:

  • 去哪里连(网关地址 Base URL)——像门牌号,告诉 Claude Code 访问哪个服务器。我们用的是 DeepAI 中转网关,速度稳、支持多模型、额度统一管理。
  • 你是谁(专属密钥 API Key)——像钥匙,证明你有使用权限,每人一把,不能共用。

这两个值由团队负责人私发给你,不会写在课程材料里,也不要截图公开。 收到之后,按下面任选一种方式填进去即可。

推荐方式 · 用 CC Switch 图形化填(最适合小白)

CC Switch 是一个有可视化界面的小工具,点几下就能填好网关地址和密钥并启用,不需要碰命令行。它的好处是:在它里面切换供应商,VS Code 里的 Claude Code 会自动跟着切,以后想换渠道一键搞定。安装包在本节最下方「下载 CC Switch」处。

安装并配置

打开 CC Switch

下载安装好后,打开 CC Switch 应用,确认能正常启动。

Mac 提示「已损坏」怎么办Mac 第一次打开如果弹出「已损坏,无法打开」,这是 macOS 对「网上下载、没经过苹果认证」的 App 的安全拦截,不是软件真的坏了。先试最简单的:去「系统设置 → 隐私与安全性」, 在最下面找到对 CC Switch 的拦截提示,点「仍要打开」放行即可。
如果设置里没有这个选项,可以打开「终端」,输入 xattr -dr com.apple.quarantine 末尾留一个空格、先别回车),再把「应用程序」里的 CC Switch 图标直接拖进终端窗口,路径会自动填好,最后回车—— 这只解除这一个 App 的标记不要用那种会全局关闭系统安全机制的命令。

先打开「应用到 Claude Code 插件」开关

这是让 CC Switch 的切换能联动到 VS Code 扩展的关键开关——打开后, 你在 CC Switch 里切换供应商,VS Code 里的 Claude Code 会自动跟着切,不用手动改任何配置。

打开 CC Switch,点左上角的设置(齿轮)图标:

CC Switch 主界面,点左上角齿轮进入设置
CC Switch 主界面,点左上角齿轮进入设置

在「通用」标签里,把「应用到 Claude Code 插件」开关打开:

设置页开启「应用到 Claude Code 插件」开关
设置页开启「应用到 Claude Code 插件」开关

新建一个供应商(Provider)

回到主界面,点右上角橙色的 「+」 按钮新增供应商:

点右上角「+」添加新供应商
点右上角「+」添加新供应商

填写网关地址和密钥

在「添加新供应商」表单里填这几项:

  • 供应商名称:随便起个好认的名字,比如「DeepAI 网关」。
  • API Key:填负责人发给你的专属密钥sk-…)。
  • 请求地址(Base URL):填负责人发给你的网关地址, 注意末尾不要带斜杠 /
  • 模型映射(高级选项,按需):把 Sonnet / Opus / Haiku 三个角色映射到网关实际的模型名, Claude Code 调用时就按这个映射走。

填完点右下角 添加,检查一遍别留多余空格:

添加新供应商表单:名称、API Key、请求地址、模型映射
添加新供应商表单:名称、API Key、请求地址、模型映射

启用并切换

新供应商会出现在列表底部,点它右侧的 启用 按钮切换过去:

在列表中点「启用」切换到新供应商
在列表中点「启用」切换到新供应商

启用后它会高亮为当前激活状态。因为前面开了「应用到 Claude Code 插件」, 此时 VS Code 里的 Claude Code 也已经同步到这个网关:

新供应商已激活,VS Code Claude Code 同步生效
新供应商已激活,VS Code Claude Code 同步生效
随时切回去想切回官方 Anthropic 或别的渠道,回到列表点对应条目的「启用」即可,随时秒切。

重启 VS Code,打开 Claude Code 插件开始用

配好并激活之后,把 VS Code 完全退出再重新打开(让新配置生效), 然后点击 VS Code 左侧边栏的 Claude Code 图标,打开插件面板。

这一次它会自动走 DeepAI 网关,不需要 Anthropic 账号、也不用单独登录, 直接就能开始对话。如果它反而弹出要登录 Anthropic 账号的界面, 多半是网关没配好或没重启 VS Code——回到上面几步检查一遍。

进阶 · 多渠道一键切换以后如果你配了多个 API 渠道(比如既有 DeepAI 网关,也留了官方 key 作备用), 用 CC Switch 就能一键切换,省去每次手动改环境变量的麻烦。 它是开源工具(farion1231/cc-switch),Mac 和 Windows 都支持, 下方即可下载(「工具下载」页也有汇总)。

下载 CC Switch

配置切换 · CC Switch

Claude Code / Codex 多供应商(API 端点 + key)一键切换的桌面小工具。配了多个中转/官方渠道时,免去手动改环境变量。

Mac
CC Switch v3.15.0 (macOS)
.dmg
Windows
CC Switch v3.15.0 (Windows)
.msi

开源项目 farion1231/cc-switch。Mac 首次打开如提示「已损坏」,在系统设置 → 隐私与安全性放行即可。

备选 · 手动设环境变量

「环境变量」可以理解成:让程序每次启动时自动读到的一组设置,就像提前把门牌号和钥匙贴在门口,程序进门就能看到,不用每次手动输。 如果你不熟悉命令行,优先用上面的 CC Switch 方式;实在需要手动配时再看这一节。

Windows 系统

  1. 按 Win 键,搜索「环境变量」,点击「编辑系统环境变量」。
  2. 在弹出窗口里点下方的「环境变量…」按钮。
  3. 在「用户变量」区域点「新建」,新建两条变量:
    • 变量名:ANTHROPIC_BASE_URL,变量值:负责人给你的网关地址
    • 变量名:ANTHROPIC_API_KEY,变量值:负责人给你的专属密钥
  4. 全部点「确定」保存,然后重启 VS Code,新变量才会生效。

Mac 系统

负责人会发给你一段命令,把那段命令直接粘贴到 VS Code 的终端里运行即可, 不需要手动编辑 Shell 配置文件。如果遇到问题,截图发 DeepAI 飞书群 @助教。