CC Switch

用 CC Switch 接入 DeepSeek（推荐小白）

不想手改 JSON、.env、TOML？用 CC Switch。
CC Switch 是免费的桌面软件：选 DeepSeek 预设 → 填 API Key → 点启用，就能让 Claude Code、OpenCode、Codex、OpenClaw 等 CLI 工具用上 DeepSeek。

本指南由 deepseekagent.io 维护。CC Switch 为第三方开源工具，与其作者无关联。

适合谁用？

你是…	建议
第一次接 DeepSeek，怕改错配置文件	直接用 CC Switch
在用 Claude Code / OpenCode / Codex / OpenClaw	优先 CC Switch
经常在 DeepSeek 和其他模型之间切换	用 CC Switch
在用 VS Code 插件（Cline、GitHub Copilot 等）	看对应接入指南，CC Switch 主要管终端 CLI
想搞懂每一行配置的含义	可以 CC Switch 先跑通，再对照 Claude Code 手改教程

开始之前：准备 DeepSeek API Key

打开 DeepSeek 开放平台
登录后创建 API Key，复制保存（只显示一次）
确保账户有余额或可用额度

第一步：安装 CC Switch

macOS（推荐 Homebrew）

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows

从 GitHub Releases 下载 CC-Switch-xxx-Windows.msi，双击安装。

Linux

下载 .deb / .AppImage，或 Arch 用户：

paru -S cc-switch-bin

官网与文档：ccswitch.ai

第二步：添加 DeepSeek 供应商

打开 CC Switch
点击 添加供应商（Add Provider）
在预设列表里选 DeepSeek
粘贴你的 API Key
确认以下信息（预设一般会自动填好）：

字段	Claude Code 常用值
Base URL	`https://api.deepseek.com/anthropic`
主模型	`deepseek-v4-pro[1m]`
快速模型	`deepseek-v4-flash[1m]`

点击 测试连接（如有），成功后再启用
把 DeepSeek 拖到供应商列表 最上面，或从 系统托盘 里切换

第三步：打开你的 Agent 验证

Claude Code

cd 你的项目目录
claude

发一句「你好」或让它读一个文件，能正常回复就说明接通了。
多数情况需要 重启终端 后配置才生效。

OpenCode

opencode

在界面里确认当前模型是 DeepSeek。若之前配过别的供应商，重启终端后再试。

OpenClaw / Codex

同样在 CC Switch 里选好 DeepSeek 并启用，重启终端后运行对应命令。
Codex 官方教程 涉及 Moon Bridge 等转发层，步骤较多——强烈建议小白先用 CC Switch，跑通后再看 Codex 手改教程。

和「手改配置文件」比，差在哪？

	手改配置（本站各工具教程）	CC Switch
难度	中 — 要知道文件路径和字段名	低 — 图形界面 + 预设
适合	想完全掌控配置的人	想快速用上的人
多模型切换	每次改文件	托盘一点切换
我们站点的角色	讲清楚原理和每个字段	讲清楚怎么最快跑通

两者不冲突：CC Switch 先接上，有问题再回来看分步教程排查。

常见问题

Q：切换了 DeepSeek，终端里还是旧模型？
A：关掉终端窗口，开一个新的再试。Claude Code 部分版本支持热切换，其他 CLI 大多要重启。

Q：401 / 鉴权失败？
A：检查 API Key 是否完整、是否复制了空格；Claude Code 走 Anthropic 兼容端点时 Base URL 应为 https://api.deepseek.com/anthropic。

Q：CC Switch 和 deepseekagent.io 什么关系？
A：我们只做 DeepSeek + Agent 接入教程；CC Switch 是独立软件，我们推荐它在「配置太复杂」时作为捷径，不提供技术支持。

Q：Mac 提示「无法验证开发者」？
A：CC Switch 官方安装包的问题，可在系统设置 → 隐私与安全性里允许，或从官网 / Homebrew 安装最新版。

Q：还是不行？
A：按你用的工具打开详细教程对照排查：

Claude Code
OpenCode
Codex（较复杂，建议先试 CC Switch）
OpenClaw