UPGPTs

中文

English

中文

English

Appearance

2026 国内使用 Claude Code：CC Switch 保姆级接入 DeepSeek 教程 ​

作者：UPGPTs 团队首次发布：2026-07-26最后更新：2026-08-09

想在国内顺畅且低成本地用上最新的 AI 编程神器，最省事的办法是接一个国内可直接访问的大模型。这篇教程讲清楚：怎么用开源工具 CC Switch，把 DeepSeek 等国产模型一键接入 Claude Code 和 Codex，实现国内免翻使用。

先看结论：全程约 15 分钟，核心就四步——下载 CC Switch → 拿到 DeepSeek API Key → 本地装 Claude Code → 在 CC Switch 里添加并启用 DeepSeek。不需要翻墙、不需要手动改配置，全程可视化点选。DeepSeek 目前性价比极高，接完即可在终端里正常写代码。

📚 本文目录（点击跳转） ​

CC Switch 是什么？解决模型切换痛点 ​

在动手之前，先明确为什么需要它。

Claude Code、Codex 这些命令行 AI 编程工具，每一个的底层配置格式都不相同。如果你想给它们换一个国内可用的模型供应商，通常需要翻阅文档，手动编辑 JSON、TOML 或 .env 文件，填错一个 Base URL 或 API Key，工具就直接罢工。

CC Switch 就是专为解决这个痛点而生的开源跨平台桌面工具。 它可以：

  • 提供可视化界面，统一管理 Claude Code、Codex、Gemini CLI 等多个 AI 编程工具的配置
  • 内置 50+ 国内外大模型供应商预设（含 DeepSeek、Qwen 通义千问、Kimi、智谱 GLM、MiniMax 等）
  • 无需手动改代码，系统托盘一键切换，实现国内免翻使用 AI 编程工具

CC Switch 桌面工具主界面，可统一管理 Claude Code 等 AI 编程工具配置

CC Switch 内置 50 多家国内外大模型供应商预设的界面

开源指路：https://github.com/farion1231/cc-switch

下载与快速安装 ​

为了保证稳定性和获取最新特性，请前往官方渠道下载：

系统安装指南：

CC Switch 官网下载页面，提供 Windows、Linux、macOS 平台安装包

  • Windows 用户：下载 .msi 安装包，双击一路下一步即可
  • Linux 用户：根据你的发行版选择对应的 .deb、.rpm 或 .AppImage
  • macOS 用户：下载对应的 .dmg 拖拽安装

安装完成后启动 CC Switch，主界面会驻留在桌面或系统托盘中等待调用。

准备国内大模型 API Key（以 DeepSeek 为例） ​

接入高性价比的国内大模型是关键。这里以 DeepSeek 为例：

DeepSeek 开放平台 API keys 页面创建 API Key 的截图

  1. 访问 DeepSeek 开放平台 并注册登录
  2. 导航至「API keys」页面，点击「创建新 API Key」
  3. 重要提示：生成的 Key 只在创建时完整显示一次，请务必当场复制并妥善保存

实战：接入 Claude Code ​

Claude Code 是 Anthropic 推出的原生终端 AI 编程助手，能自主分析项目、写代码、跑命令、修 Bug。但原生工具必须使用海外账号登录，下面用 CC Switch 绕过这一限制。

1. 本地安装 Claude Code ​

确保电脑已安装 Node.js 环境（没有请前往 Node 官网 下载）。打开终端，执行：

bash
npm install -g @anthropic-ai/claude-code

2. 用 CC Switch 覆盖模型配置 ​

正常情况下，终端输入 claude 会卡在登录环节。现在通过 CC Switch 接管：

CC Switch 顶部应用栏选择 Claude 并添加供应商的界面

  • 打开 CC Switch，顶部应用栏选择 Claude，点击「添加供应商」

在 CC Switch 预设列表搜索并选择 DeepSeek 的界面

  • 在预设列表里搜索并选择 DeepSeek

在 CC Switch 中粘贴 DeepSeek API Key 的配置表单

  • 粘贴刚才保存的 DeepSeek API Key

CC Switch 选择 DeepSeek 模型并开启 1M 超长上下文的参数界面

  • 参数说明：CC Switch 内置了 DeepSeek-V4-Pro（适合写代码和复杂推理）和 DeepSeek-V4-Flash。如果需要处理庞大的项目代码库，可以勾选 开启 1M 模式（百万 tokens 超长上下文）

CC Switch 自动生成并展示修改后 JSON 配置文件的界面

  • 点击右下角「添加」保存，界面会直观显示它帮你自动修改的 JSON 配置

CC Switch 添加供应商后点击启用 DeepSeek 模型的界面

  • 最后，点击启用 DeepSeek 模型

启用 DeepSeek 后 Claude Code 终端验证接入成功的截图

重新打开终端输入 claude，发送一句测试提问：“你是什么模型？”如果 AI 正常回复自己是 DeepSeek，接入成功。

💡 如果接入后遇到反复重连、WebSocket 报错等问题，尤其是代理环境下，可参考专门的排查教程，2 分钟即可解决。

优缺点 ​

用 CC Switch 接入 DeepSeek 的优点

  • 免翻墙：国产大模型直连，不需要海外账号和网络环境
  • 可视化：点选供应商即可，不用手改 JSON / TOML / .env，填错 Base URL 的坑没了
  • 可回退：不破坏原有配置，随时切回 Claude 官方模型

不足 / 注意事项

  • 依赖第三方 API：需要先注册 DeepSeek 等平台并充值 API Key
  • 本质是「换供应商」而非原生 Claude：联网搜索等部分官方功能体验与原生不同
  • 代理环境下可能出现 WebSocket 重连报错，需要额外排查

适合人群 ​

  • 在国内、没有海外账号也想用 Claude Code / Codex 的开发者
  • 不想手改配置文件、追求「点选即用」的编程用户
  • 想低成本接入 DeepSeek 等国产大模型、兼顾速度与性价比的人

常见问题 ​

Q：在国内怎么不用翻墙用 Claude Code？ A：用开源工具 CC Switch 给 Claude Code 接入 DeepSeek 等国产大模型。原生 Claude Code 需要海外账号登录，CC Switch 通过可视化界面把模型供应商替换成国内可用的 API，实现免翻使用。

Q：CC Switch 支持哪些国产模型？ A：内置预设包含 DeepSeek、通义千问 Qwen、Kimi、智谱 GLM、MiniMax 等 50+ 国内外厂商，也可自定义添加。写代码和复杂推理推荐 DeepSeek V4-Pro，处理超大项目可开启 1M 超长上下文模式。

Q：接入后还能切回 Claude 官方模型吗？ A：可以。CC Switch 是配置切换工具，不破坏原有配置，随时可在不同供应商和模型之间一键切换，无需重新安装。

Q：接入后反复 Reconnecting / 报错怎么办？ A：多为代理环境下的 WebSocket 连接问题，参见下方相关阅读里的专门教程，改一个配置即可解决。

写在最后 ​

国内用 Claude Code 的卡点，不是工具本身难，而是默认要海外账号。CC Switch 把「换模型供应商」这件事从手动改配置变成了可视化点选，DeepSeek 又足够便宜够用，组合下来就是国内免翻方案里最省事的一条。

拿到能用的 Claude Code 之后，如果你也在用 Codex，完全可以用同样的方式接 DeepSeek。想继续深入了解，可以看下面几篇：

关于作者 ​

UPGPTs 团队 专注 ChatGPT、Claude、Grok、Codex 等 AI 工具的中文保姆级教程，每一步都有截图。更多教程见 UPGPTs 教程中心，使用问题可查 常见问题，或通过联系我们页面留言。

相关阅读