零基础保姆级教程用 CC-Switch Claude Code 接入 DeepSeek-V4-Pro适合人群完全没有基础的小白 |预计耗时30~60 分钟目标让你在终端里用 Claude Code 的强大工具链调用 DeepSeek-V4-Pro 的顶级能力低成本享受 AI 编程助手 教程目录整体介绍我们在做什么准备工作申请 DeepSeek API Key第一步安装 Node.js第二步安装 Claude Code第三步下载并安装 CC-Switch第四步在 CC-Switch 中配置 DeepSeek第五步启动 Claude Code 并验证常见问题与解决方案手动配置备用方案1. 整体介绍我们在做什么关键名词解释名词是什么用来做什么Claude CodeAnthropic 出品的 AI 编程命令行工具在终端里让 AI 帮你写代码、改 Bug、分析项目DeepSeek-V4-Pro深度求索最新旗舰模型性能比肩 Claude Opus 4.6但 API 价格便宜了两个数量级CC-Switch开源的图形化配置管理工具帮你一键切换 Claude Code 背后使用的模型不用手动改配置文件Anthropic 兼容接口DeepSeek 提供的 API 兼容层让 Claude Code 可以直接认识DeepSeek无需额外适配为什么要这样做Claude Code 本身需要订阅 Claude在国内使用有一定门槛。而 DeepSeek 提供了一个与 Anthropic API 完全兼容的接口只需要将 Claude Code 的请求地址换成 DeepSeek 的地址就能无缝使用 DeepSeek-V4-Pro——保留 Claude Code 强大的工具链和执行力换上 DeepSeek 高性价比的模型。CC-Switch 则让整个配置过程变得非常简单有图形界面不需要手动改 JSON 文件。关于[1m]的重要说明 ⚠️在配置 DeepSeek 模型名称时必须写成deepseek-v4-pro[1m]而不是deepseek-v4-pro。原因加上[1m]才能开启100 万 Token 的超长上下文。不加的话只有默认的较短上下文对于大型项目分析会有明显限制。这是一个非常容易漏掉的关键细节2. 准备工作申请 DeepSeek API Key在开始安装任何软件之前先去申请 DeepSeek 的 API Key。步骤打开浏览器访问 DeepSeek 开放平台https://platform.deepseek.com/api_keys注册/登录账号支持微信扫码、手机号进入控制台后点击左侧菜单的「API Keys」点击「创建 API Key」给它起个名字比如claude-code然后点确认⚠️立刻复制并保存好这个 Key它只显示一次关闭就看不到了Key 的格式类似sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx账号里要有余额才能使用。新用户一般有免费额度不够可以充值10元可用很久3. 第一步安装 Node.jsClaude Code 基于 Node.js 运行必须先安装。Windows 用户打开浏览器访问 Node.js 官网https://nodejs.org/选择左边的LTS长期支持版下载比如v22.x.x LTS下载完成后双击.msi安装包一路点 Next注意勾选以下两个选项✅Add to PATH把 Node.js 加入系统环境变量✅Automatically install the necessary tools自动安装必要工具安装完成后打开 PowerShell 或命令提示符CMD输入以下命令验证node-vnpm-v如果看到类似v22.x.x和10.x.x的版本号说明安装成功Mac 用户Mac 推荐使用 Homebrew 安装如果没有 Homebrew先看下面的提示# 安装 Homebrew如果已有可跳过/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnode也可以直接去官网下载.pkg安装包步骤和 Windows 类似。验证安装node-vnpm-vLinux 用户Ubuntu/Debian# 安装 nvmNode 版本管理器curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash# 重启终端后安装 Node.js LTSnvminstall--ltsnvm use--lts# 验证node-vnpm-v4. 第二步安装 Claude CodeNode.js 安装好之后通过 npm 全局安装 Claude Code。打开终端Windows 用 PowerShell 或 CMDMac/Linux 用 Terminal输入npminstall-ganthropic-ai/claude-code等待安装完成需要几十秒到几分钟取决于网络情况。安装完成后验证是否成功claude--version如果显示版本号如1.x.x安装成功提示图片位置【在此插入 claude --version 命令执行结果截图】⚠️Windows 用户常见问题如果提示无法加载文件因为在此系统上禁止运行脚本请以管理员身份打开 PowerShell执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser然后重新安装。5. 第三步下载并安装 CC-SwitchCC-Switch 是一个图形界面工具帮助你管理和切换 Claude Code 使用的 AI 模型。下载 CC-Switch访问 CC-Switch 的 GitHub Releases 页面 https://github.com/farion1231/cc-switch/releases根据你的操作系统选择对应的安装包操作系统选择的文件Windowscc-switch_x.x.x_x64-setup.exeMac (Intel 芯片)cc-switch_x.x.x_x64.dmgMac (Apple M 芯片)cc-switch_x.x.x_aarch64.dmgLinuxcc-switch_x.x.x_amd64.AppImageWindows 安装注意事项Windows 用户安装前需要先确认系统是否安装了Microsoft Edge WebView2 Runtime。检查方法打开控制面板 → “程序” → “程序和功能”查找是否有Microsoft Edge WebView2 Runtime。如果没有访问以下地址下载安装https://developer.microsoft.com/en-us/microsoft-edge/webview2/下载后双击安装安装过程是自动的静默模式装完重启一下即可。提示图片位置【在此插入 WebView2 下载页面截图】Mac 安装注意事项Mac 用户也可以通过 Homebrew 安装推荐# 添加 tap 并安装brew tap farion1231/ccswitch brewinstall--caskcc-switch如果是手动下载的.dmg打开后把CC-Switch.app拖入「应用程序」文件夹即可。首次打开时 Mac 可能提示无法验证开发者解决方法打开「系统设置」→「隐私与安全性」→ 找到 CC-Switch点击「仍要打开」。安装完成安装成功后打开 CC-Switch系统托盘任务栏右下角/菜单栏会出现 CC-Switch 的图标主界面如下所示。6. 第四步在 CC-Switch 中配置 DeepSeek这是最关键的步骤打开 CC-Switch 主界面启动 CC-Switch你会看到主界面顶部有应用切换栏Claude Code / Codex / Gemini CLI 等确保当前选中的是Claude Code。添加 DeepSeek Provider点击右上角的「」按钮进入添加供应商页面你会看到一些内置预设DeepSeek、Kimi、智谱等。如果列表里有 DeepSeek 预设直接选择即可如果没有选择「自定义」或「Custom」手动填写以下信息字段名填写内容名称NameDeepSeek V4 Pro随意起名方便识别Base URLhttps://api.deepseek.com/anthropicAPI Key你在第2步申请的 DeepSeek API Key认证类型Auth TypeANTHROPIC_AUTH_TOKENAPI 格式Anthropic接下来配置模型名称⚠️这一步极其重要模型配置项填写内容说明主模型Modeldeepseek-v4-pro[1m]必须加[1m]开启 100 万 Token 上下文Opus 模型deepseek-v4-pro[1m]复杂任务使用Sonnet 模型deepseek-v4-pro[1m]默认任务使用Haiku 模型deepseek-v4-flash快速/简单任务更省钱子代理模型deepseek-v4-flash后台子任务⚠️再次强调模型名称deepseek-v4-pro[1m]中的[1m]千万不能省略这是 DeepSeek API 的特殊语法用来激活 100 万 Token 的超长上下文窗口。如果只写deepseek-v4-pro上下文会大幅缩短处理大型项目时会有问题。提示图片位置【在此插入模型名称配置截图重点标注 [1m] 部分】其他可选配置建议开启将CLAUDE_CODE_EFFORT_LEVEL设置为max让模型以满血状态运行充分调用思考能力将API_TIMEOUT_MS设置为3000000防止长任务超时DeepSeek 处理复杂请求有时需要较长时间确认所有信息填写无误后点击「保存」或「添加」启用 DeepSeek Provider配置保存后在供应商列表中找到刚才添加的DeepSeek V4 Pro点击「启用」。CC-Switch 会自动将配置写入 Claude Code 的配置文件~/.claude/settings.json无需手动操作。提示图片位置【在此插入供应商列表截图显示 DeepSeek 已启用绿色状态】健康检查验证配置是否正确启用后点击 Provider 旁的「健康检查」按钮CC-Switch 会发送一个测试请求验证 API Key 和网络连通性。✅显示成功或绿色状态配置正确可以使用❌显示错误请检查 API Key 是否正确、是否有余额7. 第五步启动 Claude Code 并验证启动 Claude Code打开终端PowerShell / CMD / Terminal进入你的项目目录然后输入cd你的项目文件夹路径 claude例如cd~/Desktop/my-project claude如果是第一次运行Claude Code 会有一个简短的初始化流程直接按提示操作即可无需登录 Anthropic 账号使用 DeepSeek API 不需要 Claude 账号。确认模型是否正确进入 Claude Code 界面后输入以下命令查看当前状态/status你会看到类似这样的输出Model: deepseek-v4-pro[1m] API Base URL: https://api.deepseek.com/anthropic ...如果Model一行显示的是deepseek-v4-pro[1m]说明接入成功测试一下试着让 Claude Code 做一件简单的事你好请介绍一下你自己你现在使用的是什么模型或者让它帮你写一段代码帮我写一个 Python 函数输入一个列表返回列表中所有偶数的平方和如果 Claude Code 正常响应并给出答案恭喜你整个配置已经完成8. 常见问题与解决方案❓ Q1启动 claude 后提示 “Not logged in, please run /login”原因认证类型选择了ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。解决方案回到 CC-Switch编辑 DeepSeek Provider 的配置将认证类型改为ANTHROPIC_AUTH_TOKEN保存后重新启用。❓ Q2提示 400 错误 / Bad Request可能原因 1模型名称填错了。检查是否正确填写了deepseek-v4-pro[1m]注意中括号和 1m。可能原因 2API 格式选择有误确保选择的是Anthropic兼容格式而不是OpenAI chat completions。可能原因 3Base URL 末尾多了或少了斜杠正确格式为https://api.deepseek.com/anthropic结尾无斜杠。❓ Q3模型名称不显示 1M 上下文原因模型名称没有加[1m]后缀。解决方案在 CC-Switch 中将所有需要长上下文的模型字段Opus、Sonnet、主模型都改为deepseek-v4-pro[1m]保存并重新启用。❓ Q4Windows 下 CC-Switch 安装失败提示缺少 WebView2解决方案参考第5步先安装 Microsoft Edge WebView2 Runtime然后重新安装 CC-Switch。❓ Q5npm install 报错提示网络超时解决方案Windows尝试切换 npm 镜像源到国内镜像npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code解决方案Mac/Linux同上或者使用代理工具后再安装。❓ Q6健康检查失败提示余额不足解决方案登录 https://platform.deepseek.com/ 充值账户余额。DeepSeek V4-Pro 的价格非常实惠10元可以使用很长时间。❓ Q7响应速度慢感觉在等待原因DeepSeek-V4-Pro 使用了思维链推理复杂任务确实需要思考时间这是正常现象。解决方案确保API_TIMEOUT_MS设置为足够大的值如3000000防止超时中断。9. 手动配置备用方案可选如果 CC-Switch 图形界面遇到问题也可以直接手动配置环境变量效果完全一样。Mac / Linux 用户终端将以下内容添加到你的 Shell 配置文件~/.zshrc或~/.bashrcexportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN你的DeepSeek_API_KeyexportANTHROPIC_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashexportCLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashexportCLAUDE_CODE_EFFORT_LEVELmaxexportCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1exportAPI_TIMEOUT_MS3000000保存后执行source ~/.zshrc或重启终端然后运行claude即可。Windows 用户PowerShell在 PowerShell 中执行每次重启终端需要重新执行建议加入 PowerShell Profile$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key$env:ANTHROPIC_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash$env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash$env:CLAUDE_CODE_EFFORT_LEVELmax$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1$env:API_TIMEOUT_MS3000000直接写入 Claude Code 配置文件也可以直接编辑~/.claude/settings.json在env字段中添加{env:{ANTHROPIC_AUTH_TOKEN:你的DeepSeek_API_Key,ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,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,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,API_TIMEOUT_MS:3000000},hasCompletedOnboarding:true}保存后直接运行claude即可生效无需重启终端。✅ 配置完成检查清单完成教程后逐一确认以下项目DeepSeek API Key 已申请并保存Node.js 已安装node -v能显示版本号Claude Code 已安装claude --version能显示版本号CC-Switch 已安装并能正常打开CC-Switch 中已添加 DeepSeek ProviderBase URL 和 API Key 填写正确模型名称填写的是deepseek-v4-pro[1m]包含[1m]认证类型选择的是ANTHROPIC_AUTH_TOKEN健康检查通过绿色状态运行claude后/status显示 Model 为deepseek-v4-pro[1m]全部打勾代表你已经成功配置好 Claude Code DeepSeek-V4-Pro可以开始享受低成本的顶级 AI 编程体验了 参考资源DeepSeek 官方接入文档https://api-docs.deepseek.com/guides/coding_agentsCC-Switch 开源项目https://github.com/farion1231/cc-switchDeepSeek API Key 申请https://platform.deepseek.com/api_keysClaude Code 官方文档https://docs.anthropic.com/en/docs/claude-code
零基础保姆级教程：用 CC-Switch + Claude Code 接入 DeepSeek-V4-Pro
发布时间：2026/7/18 0:46:29
零基础保姆级教程用 CC-Switch Claude Code 接入 DeepSeek-V4-Pro适合人群完全没有基础的小白 |预计耗时30~60 分钟目标让你在终端里用 Claude Code 的强大工具链调用 DeepSeek-V4-Pro 的顶级能力低成本享受 AI 编程助手 教程目录整体介绍我们在做什么准备工作申请 DeepSeek API Key第一步安装 Node.js第二步安装 Claude Code第三步下载并安装 CC-Switch第四步在 CC-Switch 中配置 DeepSeek第五步启动 Claude Code 并验证常见问题与解决方案手动配置备用方案1. 整体介绍我们在做什么关键名词解释名词是什么用来做什么Claude CodeAnthropic 出品的 AI 编程命令行工具在终端里让 AI 帮你写代码、改 Bug、分析项目DeepSeek-V4-Pro深度求索最新旗舰模型性能比肩 Claude Opus 4.6但 API 价格便宜了两个数量级CC-Switch开源的图形化配置管理工具帮你一键切换 Claude Code 背后使用的模型不用手动改配置文件Anthropic 兼容接口DeepSeek 提供的 API 兼容层让 Claude Code 可以直接认识DeepSeek无需额外适配为什么要这样做Claude Code 本身需要订阅 Claude在国内使用有一定门槛。而 DeepSeek 提供了一个与 Anthropic API 完全兼容的接口只需要将 Claude Code 的请求地址换成 DeepSeek 的地址就能无缝使用 DeepSeek-V4-Pro——保留 Claude Code 强大的工具链和执行力换上 DeepSeek 高性价比的模型。CC-Switch 则让整个配置过程变得非常简单有图形界面不需要手动改 JSON 文件。关于[1m]的重要说明 ⚠️在配置 DeepSeek 模型名称时必须写成deepseek-v4-pro[1m]而不是deepseek-v4-pro。原因加上[1m]才能开启100 万 Token 的超长上下文。不加的话只有默认的较短上下文对于大型项目分析会有明显限制。这是一个非常容易漏掉的关键细节2. 准备工作申请 DeepSeek API Key在开始安装任何软件之前先去申请 DeepSeek 的 API Key。步骤打开浏览器访问 DeepSeek 开放平台https://platform.deepseek.com/api_keys注册/登录账号支持微信扫码、手机号进入控制台后点击左侧菜单的「API Keys」点击「创建 API Key」给它起个名字比如claude-code然后点确认⚠️立刻复制并保存好这个 Key它只显示一次关闭就看不到了Key 的格式类似sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx账号里要有余额才能使用。新用户一般有免费额度不够可以充值10元可用很久3. 第一步安装 Node.jsClaude Code 基于 Node.js 运行必须先安装。Windows 用户打开浏览器访问 Node.js 官网https://nodejs.org/选择左边的LTS长期支持版下载比如v22.x.x LTS下载完成后双击.msi安装包一路点 Next注意勾选以下两个选项✅Add to PATH把 Node.js 加入系统环境变量✅Automatically install the necessary tools自动安装必要工具安装完成后打开 PowerShell 或命令提示符CMD输入以下命令验证node-vnpm-v如果看到类似v22.x.x和10.x.x的版本号说明安装成功Mac 用户Mac 推荐使用 Homebrew 安装如果没有 Homebrew先看下面的提示# 安装 Homebrew如果已有可跳过/bin/bash-c$(curl-fsSLhttps://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)# 安装 Node.jsbrewinstallnode也可以直接去官网下载.pkg安装包步骤和 Windows 类似。验证安装node-vnpm-vLinux 用户Ubuntu/Debian# 安装 nvmNode 版本管理器curl-o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh|bash# 重启终端后安装 Node.js LTSnvminstall--ltsnvm use--lts# 验证node-vnpm-v4. 第二步安装 Claude CodeNode.js 安装好之后通过 npm 全局安装 Claude Code。打开终端Windows 用 PowerShell 或 CMDMac/Linux 用 Terminal输入npminstall-ganthropic-ai/claude-code等待安装完成需要几十秒到几分钟取决于网络情况。安装完成后验证是否成功claude--version如果显示版本号如1.x.x安装成功提示图片位置【在此插入 claude --version 命令执行结果截图】⚠️Windows 用户常见问题如果提示无法加载文件因为在此系统上禁止运行脚本请以管理员身份打开 PowerShell执行Set-ExecutionPolicy-ExecutionPolicy RemoteSigned-Scope CurrentUser然后重新安装。5. 第三步下载并安装 CC-SwitchCC-Switch 是一个图形界面工具帮助你管理和切换 Claude Code 使用的 AI 模型。下载 CC-Switch访问 CC-Switch 的 GitHub Releases 页面 https://github.com/farion1231/cc-switch/releases根据你的操作系统选择对应的安装包操作系统选择的文件Windowscc-switch_x.x.x_x64-setup.exeMac (Intel 芯片)cc-switch_x.x.x_x64.dmgMac (Apple M 芯片)cc-switch_x.x.x_aarch64.dmgLinuxcc-switch_x.x.x_amd64.AppImageWindows 安装注意事项Windows 用户安装前需要先确认系统是否安装了Microsoft Edge WebView2 Runtime。检查方法打开控制面板 → “程序” → “程序和功能”查找是否有Microsoft Edge WebView2 Runtime。如果没有访问以下地址下载安装https://developer.microsoft.com/en-us/microsoft-edge/webview2/下载后双击安装安装过程是自动的静默模式装完重启一下即可。提示图片位置【在此插入 WebView2 下载页面截图】Mac 安装注意事项Mac 用户也可以通过 Homebrew 安装推荐# 添加 tap 并安装brew tap farion1231/ccswitch brewinstall--caskcc-switch如果是手动下载的.dmg打开后把CC-Switch.app拖入「应用程序」文件夹即可。首次打开时 Mac 可能提示无法验证开发者解决方法打开「系统设置」→「隐私与安全性」→ 找到 CC-Switch点击「仍要打开」。安装完成安装成功后打开 CC-Switch系统托盘任务栏右下角/菜单栏会出现 CC-Switch 的图标主界面如下所示。6. 第四步在 CC-Switch 中配置 DeepSeek这是最关键的步骤打开 CC-Switch 主界面启动 CC-Switch你会看到主界面顶部有应用切换栏Claude Code / Codex / Gemini CLI 等确保当前选中的是Claude Code。添加 DeepSeek Provider点击右上角的「」按钮进入添加供应商页面你会看到一些内置预设DeepSeek、Kimi、智谱等。如果列表里有 DeepSeek 预设直接选择即可如果没有选择「自定义」或「Custom」手动填写以下信息字段名填写内容名称NameDeepSeek V4 Pro随意起名方便识别Base URLhttps://api.deepseek.com/anthropicAPI Key你在第2步申请的 DeepSeek API Key认证类型Auth TypeANTHROPIC_AUTH_TOKENAPI 格式Anthropic接下来配置模型名称⚠️这一步极其重要模型配置项填写内容说明主模型Modeldeepseek-v4-pro[1m]必须加[1m]开启 100 万 Token 上下文Opus 模型deepseek-v4-pro[1m]复杂任务使用Sonnet 模型deepseek-v4-pro[1m]默认任务使用Haiku 模型deepseek-v4-flash快速/简单任务更省钱子代理模型deepseek-v4-flash后台子任务⚠️再次强调模型名称deepseek-v4-pro[1m]中的[1m]千万不能省略这是 DeepSeek API 的特殊语法用来激活 100 万 Token 的超长上下文窗口。如果只写deepseek-v4-pro上下文会大幅缩短处理大型项目时会有问题。提示图片位置【在此插入模型名称配置截图重点标注 [1m] 部分】其他可选配置建议开启将CLAUDE_CODE_EFFORT_LEVEL设置为max让模型以满血状态运行充分调用思考能力将API_TIMEOUT_MS设置为3000000防止长任务超时DeepSeek 处理复杂请求有时需要较长时间确认所有信息填写无误后点击「保存」或「添加」启用 DeepSeek Provider配置保存后在供应商列表中找到刚才添加的DeepSeek V4 Pro点击「启用」。CC-Switch 会自动将配置写入 Claude Code 的配置文件~/.claude/settings.json无需手动操作。提示图片位置【在此插入供应商列表截图显示 DeepSeek 已启用绿色状态】健康检查验证配置是否正确启用后点击 Provider 旁的「健康检查」按钮CC-Switch 会发送一个测试请求验证 API Key 和网络连通性。✅显示成功或绿色状态配置正确可以使用❌显示错误请检查 API Key 是否正确、是否有余额7. 第五步启动 Claude Code 并验证启动 Claude Code打开终端PowerShell / CMD / Terminal进入你的项目目录然后输入cd你的项目文件夹路径 claude例如cd~/Desktop/my-project claude如果是第一次运行Claude Code 会有一个简短的初始化流程直接按提示操作即可无需登录 Anthropic 账号使用 DeepSeek API 不需要 Claude 账号。确认模型是否正确进入 Claude Code 界面后输入以下命令查看当前状态/status你会看到类似这样的输出Model: deepseek-v4-pro[1m] API Base URL: https://api.deepseek.com/anthropic ...如果Model一行显示的是deepseek-v4-pro[1m]说明接入成功测试一下试着让 Claude Code 做一件简单的事你好请介绍一下你自己你现在使用的是什么模型或者让它帮你写一段代码帮我写一个 Python 函数输入一个列表返回列表中所有偶数的平方和如果 Claude Code 正常响应并给出答案恭喜你整个配置已经完成8. 常见问题与解决方案❓ Q1启动 claude 后提示 “Not logged in, please run /login”原因认证类型选择了ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN。解决方案回到 CC-Switch编辑 DeepSeek Provider 的配置将认证类型改为ANTHROPIC_AUTH_TOKEN保存后重新启用。❓ Q2提示 400 错误 / Bad Request可能原因 1模型名称填错了。检查是否正确填写了deepseek-v4-pro[1m]注意中括号和 1m。可能原因 2API 格式选择有误确保选择的是Anthropic兼容格式而不是OpenAI chat completions。可能原因 3Base URL 末尾多了或少了斜杠正确格式为https://api.deepseek.com/anthropic结尾无斜杠。❓ Q3模型名称不显示 1M 上下文原因模型名称没有加[1m]后缀。解决方案在 CC-Switch 中将所有需要长上下文的模型字段Opus、Sonnet、主模型都改为deepseek-v4-pro[1m]保存并重新启用。❓ Q4Windows 下 CC-Switch 安装失败提示缺少 WebView2解决方案参考第5步先安装 Microsoft Edge WebView2 Runtime然后重新安装 CC-Switch。❓ Q5npm install 报错提示网络超时解决方案Windows尝试切换 npm 镜像源到国内镜像npmconfigsetregistry https://registry.npmmirror.comnpminstall-ganthropic-ai/claude-code解决方案Mac/Linux同上或者使用代理工具后再安装。❓ Q6健康检查失败提示余额不足解决方案登录 https://platform.deepseek.com/ 充值账户余额。DeepSeek V4-Pro 的价格非常实惠10元可以使用很长时间。❓ Q7响应速度慢感觉在等待原因DeepSeek-V4-Pro 使用了思维链推理复杂任务确实需要思考时间这是正常现象。解决方案确保API_TIMEOUT_MS设置为足够大的值如3000000防止超时中断。9. 手动配置备用方案可选如果 CC-Switch 图形界面遇到问题也可以直接手动配置环境变量效果完全一样。Mac / Linux 用户终端将以下内容添加到你的 Shell 配置文件~/.zshrc或~/.bashrcexportANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexportANTHROPIC_AUTH_TOKEN你的DeepSeek_API_KeyexportANTHROPIC_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]exportANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flashexportCLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flashexportCLAUDE_CODE_EFFORT_LEVELmaxexportCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1exportAPI_TIMEOUT_MS3000000保存后执行source ~/.zshrc或重启终端然后运行claude即可。Windows 用户PowerShell在 PowerShell 中执行每次重启终端需要重新执行建议加入 PowerShell Profile$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKEN你的DeepSeek_API_Key$env:ANTHROPIC_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m]$env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash$env:CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash$env:CLAUDE_CODE_EFFORT_LEVELmax$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1$env:API_TIMEOUT_MS3000000直接写入 Claude Code 配置文件也可以直接编辑~/.claude/settings.json在env字段中添加{env:{ANTHROPIC_AUTH_TOKEN:你的DeepSeek_API_Key,ANTHROPIC_BASE_URL:https://api.deepseek.com/anthropic,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,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC:1,API_TIMEOUT_MS:3000000},hasCompletedOnboarding:true}保存后直接运行claude即可生效无需重启终端。✅ 配置完成检查清单完成教程后逐一确认以下项目DeepSeek API Key 已申请并保存Node.js 已安装node -v能显示版本号Claude Code 已安装claude --version能显示版本号CC-Switch 已安装并能正常打开CC-Switch 中已添加 DeepSeek ProviderBase URL 和 API Key 填写正确模型名称填写的是deepseek-v4-pro[1m]包含[1m]认证类型选择的是ANTHROPIC_AUTH_TOKEN健康检查通过绿色状态运行claude后/status显示 Model 为deepseek-v4-pro[1m]全部打勾代表你已经成功配置好 Claude Code DeepSeek-V4-Pro可以开始享受低成本的顶级 AI 编程体验了 参考资源DeepSeek 官方接入文档https://api-docs.deepseek.com/guides/coding_agentsCC-Switch 开源项目https://github.com/farion1231/cc-switchDeepSeek API Key 申请https://platform.deepseek.com/api_keysClaude Code 官方文档https://docs.anthropic.com/en/docs/claude-code
