1. 为什么要在 Claude Code 里换成 DeepSeek V4 ProClaude Code 在终端里的交互体验确实顺滑补全、重构、跑测试一条龙但官方原生 API 的账单看久了会让人下意识地少按几次回车。我身边不少做后端的朋友都是这个状态工具是真香成本是真疼。于是把底层模型换成 DeepSeek V4 Pro 就成了一个很自然的选择——它在代码生成和逻辑推理上的表现足够撑起日常开发价格又友好到可以放心让它反复读大文件、跑长上下文。这篇要解决的就是一个具体问题Claude Code 怎么通过 cc-switch 和 settings.json 两种方式接入 DeepSeek V4 Pro并且确认调用真的生效。适合两类人一类是只想固定用一个高性价比模型、不想折腾的开发者直接改配置文件就行另一类是手里有好几个模型比如日常用 DeepSeek、偶尔切回别的需要频繁切换的那就用 cc-switch 管理。两条路我都会给出可复制的配置片段和逐条验证动作跟着做基本不会卡住。需要先说明一点Claude Code 读取的是 Anthropic 风格的接口协议所以我们要把请求地址指向兼容 Anthropic Messages 格式的端点而不是随便填一个 OpenAI 风格的地址。这是后面很多报错的根源先记住这句话。在开始之前你需要准备一个可用的 API Key。如果你还没有可以到 TaoToken 的官网注册并创建一个https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 登录后在控制台的 API Keys 页面生成即可。拿到 Key 之后先放一边下面两种配置方式都会用到它。2. 前置准备拿到 Key 并确认 Claude Code 已就绪在动配置文件之前先把两件事确认掉否则后面报错你会分不清是 Key 的问题还是环境的问题。第一件事是确认 Claude Code 本身能跑起来。打开终端输入claude --version如果能看到版本号输出说明 CLI 已经装好了。如果提示 command not found那需要先按官方文档把 Claude Code 装上这一步和模型切换无关先解决掉。装好之后先别急着配 DeepSeek用默认配置随便问一句确认基础链路是通的这样后面出问题就能定位到是「换模型」这一步引入的。第二件事是拿到 API Key 并确认额度。到 TaoToken 控制台创建 Key复制出来是一串以特定前缀开头的字符串。这里有个小坑复制的时候别把首尾空格带进去很多人粘贴到 JSON 里报 401最后发现是 Key 末尾多了个换行或空格。建议先粘到纯文本编辑器里看一眼。关于模型 ID 的写法DeepSeek V4 Pro 在 Anthropic 兼容端点下通常用deepseek-v4-pro这样的标识带长上下文能力的版本会带后缀。不同渠道的模型名可能略有差异以你所用平台文档里给出的模型 ID 为准下面配置里的模型名如果和你平台的不一致直接替换成正确的即可。这一点很关键模型名写错会直接触发后面第 5 节讲的报错。准备工作做完我们进入正题。先讲最省事的单模型方案直接改 settings.json。3. 方案一直接改 settings.json 固定使用 DeepSeek V4 Pro如果你就打算长期用 DeepSeek V4 Pro 一个模型不折腾切换那改配置文件是最干净的方案没有额外进程启动即生效。3.1 定位 settings.json 文件位置Claude Code 的用户级配置放在用户目录下的.claude文件夹里。各系统的路径如下系统配置文件路径WindowsC:\Users\你的用户名\.claude\settings.jsonmacOS/Users/你的用户名/.claude/settings.jsonLinux/home/你的用户名/.claude/settings.json如果.claude目录或settings.json文件不存在手动新建一个同名文件即可Claude Code 启动时会去读它。注意是用户目录下的.claude不是项目目录里的别放错地方。3.2 写入可复制的配置片段用任意文本编辑器打开settings.json填入下面这段。把sk-你的Key换成你真实的那串{ env: { ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro, ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro, ANTHROPIC_MODEL: deepseek-v4-pro, ANTHROPIC_REASONING_MODEL: deepseek-v4-pro } }这里逐项解释一下方便你按需调整ANTHROPIC_AUTH_TOKEN就是你的 API KeyClaude Code 会把它作为鉴权头带出去。ANTHROPIC_BASE_URL是请求的根地址指向兼容 Anthropic 协议的端点注意这里不要在末尾多加/v1之类的路径具体以平台文档为准。后面几个*_MODEL是 Claude Code 内部按「档位」去请求模型时用的映射Haiku 档对应轻量快速模型Sonnet 和 Opus 档对应主力模型ANTHROPIC_MODEL是默认模型ANTHROPIC_REASONING_MODEL是开启思考时用的模型。把它们都指向 DeepSeek V4 Pro就能保证不管 Claude Code 内部按哪个档位发请求最终都落到同一个模型上。注意JSON 不支持注释也别用中文引号必须是英文半角。写完可以用在线 JSON 校验工具过一遍或者用python -m json.tool settings.json检查语法。3.3 保存并验证生效保存文件后完全退出当前终端再重新打开然后进入你的项目目录启动cd your-project claude启动后随便问一句比如「用 Python 写一个快速排序」。如果正常返回代码说明配置已经生效。想更确定一点可以在对话里输入/status或查看当前模型信息确认底层走的是你配置的模型而不是默认的。这种方式的优点是零依赖、启动快缺点是每次换模型都要手动改文件、重启终端。如果你只有一个模型这就够了。如果你需要在多个模型之间来回切往下看 cc-switch。4. 方案二用 cc-switch 管理多模型并一键切换cc-switch 是一个专门给 Claude Code 做多供应商切换的小工具图形界面点几下就能换模型不用每次手改 JSON。它的原理其实就是帮你改写settings.json但把切换这件事变得可视化了。4.1 安装 cc-switch到 cc-switch 的 GitHub Releases 页面下载对应系统的安装包Windows 选.msimacOS 选.dmg。双击安装一路下一步即可。安装完成后启动主界面会列出你已有的供应商节点。4.2 添加 DeepSeek V4 Pro 供应商节点点击界面上的「添加供应商」按钮会弹出一个配置表单。对照下表填写配置项内容/值供应商名称DeepSeek V4 Pro名字随意能认出即可API Key你的 API Key请求地址https://taotoken.net/apiAPI 格式Anthropic Messages原生认证字段ANTHROPIC_AUTH_TOKEN默认主模型deepseek-v4-pro推理模型Thinkingdeepseek-v4-proHaiku 默认模型deepseek-v4-flashSonnet 默认模型deepseek-v4-proOpus 默认模型deepseek-v4-pro写入通用配置勾选高强度思考按需勾选这里的三件套要记牢Base URL、Key、Model ID缺一不可而且三者必须匹配。Base URL 填错会连不上Key 填错会 401Model ID 填错会报模型不存在。填完之后cc-switch 会把这些写进settings.json的env字段和你手动改的效果是一样的。4.3 联通性测试与启用信息填完先别急着用点该节点旁边的「测试」按钮。cc-switch 会发一个探测请求过去如果弹出成功提示说明网络连通和鉴权都没问题。测试通过后点右侧的「启用」界面提示运行正常配置就即时生效了。启用之后cc-switch 会接管settings.json的写入。也就是说用了 cc-switch 之后就不要再手动去改那个文件了否则下次切换会被覆盖容易产生「我明明改了怎么没生效」的困惑。4.4 启动并确认切换成功打开终端进入项目目录输入claude启动。此时底层模型已经换成 DeepSeek V4 Pro。发一句测试文本比如「你是哪个模型」看返回内容是否符合预期。如果之前已经开着 Claude Code 会话切换后需要按下一节的方法处理模型不匹配的问题。5. 常见报错逐条排查401、模型不匹配与配置不生效配置过程中最容易卡在几个固定报错上这一节按真实报错逐条给排查路径。5.1 401 Unauthorized / authentication failed这是最常见的。报错大意是鉴权失败请求被拒。排查顺序先看 Key 本身。把ANTHROPIC_AUTH_TOKEN的值复制出来检查首尾有没有空格、换行有没有把sk-前缀漏掉。很多人是从网页复制时多带了一个换行符肉眼看不出来粘到 JSON 里就废了。再看认证字段名。Claude Code 认的是ANTHROPIC_AUTH_TOKEN如果你写成了ANTHROPIC_API_KEY有些端点不认就会 401。cc-switch 里默认就是ANTHROPIC_AUTH_TOKEN手动改 JSON 时别写错。最后确认 Key 有没有过期或被禁用。到控制台看一眼 Key 的状态和额度额度耗尽也会返回鉴权类错误。5.2 Model mismatch / 模型不匹配报错现象是你之前已经开着 Claude Code 会话中途用 cc-switch 切了模型继续输入指令时抛出模型不匹配的红字报错。原因是当前运行的会话进程还记着旧模型名比如之前配的别的模型而新端点不认这个模型名。解决办法是在当前对话框里直接输入内置指令/model然后用上下方向键选中你刚配好的 DeepSeek 模型回车确认。再发一句测试文本比如「你是」只要正常输出就说明这个已经打开的窗口也切过来了。记住切换模型后已经开着的会话需要手动/model一次新开的会话自动生效。5.3 local proxy failed / 连接被拒报错里出现local proxy failed或连接超时通常是 Base URL 写错或网络不通。检查ANTHROPIC_BASE_URL是不是写成了带多余路径的地址比如多加了/v1/messages。根地址应该只到域名和必要前缀具体路径由 Claude Code 自己拼。另外确认本机网络能正常访问该地址可以用 curl 简单探一下curl -I https://taotoken.net/api能返回 HTTP 状态码就说明网络层通问题在配置连不上就是网络环境问题。5.4 reading choices / 响应解析失败报错里出现reading choices或解析响应失败多半是协议格式不匹配。choices是 OpenAI 风格响应里的字段而 Claude Code 期望的是 Anthropic 风格的响应结构。这说明你填的端点返回的是 OpenAI 格式但 Claude Code 按 Anthropic 格式去解析自然读不到。解决方法是确认 API 格式选的是「Anthropic Messages原生」Base URL 指向兼容 Anthropic 协议的端点而不是 OpenAI 兼容端点。5.5 配置改了但不生效如果改完settings.json重启后还是走旧模型检查三件事一是文件路径对不对是不是改到了项目目录而不是用户目录二是 JSON 语法有没有错用python -m json.tool验一下三是如果装了 cc-switch是不是被它覆盖了。用 cc-switch 的话所有改动都通过它的界面来做。6. 把 DeepSeek V4 Pro 稳定用起来的几个实操建议配置跑通只是第一步日常用起来还有几个细节值得注意。关于模型档位映射前面配置里我把 Haiku 档指向了deepseek-v4-flash主力档指向deepseek-v4-pro。这样做的原因是 Claude Code 在处理一些轻量任务比如简单的文件摘要时会走 Haiku 档用更便宜的模型能进一步压成本而真正需要推理和写代码时走 Pro 档。如果你不在乎这点差异全指向 Pro 也没问题只是成本略高。关于会话与切换的配合养成一个习惯切换模型后要么新开终端要么在当前会话里/model一次。这样能避免大部分模型不匹配的报错。cc-switch 的测试按钮建议每次切换后都点一下确认链路是通的再干活。关于配置备份settings.json里存着你的 Key别把它提交到 Git 仓库。如果你有多个项目、多台机器可以把配置片段单独存一份换机器时直接粘贴省得重新填表。如果你后面想把这套配置用到更长期的编码工作流里比如让 Agent 持续跑任务、批量处理代码可以了解一下 Coding Plan 这类方案把额度和调用方式规划好避免临时额度不够打断工作https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。需要管理多个 Key 或查看用量时控制台在这里https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 创建和管理 Key 的页面在https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。配置过程中如果对某个参数拿不准接入文档里有更细的字段说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。最后说个我踩过的坑有次 Key 明明是对的但一直 401折腾半天发现是复制时把末尾的换行带进去了粘到 JSON 里字符串被截断。所以每次粘贴 Key 之后养成扫一眼首尾字符的习惯能省下不少排查时间。配置这东西一次弄对后面就是纯享受了。