连接 DeepSeek
准备 DeepSeek 密钥和请求地址
CC Switch 是单独安装的配置软件。本页用它把 DeepSeek 接到 Claude Code，配置完成后回 VS Code 发任务。
API 密钥用于验证调用权限。请使用自己创建或团队发放的 DeepSeek 官方 API 密钥，不要填写网站密码，也不要公开截图。
1. 检查 CC Switch 版本
已经安装过也先检查：在 CC Switch 的设置或关于页面查看版本。 本教程实拍使用 v3.20.2；更早的版本可能缺少同步选项或存在兼容问题。 请先保留现有配置，再从官方发布页更新到稳定版。已有可用新版不必降级。
还没有安装？展开下面的安装包，按电脑系统选择。Windows 与 Mac 的外观可能不同，按设置名称查找。
下载并安装 CC Switch
CC Switch
配置 DeepSeek 请求地址和 API 密钥。它是桌面软件，对话仍在 Claude Code 中进行。
链接指向官方 GitHub 发布包，版本与实拍一致。Windows ARM 等其他设备请确认适用安装包；已有可用新版无需降级。
Mac：打开 .dmg，把应用拖到“应用程序”后打开。Windows：运行 .msi 安装包，完成后从开始菜单打开 CC Switch。
系统提示无法打开或“已损坏”
先确认安装包来源。重新下载仍被拦截时，把错误交给管理员核实，不执行解除安全限制的命令。
2. 选择 Claude Code，开启插件同步
在 CC Switch 顶部选择 Claude Code。下方供应商列表保存的是连接配置，初次使用可以为空。
打开设置齿轮，进入“通用”，向下找到“窗口行为”，开启“应用到 Claude Code 插件”。
首次使用、或 Claude Code 还停在登录引导时，在同一个“通用”设置页开启 “跳过 Claude Code 初次安装确认”，然后返回主界面。找不到这一项时先回上一步检查版本； 不要把开启插件同步当成已经跳过登录引导。
- 找到“应用到 Claude Code 插件”，确认右侧开关开启；不是 Codex 开关。
3. 点加号，选择 DeepSeek 预设
确认顶部仍选中 Claude Code，点右上角加号“添加新供应商”。在新增页面选择“Claude 供应商”标签。
- 先确认选中 Claude Code：顶部靠左的第一个橙色图标。
- 点击最右侧橙色“＋”，打开添加新供应商页面。
点预设区域的搜索入口，输入 DeepSeek，选择搜索结果中的 DeepSeek。本次使用预设，无需选择“自定义配置”。
- 点放大镜展开搜索，输入 DeepSeek。
- 点击 DeepSeek 预设，不是左侧的自定义配置。
- DeepSeek 按钮变为选中状态，下方出现预设提示。
看到“只需填写 API Key，请求地址已预设”后，在中间表单向下滚动，找到密钥和请求地址。
4. 填写密钥，核对地址
Base URL 是发送 AI 请求的服务地址，可以公开。本课的 DeepSeek 官方地址如下； 保留末尾的 /anthropic，不要填聊天网页或本站网址。
https://api.deepseek.com/anthropic- API Key：粘贴你自己的 DeepSeek API 密钥。截图特意留空。
- 请求地址：预设已填入 https://api.deepseek.com/anthropic，核对即可；“完整 URL”保持关闭。
- API Key：粘贴完整密钥，不加引号，不留前后空格。
- 请求地址：与上面的可复制地址核对；“完整 URL”保持关闭。
- 供应商名称保留 DeepSeek。官网链接是账号管理网页，不是请求地址；备注可留空。
查看高级选项和模型映射
本次实拍预设自动填写了 Anthropic Messages 格式、ANTHROPIC_AUTH_TOKEN 认证字段和模型映射，无需另填配置 JSON。没有明确要求时不要额外开启路由接管。
- 上游格式：Anthropic Messages（原生）。
- 认证字段：ANTHROPIC_AUTH_TOKEN（默认）。
- 本次实拍中 Sonnet、Opus 对应 deepseek-v4-pro。这是预设值，不是已成功调用的证明；若报模型错误，请负责人核对账号可用模型。
这些是拍摄时的预设，不代表你的账号已经成功调用。模型名或可用权限有变化时，按服务方文档和负责人确认的设置处理，不为匹配截图强行修改。
检查后点“添加”，应返回供应商列表并看到 DeepSeek。此时配置已保存，还需要启用。
5. 启用配置，重新打开 VS Code
在列表中找到刚添加的 DeepSeek，点它的“启用”。确认这一项显示“使用中”，不要根据条目位置判断。
保存正在编辑的文件后退出 VS Code：Mac 用 ⌘ Q；Windows 关闭所有 VS Code 窗口。重新打开 word-counter，再打开 Claude Code 新建对话。
“使用中”只表示选中了这套配置。下一页会发送实际请求，检查回复和项目文件夹。
还没成功？查看本步排查
插件仍然要求登录
本课使用 DeepSeek API 密钥。停在 Claude 登录页时，先检查 CC Switch 配置，不需要为继续本课购买 Claude 订阅。
- 先检查 CC Switch 版本。在设置或关于页面查看版本；本教程截图使用 v3.20.2。 如果你使用更早的版本，或找不到下面的选项，先保留现有配置，再从官方发布页更新到稳定版。 已有可用新版无需降级，也不要先卸载、清空配置。
- 检查两项设置。在“设置 → 通用”中开启“应用到 Claude Code 插件”； 对于首次启动的登录或初始化提示，再开启“跳过 Claude Code 初次安装确认”。 两个开关用途不同，不能互相代替。
- 确认启用的是 DeepSeek。回到 Claude Code 的供应商列表， 确认你的 DeepSeek 条目显示“使用中”。不要选“官方登录”。
- 重开后测试。保存文件，完全退出 VS Code，再打开 word-counter 和 Claude Code 新对话。回到测试连接和文件夹发送请求。
仍然出现登录提示时，不要反复新增供应商或叠加手动配置。记录操作系统、 CC Switch 与 Claude Code 插件版本、提示原文和已做过的检查，向负责人求助；截图前遮盖密钥。 更新是优先检查项，不代表所有登录问题都由旧版本造成。
CC Switch 官方首次启动说明：跳过初始化引导不等于密钥有效，仍需发送请求验证。
已能发消息，但出现密钥、额度或网络错误
- 密钥错误：核对密钥来源和配套请求地址，不要把内部中转密钥填到官方地址。
- 余额不足或限流：联系密钥所有者确认额度与使用限制。
- 模型不可用：记录提示中的模型名，请负责人核对账号可用型号。
- 连接超时：先核对请求地址和网络，不要同时更改密钥、模型与代理。