20 EmptyState 空状态设计：插画、动画与交互反馈
2026/7/10 11:52:23
手把手教你用 CC Switch + Claude Code + DeepSeek 搭建免费强大的 AI 编程助手（Mac/Linux/Windows 全平台）
先搞懂这三样东西分别干啥
- Claude Code：Anthropic 官方出品的终端 AI Coding Agent，相当于一个超级智能的“命令行程序员”。它原本只连 Anthropic 自己的 API（收费）。
- DeepSeek：国内优秀的大模型，提供了兼容 Anthropic Messages API 的端点（
https://api.deepseek.com/anthropic）。这意味着 Claude Code 可以直接连 DeepSeek，不需要任何代理。 - CC Switch：一个开源桌面工具（GitHub 上 farion1231/cc-switch，44K+ Star），用 Tauri 写的。它能帮你可视化管理Claude Code、Codex、Gemini CLI 等多个工具的 Provider、MCP 和 Skills 配置。简单说，它就是一个“配置管家”，让你点点鼠标就能切换后端模型，不用手动改 JSON 文件。
一句话总结：Claude Code 是干活的车（Agent就是这个概念），DeepSeek 是发动机，CC Switch 是方向盘和仪表盘。
准备工作：所有平台都要做的两件事
无论你用 Mac、Linux 还是 Windows，先把这两步搞定：
1. 安装 Node.js（版本 ≥ 18）
Claude Code 是一个 npm 包，所以 Node.js 是必须的。
- Mac：
brew install node - Linux（Ubuntu/Debian）：
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt-get install -y nodejs - Windows：去 https://nodejs.org 下载 LTS 版本的 .msi 安装包，一路 Next，记得勾选“Add to PATH”。
装完后打开终端验证：
node-vnpm-v能看到版本号就行。
2. 获取 DeepSeek API Key
- 访问 https://platform.deepseek.com，注册账号。
- 进入 API Keys 页面，点击“新建 API Key”。
- 复制生成的
sk-开头的字符串（只显示一次，务必保存好）。 - 充点钱，最低 1 元人民币就够了，够你用很久。
第一步：安装 Claude Code
全局安装，一行命令：
npminstall-g@anthropic-ai/claude-code安装完成后检查版本：
claude--version如果输出了版本号（比如 0.2.11），说明安装成功。
⚠️ 第一次运行
claude会提示你登录 Anthropic 账号，先别管它，我们后面会用 CC Switch 跳过这一步。
第二步：安装 CC Switch（按你的平台选）
CC Switch 提供了多种安装方式，挑一种你习惯的。
🍎 macOS
最简单的是 Homebrew：
brew tap farion1231/ccswitch brewinstall--caskcc-switch如果没有 Homebrew，可以去 https://github.com/farion1231/cc-switch/releases/latest 下载.dmg文件，拖到 Applications 文件夹。
🐧 Linux
根据你的发行版选择：
- Debian/Ubuntu：下载
.deb包，然后sudo dpkg -i cc-switch_*.deb - Fedora/RHEL：下载
.rpm包，sudo rpm -ivh cc-switch-*.rpm - Arch Linux：
paru -S cc-switch-bin - 通用方法：下载 AppImage 文件，赋予执行权限后双击运行：
chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage
🪟 Windows
- 去 https://github.com/farion1231/cc-switch/releases/latest 下载
CC-Switch-*-Windows.msi。 - 双击安装，完成后在开始菜单找到 CC Switch 并启动。
- 如果你打算在 WSL 里用 Claude Code，也没关系——CC Switch 写入的是 Windows 下的
%USERPROFILE%\.claude\settings.json，而 WSL 会自动映射这个路径，两边能共享配置。
第三步：在 CC Switch 中添加 DeepSeek Provider
这一步是整个教程的核心，也是最爽的一步——不用手写任何 JSON。
- 打开 CC Switch，第一次启动会让你选择要管理的工具，勾选 Claude Code（也可以顺手勾上 Codex 和 Gemini，以后用得着）。
- 左侧导航切换到Claude标签页。
- 点击右上角的“+”按钮添加新的 Provider。
- 在预设列表中搜索DeepSeek，选中它（如果没有，就手动创建一个）。
- 填写以下参数：
| 字段 | 值 |
|---|---|
| Provider Name | DeepSeek V4（名字随意） |
| Base URL | https://api.deepseek.com/anthropic |
| API Key | sk-你的DeepSeekKey |
| Opus / Sonnet（主模型） | deepseek-v4-pro[1m] |
| Haiku / 子任务模型 | deepseek-v4-flash |
💡
[1m]表示开启 1M 上下文窗口，DeepSeek 目前支持这个后缀。如果 CC Switch 新版有单独的“上下文长度”选项，你也可以在那里设置。
- 如果你想用最大思考强度（Effort Level），可以在高级设置里添加环境变量：
CLAUDE_CODE_EFFORT_LEVEL: max。 - 点击保存，然后点亮该 Provider 右侧的开关。
就这么简单！CC Switch 会自动修改~/.claude/settings.json（Windows 下是%USERPROFILE%\.claude\settings.json），写入类似下面的内容：
{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"sk-你的Key","ANTHROPIC_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro[1m]","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-flash","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-flash","CLAUDE_CODE_EFFORT_LEVEL":"max"}}⚠️ 注意：DeepSeek 的 Anthropic 兼容端点只识别
ANTHROPIC_AUTH_TOKEN，而不是ANTHROPIC_API_KEY。很多教程写错了，导致连不上。
第四步：验证是否生效
关闭所有现有终端，然后打开一个新的终端窗口（这样才能加载最新的环境变量）。
进入你的项目目录（比如cd ~/my-project），然后运行：
claude如果一切顺利，你会直接进入 Claude Code 的交互界面，不再要求登录。输入：
/status重点关注这两行：
- API Endpoint→ 应该是
https://api.deepseek.com/anthropic - Model→ 应该是
deepseek-v4-pro[1m]
然后再问它一句：“你现在用的是哪个模型？” 它会回答 DeepSeek。这就对了。
终极验证：去 DeepSeek 开放平台的“调用记录”页面，看看有没有产生请求。有的话，恭喜你，全部配置成功！
第五步（可选）：在 VSCode 或 JetBrains IDE 中使用
如果你喜欢在编辑器里用 AI 助手，Claude Code 也有插件。
VSCode
- 扩展市场搜索Claude Code for VS Code（Anthropic 官方出品）。
- 安装后，侧边栏会出现 Claude 图标。
- 点击它，它会自动读取你刚才 CC Switch 配置好的全局设置，无需再次输入 API Key。
IntelliJ IDEA
- 插件市场搜索Claude Code [Beta]。
- 安装后，它会调用本地的
claudeCLI，同样继承 CC Switch 的环境变量。
常见问题排雷
| 问题 | 原因与解决 |
|---|---|
/status显示的还是 Anthropic 官方地址 | 终端没重启，或者 settings.json 被其他环境变量覆盖。关掉所有终端重开。 |
| 报 401 Unauthorized | 你把ANTHROPIC_AUTH_TOKEN写成了ANTHROPIC_API_KEY。DeepSeek 只认前者。 |
| 报模型不存在（404） | 模型名可能写错了，或者没加[1m]后缀。去 DeepSeek 官网查看当前支持的模型列表。 |
Windows 下claude报 git 相关错误 | 没安装 Git for Windows，下载安装即可。 |
CC Switch 启用了，但claude还是让我登录 | 检查~/.claude.json（注意不是 settings.json）是否存在，如果不存在，新建一个文件写入{"hasCompletedOnboarding": true}跳过引导。 |
| 切了 Provider 但没生效 | 检查 CC Switch 里当前激活的 Profile 是否正确，以及是否点了“启用”按钮。 |
进阶玩法：多 Provider 自由切换
CC Switch 最大的魅力在于你可以添加多个 Provider，比如：
- DeepSeek（主力，便宜长上下文）
- SiliconFlow（另一个国产兼容端点）
- OpenRouter（聚合多家模型）
- 甚至你自己部署的 vLLM 服务
每个 Provider 都可以单独配置模型、API Key、Base URL。需要切换时，只需在 CC Switch 中点一下对应 Provider 的开关，然后重启终端（或重新打开编辑器）即可。再也不用手动改 JSON 了。
写在最后
这套组合拳的好处是：
- 省钱：DeepSeek 的价格远低于 Anthropic 官方，尤其适合日常编码辅助。
- 灵活：CC Switch 让你像换衣服一样切换不同的 AI 后端。
- 强大：Claude Code 本身的 Agent 能力（自动读文件、写代码、运行命令）加上 DeepSeek 的 1M 上下文，处理大型项目游刃有余。
如果你是第一次接触这些工具，可能会觉得步骤有点多。但相信我，只要按照上面的顺序一步步来，最多十分钟就能跑起来。一旦用上，你就再也回不去普通的 ChatGPT 聊天界面了。
有任何问题，欢迎在评论区留言。也欢迎分享你配置成功的截图，让大家一起感受 AI 编程的快乐。
Happy coding! 🚀