手把手教你用 CC Switch Claude Code DeepSeek 搭建免费强大的 AI 编程助手Mac/Linux/Windows 全平台先搞懂这三样东西分别干啥Claude CodeAnthropic 官方出品的终端 AI Coding Agent相当于一个超级智能的“命令行程序员”。它原本只连 Anthropic 自己的 API收费。DeepSeek国内优秀的大模型提供了兼容 Anthropic Messages API 的端点https://api.deepseek.com/anthropic。这意味着 Claude Code 可以直接连 DeepSeek不需要任何代理。CC Switch一个开源桌面工具GitHub 上 farion1231/cc-switch44K Star用 Tauri 写的。它能帮你可视化管理Claude Code、Codex、Gemini CLI 等多个工具的 Provider、MCP 和 Skills 配置。简单说它就是一个“配置管家”让你点点鼠标就能切换后端模型不用手动改 JSON 文件。一句话总结Claude Code 是干活的车Agent就是这个概念DeepSeek 是发动机CC Switch 是方向盘和仪表盘。准备工作所有平台都要做的两件事无论你用 Mac、Linux 还是 Windows先把这两步搞定1. 安装 Node.js版本 ≥ 18Claude Code 是一个 npm 包所以 Node.js 是必须的。Macbrew install nodeLinuxUbuntu/Debiancurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejsWindows去 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-ganthropic-ai/claude-code安装完成后检查版本claude--version如果输出了版本号比如 0.2.11说明安装成功。⚠️ 第一次运行claude会提示你登录 Anthropic 账号先别管它我们后面会用 CC Switch 跳过这一步。第二步安装 CC Switch按你的平台选CC Switch 提供了多种安装方式挑一种你习惯的。 macOS最简单的是 Homebrewbrew 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_*.debFedora/RHEL下载.rpm包sudo rpm -ivh cc-switch-*.rpmArch Linuxparu -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 NameDeepSeek V4名字随意Base URLhttps://api.deepseek.com/anthropicAPI Keysk-你的DeepSeekKeyOpus / 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.jsonWindows 下是%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/anthropicModel→ 应该是deepseek-v4-pro[1m]然后再问它一句“你现在用的是哪个模型” 它会回答 DeepSeek。这就对了。终极验证去 DeepSeek 开放平台的“调用记录”页面看看有没有产生请求。有的话恭喜你全部配置成功第五步可选在 VSCode 或 JetBrains IDE 中使用如果你喜欢在编辑器里用 AI 助手Claude Code 也有插件。VSCode扩展市场搜索Claude Code for VS CodeAnthropic 官方出品。安装后侧边栏会出现 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!