最近 Claude Code 在开发者圈子里火得不行。作为 Anthropic 推出的命令行编程助手它内置了 MCP、Skills、Hooks、Sub-agents 等一整套扩展体系能完成很多传统 AI 工具做不到的事——比如自动化内容创作、CI/CD 自主开发、竞品监控等。但问题来了Claude Code 默认调用的是 Anthropic 自家的 Claude 系列模型国内访问不太稳定。好在它支持通过 CC Switch 接入第三方模型而 DeepSeek V4 Pro 作为国产最强推理模型之一正好可以补上这块短板。本文基于 Yin_Code 的实战教程完整梳理了从环境搭建到模型切换的全流程。跟着走十分钟内就能让 Claude Code 跑在 DeepSeek V4 Pro 上。一、Claude Code 是什么为什么值得折腾在动手之前先简单说说 Claude Code 的定位。它不是简单的聊天机器人而是一个常驻终端的编程代理。1.1 核心能力一览Claude Code 的能力体系可以分成三块模块说明Hooks确定性控制在生命周期特定节点自动触发脚本Sub-agents上下文隔离的子代理避免主会话被污染Agentic Tasks多智能体协作多个 Claude 实例直接通信MCP连接外部世界支持 GitHub、数据库、Slack 等 300 服务Skills渐进式加载的指令包比 Cursor Rules 更轻量Routines定时自动化可配置一次循环定时、API 或响应 GitHub 事件Voice Mode语音编程2026 年 3 月推出的语音交互模式1.2 实战场景举例视频里展示的几个典型用法挺有意思个人知识库自动整理监控收件箱文件夹新存入 PDF、网页剪藏自动触发处理读取→摘要→归类→更新索引自动化内容创作与发布预设内容日历定时触发抓取热点→模仿风格生成→你审核→自动发布博客/公众号/社交媒体CI/CD 自主开发自动创建分支、写代码、提 PR、等检查、合并失败丢弃重试一晚上把测试覆盖率从 0% 提到 80%这些场景靠单一模型很难完成但 Claude Code 的多代理协作 工具链集成让这件事变得可行。二、环境准备安装 Node.js、Git 和 CC SwitchClaude Code 基于 Node.js 构建所以第一步是搞定运行环境。2.1 安装 Node.js直接去 nodejs.org 下载 Windows 安装程序.msi一路下一步即可。装完后打开 CMD建议以管理员身份运行验证安装node -v # 输出类似v24.15.0 npm -v # 输出类似11.12.12.2 设置国内 npm 镜像源国内访问 npm 官方源速度感人建议切到淘宝镜像npm config set registry https://registry.npmmirror.com/2.3 安装 GitClaude Code 依赖 Git 做版本控制去 git-scm.com 下载 Windows 版安装包。装完同样验证git -v # 输出类似git version 2.54.0.windows.12.4 安装 CC Switch这是整个流程里最关键但最容易被忽略的一步。CC Switch是一个跨平台的桌面工具专门用来给 Claude Code、Codex、OpenCode 等 CLI 工具切换模型供应商。GitHub 仓库farion1231/cc-switch去 Releases 页面下载CC-Switch-v3.14.1-Windows.msi安装方式同样是双击一路下一步。三、安装 Claude Code环境就绪后安装 Claude Code 本身只需要一条命令npm install -g anthropic-ai/claude-code安装完成后新开一个 CMD 窗口让环境变量生效验证版本claude --version # 输出类似Claude Code v2.1.119四、关键配置跳过登录直接启动这是整个教程里最容易踩坑的地方。4.1 为什么需要改配置Claude Code 默认会尝试连接 Anthropic 的服务进行登录验证。但国内网络环境下这一步大概率会报错Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST解决办法是修改配置文件让 Claude Code 跳过登录流程。4.2 找到 .claude.json 文件打开文件资源管理器在地址栏输入你的用户名锁屏界面显示的那个名字回车点击上方工具栏的查看 → 显示 → 勾选文件扩展名和隐藏的项目找到.claude.json文件右键用记事本打开4.3 修改配置内容在文件末尾的最后一个字段后面加一个英文逗号然后新增一行hasCompletedOnboarding: true注意两个细节必须使用英文标点符号上一个字段末尾必须加英文逗号分隔改完后的配置大概长这样{ firstStartTime: 2026-04-27T07:29:06.843Z, opusProMigrationComplete: true, sonnet1m45MigrationComplete: true, migrationVersion: 12, userID: 107ea2b19f1847a1b9485388bcb59aeb7133645737a2e5d1595eeef3e005dcec, hasCompletedOnboarding: true }4.4 启动 Claude Code回到 CMD输入claude第一次启动会弹出一个安全确认Quick safety check: Is this a project you created or one you trust? 1. Yes, I trust this folder 2. No, exit选 1 回车确认就能看到欢迎界面了。此时显示 Not logged in 是正常的因为我们跳过了登录。五、接入 DeepSeek V4 Pro现在进入核心环节把 Claude Code 的底层模型从 Anthropic Claude 切换到 DeepSeek V4 Pro。5.1 获取 DeepSeek API Key访问 DeepSeek 开放平台注册/登录账号点击左侧API Keys点击创建 API key随便取个名字比如claude关键一步创建成功后立即点击复制按钮保存密钥⚠️ 安全提醒API key 只显示一次关闭弹窗后就无法再查看。如果丢失只能重新创建。千万不要把 key 泄露到公开仓库或文章里。5.2 在 CC Switch 中配置 DeepSeek打开 CC Switch 软件点击添加新供应商在列表中选择DeepSeek填入刚才复制的 API Key请求地址保持默认https://api.deepseek.com/anthropic在模型映射中把主模型、Haiku 默认模型、Sonnet 默认模型、Opus 默认模型全部填成deepseek-v4-pro[1m]点击添加保存5.3 验证模型切换回到 CMD重新启动 Claude Codeclaude启动后输入/model此时应该能看到模型列表里出现了 DeepSeek 的选项且默认已经被选中。你可以直接问它你当前是什么模型如果回复是我是 DeepSeek V4 Pro说明切换成功。六、实战测试用 DeepSeek 驱动 Claude Code 写一个 TODO 应用配置完成后做个简单的功能测试。在桌面新建一个文件夹比如叫todo在文件夹路径栏输入cmd打开命令提示符输入claude启动选择信任当前文件夹给 Claude Code 下指令帮我做一个 todo 软件使用 htmljscss 实现Claude Code 会自动分析需求、生成代码、写入文件。整个过程大概 2 分钟左右最终会在当前目录生成一个index.html文件直接用浏览器打开就能用。生成的 TODO 应用功能还挺完整添加任务输入框 按钮或按 Enter标记完成点击圆形复选框切换状态编辑任务双击文字进入编辑模式删除任务点击右侧 × 按钮筛选视图全部 / 未完成 / 已完成清除已完成一键删除已完成任务拖拽排序调整任务优先级本地存储数据自动保存到 localStorage刷新不丢失七、常见问题与排坑Q1: npm install 卡住或报错先检查是否设置了国内镜像源npm config get registry如果不是 https://registry.npmmirror.com/重新设置一下。Q2: Claude Code 启动后还是提示连接失败检查.claude.json里的hasCompletedOnboarding字段确认是true而不是true布尔值不要加引号确认前一个字段末尾加了英文逗号确认使用了英文标点没有中文逗号混进去Q3: CC Switch 添加供应商后 Claude Code 没反应确保 CC Switch 正在运行任务栏有图标然后完全退出 Claude Code按 CtrlC 或关闭窗口重新启动。Q4: DeepSeek API 调用报错检查API Key 是否复制完整以sk-开头账户余额是否充足新用户有少量赠送额度模型名称是否填对deepseek-v4-pro[1m]八、总结Claude Code DeepSeek V4 Pro 的组合本质上是用国产最强推理模型驱动最强编程代理。对于国内开发者来说这套方案解决了两个核心痛点网络问题通过 CC Switch 中转无需直接连接 Anthropic 服务成本问题DeepSeek API 价格远低于 Claude且支持人民币充值整个配置流程并不复杂但细节比较多尤其是.claude.json的标点符号。建议第一次跟着本文一步步走熟悉之后重装系统也能十分钟内搞定。如果你已经配置成功不妨让 Claude Code 帮你写个小项目试试——毕竟实践才是检验配置的唯一标准。参考资源Claude Code 官方文档https://docs.anthropic.com/en/docs/claude-codeCC Switch GitHub 仓库https://github.com/farion1231/cc-switchDeepSeek 开放平台https://platform.deepseek.com视频教程来源B站 UP主 Yin_Code
Claude Code 接入 DeepSeek V4 Pro 完整指南：国产大模型赋能最强编程代理
发布时间：2026/5/27 16:58:24
最近 Claude Code 在开发者圈子里火得不行。作为 Anthropic 推出的命令行编程助手它内置了 MCP、Skills、Hooks、Sub-agents 等一整套扩展体系能完成很多传统 AI 工具做不到的事——比如自动化内容创作、CI/CD 自主开发、竞品监控等。但问题来了Claude Code 默认调用的是 Anthropic 自家的 Claude 系列模型国内访问不太稳定。好在它支持通过 CC Switch 接入第三方模型而 DeepSeek V4 Pro 作为国产最强推理模型之一正好可以补上这块短板。本文基于 Yin_Code 的实战教程完整梳理了从环境搭建到模型切换的全流程。跟着走十分钟内就能让 Claude Code 跑在 DeepSeek V4 Pro 上。一、Claude Code 是什么为什么值得折腾在动手之前先简单说说 Claude Code 的定位。它不是简单的聊天机器人而是一个常驻终端的编程代理。1.1 核心能力一览Claude Code 的能力体系可以分成三块模块说明Hooks确定性控制在生命周期特定节点自动触发脚本Sub-agents上下文隔离的子代理避免主会话被污染Agentic Tasks多智能体协作多个 Claude 实例直接通信MCP连接外部世界支持 GitHub、数据库、Slack 等 300 服务Skills渐进式加载的指令包比 Cursor Rules 更轻量Routines定时自动化可配置一次循环定时、API 或响应 GitHub 事件Voice Mode语音编程2026 年 3 月推出的语音交互模式1.2 实战场景举例视频里展示的几个典型用法挺有意思个人知识库自动整理监控收件箱文件夹新存入 PDF、网页剪藏自动触发处理读取→摘要→归类→更新索引自动化内容创作与发布预设内容日历定时触发抓取热点→模仿风格生成→你审核→自动发布博客/公众号/社交媒体CI/CD 自主开发自动创建分支、写代码、提 PR、等检查、合并失败丢弃重试一晚上把测试覆盖率从 0% 提到 80%这些场景靠单一模型很难完成但 Claude Code 的多代理协作 工具链集成让这件事变得可行。二、环境准备安装 Node.js、Git 和 CC SwitchClaude Code 基于 Node.js 构建所以第一步是搞定运行环境。2.1 安装 Node.js直接去 nodejs.org 下载 Windows 安装程序.msi一路下一步即可。装完后打开 CMD建议以管理员身份运行验证安装node -v # 输出类似v24.15.0 npm -v # 输出类似11.12.12.2 设置国内 npm 镜像源国内访问 npm 官方源速度感人建议切到淘宝镜像npm config set registry https://registry.npmmirror.com/2.3 安装 GitClaude Code 依赖 Git 做版本控制去 git-scm.com 下载 Windows 版安装包。装完同样验证git -v # 输出类似git version 2.54.0.windows.12.4 安装 CC Switch这是整个流程里最关键但最容易被忽略的一步。CC Switch是一个跨平台的桌面工具专门用来给 Claude Code、Codex、OpenCode 等 CLI 工具切换模型供应商。GitHub 仓库farion1231/cc-switch去 Releases 页面下载CC-Switch-v3.14.1-Windows.msi安装方式同样是双击一路下一步。三、安装 Claude Code环境就绪后安装 Claude Code 本身只需要一条命令npm install -g anthropic-ai/claude-code安装完成后新开一个 CMD 窗口让环境变量生效验证版本claude --version # 输出类似Claude Code v2.1.119四、关键配置跳过登录直接启动这是整个教程里最容易踩坑的地方。4.1 为什么需要改配置Claude Code 默认会尝试连接 Anthropic 的服务进行登录验证。但国内网络环境下这一步大概率会报错Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST解决办法是修改配置文件让 Claude Code 跳过登录流程。4.2 找到 .claude.json 文件打开文件资源管理器在地址栏输入你的用户名锁屏界面显示的那个名字回车点击上方工具栏的查看 → 显示 → 勾选文件扩展名和隐藏的项目找到.claude.json文件右键用记事本打开4.3 修改配置内容在文件末尾的最后一个字段后面加一个英文逗号然后新增一行hasCompletedOnboarding: true注意两个细节必须使用英文标点符号上一个字段末尾必须加英文逗号分隔改完后的配置大概长这样{ firstStartTime: 2026-04-27T07:29:06.843Z, opusProMigrationComplete: true, sonnet1m45MigrationComplete: true, migrationVersion: 12, userID: 107ea2b19f1847a1b9485388bcb59aeb7133645737a2e5d1595eeef3e005dcec, hasCompletedOnboarding: true }4.4 启动 Claude Code回到 CMD输入claude第一次启动会弹出一个安全确认Quick safety check: Is this a project you created or one you trust? 1. Yes, I trust this folder 2. No, exit选 1 回车确认就能看到欢迎界面了。此时显示 Not logged in 是正常的因为我们跳过了登录。五、接入 DeepSeek V4 Pro现在进入核心环节把 Claude Code 的底层模型从 Anthropic Claude 切换到 DeepSeek V4 Pro。5.1 获取 DeepSeek API Key访问 DeepSeek 开放平台注册/登录账号点击左侧API Keys点击创建 API key随便取个名字比如claude关键一步创建成功后立即点击复制按钮保存密钥⚠️ 安全提醒API key 只显示一次关闭弹窗后就无法再查看。如果丢失只能重新创建。千万不要把 key 泄露到公开仓库或文章里。5.2 在 CC Switch 中配置 DeepSeek打开 CC Switch 软件点击添加新供应商在列表中选择DeepSeek填入刚才复制的 API Key请求地址保持默认https://api.deepseek.com/anthropic在模型映射中把主模型、Haiku 默认模型、Sonnet 默认模型、Opus 默认模型全部填成deepseek-v4-pro[1m]点击添加保存5.3 验证模型切换回到 CMD重新启动 Claude Codeclaude启动后输入/model此时应该能看到模型列表里出现了 DeepSeek 的选项且默认已经被选中。你可以直接问它你当前是什么模型如果回复是我是 DeepSeek V4 Pro说明切换成功。六、实战测试用 DeepSeek 驱动 Claude Code 写一个 TODO 应用配置完成后做个简单的功能测试。在桌面新建一个文件夹比如叫todo在文件夹路径栏输入cmd打开命令提示符输入claude启动选择信任当前文件夹给 Claude Code 下指令帮我做一个 todo 软件使用 htmljscss 实现Claude Code 会自动分析需求、生成代码、写入文件。整个过程大概 2 分钟左右最终会在当前目录生成一个index.html文件直接用浏览器打开就能用。生成的 TODO 应用功能还挺完整添加任务输入框 按钮或按 Enter标记完成点击圆形复选框切换状态编辑任务双击文字进入编辑模式删除任务点击右侧 × 按钮筛选视图全部 / 未完成 / 已完成清除已完成一键删除已完成任务拖拽排序调整任务优先级本地存储数据自动保存到 localStorage刷新不丢失七、常见问题与排坑Q1: npm install 卡住或报错先检查是否设置了国内镜像源npm config get registry如果不是 https://registry.npmmirror.com/重新设置一下。Q2: Claude Code 启动后还是提示连接失败检查.claude.json里的hasCompletedOnboarding字段确认是true而不是true布尔值不要加引号确认前一个字段末尾加了英文逗号确认使用了英文标点没有中文逗号混进去Q3: CC Switch 添加供应商后 Claude Code 没反应确保 CC Switch 正在运行任务栏有图标然后完全退出 Claude Code按 CtrlC 或关闭窗口重新启动。Q4: DeepSeek API 调用报错检查API Key 是否复制完整以sk-开头账户余额是否充足新用户有少量赠送额度模型名称是否填对deepseek-v4-pro[1m]八、总结Claude Code DeepSeek V4 Pro 的组合本质上是用国产最强推理模型驱动最强编程代理。对于国内开发者来说这套方案解决了两个核心痛点网络问题通过 CC Switch 中转无需直接连接 Anthropic 服务成本问题DeepSeek API 价格远低于 Claude且支持人民币充值整个配置流程并不复杂但细节比较多尤其是.claude.json的标点符号。建议第一次跟着本文一步步走熟悉之后重装系统也能十分钟内搞定。如果你已经配置成功不妨让 Claude Code 帮你写个小项目试试——毕竟实践才是检验配置的唯一标准。参考资源Claude Code 官方文档https://docs.anthropic.com/en/docs/claude-codeCC Switch GitHub 仓库https://github.com/farion1231/cc-switchDeepSeek 开放平台https://platform.deepseek.com视频教程来源B站 UP主 Yin_Code
