尧图网页设计 
05 · 接入第三方 / 国产模型用 DeepSeek 等国产 / 第三方模型驱动 Claude Code把账单砍下来系列导航上一篇 04 · API 配置 讲了怎么用官方 API Key 接通 Claude Code。这一篇换个思路——把后面那个「大脑」整个换掉用 DeepSeek 之类的国产模型来省钱。⚠️本篇开头先打个预防针用第三方模型驱动 Claude Code 属于「实验性玩法」。官方文档只正式覆盖到「LLM 网关」和 Bedrock / Vertex 这类托管 Claude并没有背书任何非 Anthropic 模型。本文凡是官方明确写到的环境变量含义、默认行为我都标了来源DeepSeek 那部分以社区方案加实测为主接口地址、模型名随时可能变以 DeepSeek 官方为准。兄弟们先说一句可能挨骂的话大多数人根本不需要折腾第三方模型。网上一堆教程把「Claude Code 接 DeepSeek」吹成省钱神器搞得好像不接就是冤大头。但说句实话——如果你已经买了 Claude 的订阅Pro / Max或者一个月 API 花销也就几十块你折腾半天省下的那点钱还不够你 debug 环境变量的工夫。那这篇为什么还要写因为有两种人是真用得上一种是 API 余额烧得肉疼的重度用户每天几千万 token 进出换个便宜十倍的模型一个月省几百上千另一种是连不上官方、又不想搞魔法上网的国内用户DeepSeek 这种国内直连的接口反而最省心。是这两种人——往下看。不是的话扫一眼原理就够了别急着动手换。看完这一篇你会拿到一张「官方 API vs 第三方模型」的取舍对照表先想清楚该不该换一套照着抄就能跑的 DeepSeek 接入配置Mac / Windows 分别给搞懂 4 个关键环境变量到底在干嘛换任何第三方模型都通用几个常见的坑弃用变量、/status验证、什么时候别用01 先搞懂换模型到底换了什么先说结论Claude Code 是「壳」模型是「大脑」第三方接入做的事就是把大脑换成别人家的。你装的 Claude Code本质是一个跑在终端里的客户端——它负责读你的代码、调工具、管上下文、跑那个「想 → 做 → 看」的代理循环。但它自己不会思考每一步都要把请求发给某个大模型等模型回话。默认这个模型是 Anthropic 的 Claude。类比换发动机的车。Claude Code 是车壳——方向盘、座椅、仪表盘都不变你的操作习惯一点不用改。模型就是发动机。原厂发动机Claude动力最猛但油费贵你想省钱可以拆下来塞一台国产发动机DeepSeek。车还是那辆车开起来手感差不多就是动力和油耗变了。那「换发动机」具体怎么换靠的不是改代码而是几个环境变量。其中最核心的一个叫ANTHROPIC_BASE_URL——它决定 Claude Code 把请求发到哪个地址。这里有个官方文档里特别强调、但九成教程都没讲清的点ANTHROPIC_BASE_URL改变请求发送的位置而不是哪个模型回答它们。官方《模型配置》原文啥意思ANTHROPIC_BASE_URL只是改了「往哪寄信」不负责「谁来回信」。你把地址改成 DeepSeek 的接口DeepSeek 那边愿不愿意收、用哪个模型回是接口地址 模型名两个一起决定的。所以光改 URL 不够模型名也得跟着配——这是后面踩坑的高发区先记住。那为什么 DeepSeek 能直接接因为DeepSeek 提供了一个「兼容 Anthropic 协议」的接口——地址是https://api.deepseek.com/anthropic。说白了就是 DeepSeek 把自己伪装成 Anthropic 的样子让 Claude Code 以为还在跟官方说话实际背后是 DeepSeek 在算。Claude Code 一行源码都不用改。一句话总结换模型 改几个环境变量把「发动机」换掉车壳Claude Code不动ANTHROPIC_BASE_URL管「寄到哪」模型名管「谁来答」两个都得配对。02 该不该换先看这张表动手之前先冷静五分钟。第三方模型不是免费午餐它省了钱但也会丢一些东西。拿一个真实项目对比了两周同一套代码、同样的活儿前一周用官方 Sonnet后一周换 DeepSeek。下面这张表是实际用下来最真实的感受不是参数表抄的。维度官方 ClaudeAnthropic API第三方 / 国产模型如 DeepSeek价格贵Opus 尤其烧钱✅ 便宜常便宜一个数量级国内直连多数要魔法上网✅ DeepSeek 等国内直连零门槛代码能力✅ 目前第一梯队复杂重构稳够用复杂任务偶尔翻车工具调用 / Agent 能力✅ 原生最稳多步任务不掉链子⚠️ 看模型兼容接口偶有边缘行为配置成本填个 Key 就行要配一组环境变量易踩坑官方支持✅ 一等公民❌ 实验性出问题没人兜底看明白没便宜和国内直连是第三方的两张王牌代价是代码上限、Agent稳定性和「没人兜底」。这两周对比下来的真实结论日常的增删改查、写测试、补文档、解释代码DeepSeek 完全够用体感跟 Sonnet 差别不大但花的钱零头都不到。可一旦遇到那种「读懂五六个文件的调用关系、跨模块大重构」的活儿DeepSeek 有两次漏掉了关键依赖Claude 同样的 prompt 一次就对。所以更实用的用法是混着来糙活给便宜模型、硬活切回 Claude——具体怎么分层第 05 节给一套可直接抄的配置。一句话判断该不该换✅该换API 账单一个月几百上千的重度用户连官方费劲、不想搞魔法上网的国内用户只想练手、不在乎那点模型差距的人。❌别折腾已经买了 Claude 订阅的订阅是固定费用换 API 反而另外花钱下一篇 06 细讲主力干复杂架构、疑难调试的省那点钱不值得拿结果质量换。一句话总结第三方模型用「省钱 国内直连」换「代码上限 兜底」重度用户和国内直连党该换订阅党和硬核重构党别凑热闹。03 动手把 DeepSeek 接进 Claude Code好假设你确认要换了。这节给一套照着抄就能跑的配置。下面用 DeepSeek 举例国内最省心。接其他第三方模型Kimi、智谱、各种聚合中转站……套路完全一样只是ANTHROPIC_BASE_URL和模型名换成对应平台的——这俩以各自官方文档为准。前置拿到一把 DeepSeek API Key前提是你已经装好了 Claude Code没装的回去看 02 · 安装与使用。然后打开 DeepSeek 开放平台注册 / 登录创建一个 API Key复制出来存好形如sk-xxxxxxxx API Key 等于你账户的钱包钥匙。别提交到 Git 仓库、别发群里、别写进代码。下面我们用环境变量管它天然不进代码。第一步配环境变量环境变量就是「写给系统看的一组开关和地址」Claude Code 启动时会去读它们决定往哪发、用什么模型。类比填快递单。ANTHROPIC_BASE_URL是收件地址ANTHROPIC_AUTH_TOKEN是你的身份证验明正身才给寄后面那串ANTHROPIC_*_MODEL是「指定用哪个快递员送」。单子填对包裹你的请求才能到正确的地方、被正确的人处理。Mac / Linux打开终端逐行执行把你的 DeepSeek API Key换成真的 Keyexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexport ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Keyexport ANTHROPIC_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-chatWindowsPowerShell$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key$env:ANTHROPIC_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-chat⚠️关于模型名上面写的deepseek-chat是示例占位。DeepSeek 的具体模型名以及对应哪个能力档位以 DeepSeek 官方文档 为准平台升级时名字会变别照着写死。模型名是「填给快递单的快递员编号」填错了系统不认启动就会报错。一个请求从 Claude Code 经环境变量改写后寄到 DeepSeek 又原路返回的时序图上图想表达的整条链路你的指令 → Claude Code 打包成请求 →BASE_URL把收件地址改成 DeepSeek →AUTH_TOKEN验明身份 → DeepSeek 模型计算 → 结果原路返回终端。中间 Claude Code 这个「壳」全程没变。第二步让配置永久生效可选但强烈建议上面的export/$env:只在当前这个终端窗口有效关掉窗口就没了——这是新手第一个大坑「我明明配过了怎么重开终端又不行了」要永久生效Maczsh默认把那几行export追加到span/.zshrc末尾再执行source/span/.zshrcLinuxbash追加到span/.bashrc末尾执行source/span/.bashrcWindows在「系统属性 → 环境变量」里加用户变量或写进 PowerShell 的$PROFILE一句话总结接 DeepSeek 拿 Key 配一组环境变量地址 身份证 模型名临时 export 关窗即失效要长期用就写进~/.zshrc。04 验证到底接没接上配完别急着用先验证。要是没验证就开干很可能写了半天才发现请求其实还在走官方、根本没切过去——白白浪费时间。验证就一个命令。进任意项目目录启动 Claude Code输入/statuscd /path/to/your-projectclaude进去之后在对话框敲/status如果接上了你会在输出里看到类似这样的几行关注 Base URL 和模型Base URL: https://api.deepseek.com/anthropicModel:deepseek-chat看到 Base URL 变成了 DeepSeek 的地址就说明「发动机」真的换上了。/status同时会显示你的账户信息和当前模型是排查这类问题最快的手段——官方文档也专门点名用它「验证你的代理和网关配置是否正确应用」。如果显示的还是官方地址、或者直接报错逐项排查这几个高频原因现象大概率原因怎么修Base URL 还是官方的环境变量没生效可能开了新终端重新 source或确认写进了配置文件启动就报模型不存在模型名写错 / 平台改名了去 DeepSeek 官方文档查最新模型名401 / 鉴权失败API Key 错了或过期重新生成 Key检查有没有多复制空格提示要登录 claude.ai客户端还想走官方登录见下方说明最后那条单独说一句有些第三方接入场景下Claude Code 启动还会弹官方登录提示。常见的办法是改~/.claude.json加一行hasCompletedOnboarding: true跳过引导。这属于实验性绕过、不是官方文档记录的标准做法新版本行为可能变——能不动就不动真卡住了再试。一句话总结/status看一眼 Base URL 变没变就知道接没接上接不上别瞎猜照着排查表一项项过。05 进阶分层用模型省钱还不掉链子这节是最值钱的一招也是第 02 节说的「混着用」的具体落地。还记得第 01 节那堆ANTHROPIC_*_MODEL变量吗它们不是随便重复填的——Claude Code 内部把任务分了三个档位你可以给每个档位指派不同的模型。变量官方含义适合放什么活ANTHROPIC_DEFAULT_OPUS_MODELopus 别名解析到的模型最复杂架构设计、疑难调试ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名解析到的模型日常写功能、改代码ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名 / 后台功能如自动 title 等的模型轻量快速问答、后台杂活CLAUDE_CODE_SUBAGENT_MODEL所有子代理 / agent team 用的模型子任务建议给便宜快的以上含义全部来自官方《模型配置》文档。这套机制不是 DeepSeek 专属是 Claude Code 原生的——接第三方时你只是把这几个别名都指向第三方模型而已。类比餐厅排班。大厨最强模型工资高只让他做招牌硬菜家常小炒交给普通厨师中档模型端茶倒水洗菜这种后台杂活、子任务派学徒便宜快模型就行。全店都用大厨菜是好吃但你工资发不起。所以真正会玩的配法不是「全部填一个模型」而是分层——假设某平台同时有「强推理款」和「快而便宜款」两个模型# 复杂任务用强的export ANTHROPIC_DEFAULT_OPUS_MODEL强推理款模型名export ANTHROPIC_DEFAULT_SONNET_MODEL强推理款模型名# 轻量任务和子代理用便宜快的省钱export ANTHROPIC_DEFAULT_HAIKU_MODEL快而便宜款模型名export CLAUDE_CODE_SUBAGENT_MODEL快而便宜款模型名这么配的好处你在 Claude Code 里用/model opus切到「重档」时跑强模型平时默认跑便宜的子代理这种高频后台调用自动走最便宜的——账单一下就下来了。还有一个控制「思考深度」的变量CLAUDE_CODE_EFFORT_LEVEL官方支持low/medium/high/xhigh/max/autoauto表示恢复模型默认档位具体哪些档可用取决于模型。想让模型多想一会儿、结果更稳可以调高想省 token、要快就调低。一种好用的搭法默认档位填便宜模型 effort 给medium跑日常遇到硬骨头再/model手动切重档 临时拉到high。这么搭一个月 API 账单大概砍到原来的三分之一日常体感几乎没差。一句话总结别把所有档位填一个模型——糙活给便宜的、硬活给强的、子代理走最便宜的分层之后省钱和质量能兼得。06 两个新手必踩的坑最后拎出两个新手普遍会栽的坑专门说一下。坑一抄了已经被官方弃用的变量名网上包括一些教程的「参考配置」表里你会看到一个变量ANTHROPIC_SMALL_FAST_MODEL用来指定那个「快速小模型」。这个变量官方已经标了「已弃用deprecated」正主是ANTHROPIC_DEFAULT_HAIKU_MODEL。很多人第一次配的时候照着旧教程抄了ANTHROPIC_SMALL_FAST_MODEL虽然当时还能跑但心里一直没底——翻一翻官方《环境变量》文档就会发现它已经被替代了。结论新配置一律用ANTHROPIC_DEFAULT_HAIKU_MODEL看到老教程里的ANTHROPIC_SMALL_FAST_MODEL直接换掉别留着。坑二分不清AUTH_TOKEN和API_KEY接第三方模型时鉴权用哪个变量这俩长得像行为完全不同——直接看官方说法变量官方行为接第三方该用谁ANTHROPIC_AUTH_TOKEN作为 Authorization 头发送值自动加 Bearer 前缀✅ 接 DeepSeek 等第三方用这个ANTHROPIC_API_KEY作为 X-Api-Key 头发送非交互模式-p下只要存在就强制用它走官方 Anthropic API 时用为啥第三方推荐ANTHROPIC_AUTH_TOKEN因为 DeepSeek 这类兼容接口走的是标准Authorization: Bearer key这套正好对上。这也是社区方案和实测里都用ANTHROPIC_AUTH_TOKEN的原因。还有个连带的小坑要心里有数官方文档明确写了当ANTHROPIC_BASE_URL指向「非第一方主机」也就是非官方地址时MCP工具搜索默认会被关闭。简单说就是——接了第三方之后某些依赖官方的高级特性可能行为不一样甚至用不了。这也呼应了第 02 节那句「实验性、没人兜底」。日常编程用不太到但你要是重度依赖 MCP心里得有这根弦。一句话总结鉴权认准ANTHROPIC_AUTH_TOKEN、小模型认准ANTHROPIC_DEFAULT_HAIKU_MODEL老教程里的弃用变量直接换掉接了第三方部分高级特性会缩水。07 小结这一篇就干了一件事把 Claude Code 的「大脑」从官方 Claude 换成更便宜的第三方模型。串一下要点代码语言javascriptAI代码解释重度用户 / 国内直连党才值得换订阅党别折腾你现在应该能独立把 DeepSeek或任何兼容 Anthropic 协议的第三方模型接进 Claude Code验证接通并按任务分层配置来压低账单。再强调一遍那句反共识的话这是省钱手段不是必修课。值不值得折腾取决于你是不是真的在为 API 账单肉疼——多数轻度用户老老实实用官方就挺好。 ClaudeCode-接入国产大模型
05 · 接入第三方 / 国产模型用 DeepSeek 等国产 / 第三方模型驱动 Claude Code把账单砍下来系列导航上一篇 04 · API 配置 讲了怎么用官方 API Key 接通 Claude Code。这一篇换个思路——把后面那个「大脑」整个换掉用 DeepSeek 之类的国产模型来省钱。⚠️本篇开头先打个预防针用第三方模型驱动 Claude Code 属于「实验性玩法」。官方文档只正式覆盖到「LLM 网关」和 Bedrock / Vertex 这类托管 Claude并没有背书任何非 Anthropic 模型。本文凡是官方明确写到的环境变量含义、默认行为我都标了来源DeepSeek 那部分以社区方案加实测为主接口地址、模型名随时可能变以 DeepSeek 官方为准。兄弟们先说一句可能挨骂的话大多数人根本不需要折腾第三方模型。网上一堆教程把「Claude Code 接 DeepSeek」吹成省钱神器搞得好像不接就是冤大头。但说句实话——如果你已经买了 Claude 的订阅Pro / Max或者一个月 API 花销也就几十块你折腾半天省下的那点钱还不够你 debug 环境变量的工夫。那这篇为什么还要写因为有两种人是真用得上一种是 API 余额烧得肉疼的重度用户每天几千万 token 进出换个便宜十倍的模型一个月省几百上千另一种是连不上官方、又不想搞魔法上网的国内用户DeepSeek 这种国内直连的接口反而最省心。是这两种人——往下看。不是的话扫一眼原理就够了别急着动手换。看完这一篇你会拿到一张「官方 API vs 第三方模型」的取舍对照表先想清楚该不该换一套照着抄就能跑的 DeepSeek 接入配置Mac / Windows 分别给搞懂 4 个关键环境变量到底在干嘛换任何第三方模型都通用几个常见的坑弃用变量、/status验证、什么时候别用01 先搞懂换模型到底换了什么先说结论Claude Code 是「壳」模型是「大脑」第三方接入做的事就是把大脑换成别人家的。你装的 Claude Code本质是一个跑在终端里的客户端——它负责读你的代码、调工具、管上下文、跑那个「想 → 做 → 看」的代理循环。但它自己不会思考每一步都要把请求发给某个大模型等模型回话。默认这个模型是 Anthropic 的 Claude。类比换发动机的车。Claude Code 是车壳——方向盘、座椅、仪表盘都不变你的操作习惯一点不用改。模型就是发动机。原厂发动机Claude动力最猛但油费贵你想省钱可以拆下来塞一台国产发动机DeepSeek。车还是那辆车开起来手感差不多就是动力和油耗变了。那「换发动机」具体怎么换靠的不是改代码而是几个环境变量。其中最核心的一个叫ANTHROPIC_BASE_URL——它决定 Claude Code 把请求发到哪个地址。这里有个官方文档里特别强调、但九成教程都没讲清的点ANTHROPIC_BASE_URL改变请求发送的位置而不是哪个模型回答它们。官方《模型配置》原文啥意思ANTHROPIC_BASE_URL只是改了「往哪寄信」不负责「谁来回信」。你把地址改成 DeepSeek 的接口DeepSeek 那边愿不愿意收、用哪个模型回是接口地址 模型名两个一起决定的。所以光改 URL 不够模型名也得跟着配——这是后面踩坑的高发区先记住。那为什么 DeepSeek 能直接接因为DeepSeek 提供了一个「兼容 Anthropic 协议」的接口——地址是https://api.deepseek.com/anthropic。说白了就是 DeepSeek 把自己伪装成 Anthropic 的样子让 Claude Code 以为还在跟官方说话实际背后是 DeepSeek 在算。Claude Code 一行源码都不用改。一句话总结换模型 改几个环境变量把「发动机」换掉车壳Claude Code不动ANTHROPIC_BASE_URL管「寄到哪」模型名管「谁来答」两个都得配对。02 该不该换先看这张表动手之前先冷静五分钟。第三方模型不是免费午餐它省了钱但也会丢一些东西。拿一个真实项目对比了两周同一套代码、同样的活儿前一周用官方 Sonnet后一周换 DeepSeek。下面这张表是实际用下来最真实的感受不是参数表抄的。维度官方 ClaudeAnthropic API第三方 / 国产模型如 DeepSeek价格贵Opus 尤其烧钱✅ 便宜常便宜一个数量级国内直连多数要魔法上网✅ DeepSeek 等国内直连零门槛代码能力✅ 目前第一梯队复杂重构稳够用复杂任务偶尔翻车工具调用 / Agent 能力✅ 原生最稳多步任务不掉链子⚠️ 看模型兼容接口偶有边缘行为配置成本填个 Key 就行要配一组环境变量易踩坑官方支持✅ 一等公民❌ 实验性出问题没人兜底看明白没便宜和国内直连是第三方的两张王牌代价是代码上限、Agent稳定性和「没人兜底」。这两周对比下来的真实结论日常的增删改查、写测试、补文档、解释代码DeepSeek 完全够用体感跟 Sonnet 差别不大但花的钱零头都不到。可一旦遇到那种「读懂五六个文件的调用关系、跨模块大重构」的活儿DeepSeek 有两次漏掉了关键依赖Claude 同样的 prompt 一次就对。所以更实用的用法是混着来糙活给便宜模型、硬活切回 Claude——具体怎么分层第 05 节给一套可直接抄的配置。一句话判断该不该换✅该换API 账单一个月几百上千的重度用户连官方费劲、不想搞魔法上网的国内用户只想练手、不在乎那点模型差距的人。❌别折腾已经买了 Claude 订阅的订阅是固定费用换 API 反而另外花钱下一篇 06 细讲主力干复杂架构、疑难调试的省那点钱不值得拿结果质量换。一句话总结第三方模型用「省钱 国内直连」换「代码上限 兜底」重度用户和国内直连党该换订阅党和硬核重构党别凑热闹。03 动手把 DeepSeek 接进 Claude Code好假设你确认要换了。这节给一套照着抄就能跑的配置。下面用 DeepSeek 举例国内最省心。接其他第三方模型Kimi、智谱、各种聚合中转站……套路完全一样只是ANTHROPIC_BASE_URL和模型名换成对应平台的——这俩以各自官方文档为准。前置拿到一把 DeepSeek API Key前提是你已经装好了 Claude Code没装的回去看 02 · 安装与使用。然后打开 DeepSeek 开放平台注册 / 登录创建一个 API Key复制出来存好形如sk-xxxxxxxx API Key 等于你账户的钱包钥匙。别提交到 Git 仓库、别发群里、别写进代码。下面我们用环境变量管它天然不进代码。第一步配环境变量环境变量就是「写给系统看的一组开关和地址」Claude Code 启动时会去读它们决定往哪发、用什么模型。类比填快递单。ANTHROPIC_BASE_URL是收件地址ANTHROPIC_AUTH_TOKEN是你的身份证验明正身才给寄后面那串ANTHROPIC_*_MODEL是「指定用哪个快递员送」。单子填对包裹你的请求才能到正确的地方、被正确的人处理。Mac / Linux打开终端逐行执行把你的 DeepSeek API Key换成真的 Keyexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropicexport ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Keyexport ANTHROPIC_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-chatexport ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-chatWindowsPowerShell$env:ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic$env:ANTHROPIC_AUTH_TOKEN你的 DeepSeek API Key$env:ANTHROPIC_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-chat$env:ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-chat⚠️关于模型名上面写的deepseek-chat是示例占位。DeepSeek 的具体模型名以及对应哪个能力档位以 DeepSeek 官方文档 为准平台升级时名字会变别照着写死。模型名是「填给快递单的快递员编号」填错了系统不认启动就会报错。一个请求从 Claude Code 经环境变量改写后寄到 DeepSeek 又原路返回的时序图上图想表达的整条链路你的指令 → Claude Code 打包成请求 →BASE_URL把收件地址改成 DeepSeek →AUTH_TOKEN验明身份 → DeepSeek 模型计算 → 结果原路返回终端。中间 Claude Code 这个「壳」全程没变。第二步让配置永久生效可选但强烈建议上面的export/$env:只在当前这个终端窗口有效关掉窗口就没了——这是新手第一个大坑「我明明配过了怎么重开终端又不行了」要永久生效Maczsh默认把那几行export追加到span/.zshrc末尾再执行source/span/.zshrcLinuxbash追加到span/.bashrc末尾执行source/span/.bashrcWindows在「系统属性 → 环境变量」里加用户变量或写进 PowerShell 的$PROFILE一句话总结接 DeepSeek 拿 Key 配一组环境变量地址 身份证 模型名临时 export 关窗即失效要长期用就写进~/.zshrc。04 验证到底接没接上配完别急着用先验证。要是没验证就开干很可能写了半天才发现请求其实还在走官方、根本没切过去——白白浪费时间。验证就一个命令。进任意项目目录启动 Claude Code输入/statuscd /path/to/your-projectclaude进去之后在对话框敲/status如果接上了你会在输出里看到类似这样的几行关注 Base URL 和模型Base URL: https://api.deepseek.com/anthropicModel:deepseek-chat看到 Base URL 变成了 DeepSeek 的地址就说明「发动机」真的换上了。/status同时会显示你的账户信息和当前模型是排查这类问题最快的手段——官方文档也专门点名用它「验证你的代理和网关配置是否正确应用」。如果显示的还是官方地址、或者直接报错逐项排查这几个高频原因现象大概率原因怎么修Base URL 还是官方的环境变量没生效可能开了新终端重新 source或确认写进了配置文件启动就报模型不存在模型名写错 / 平台改名了去 DeepSeek 官方文档查最新模型名401 / 鉴权失败API Key 错了或过期重新生成 Key检查有没有多复制空格提示要登录 claude.ai客户端还想走官方登录见下方说明最后那条单独说一句有些第三方接入场景下Claude Code 启动还会弹官方登录提示。常见的办法是改~/.claude.json加一行hasCompletedOnboarding: true跳过引导。这属于实验性绕过、不是官方文档记录的标准做法新版本行为可能变——能不动就不动真卡住了再试。一句话总结/status看一眼 Base URL 变没变就知道接没接上接不上别瞎猜照着排查表一项项过。05 进阶分层用模型省钱还不掉链子这节是最值钱的一招也是第 02 节说的「混着用」的具体落地。还记得第 01 节那堆ANTHROPIC_*_MODEL变量吗它们不是随便重复填的——Claude Code 内部把任务分了三个档位你可以给每个档位指派不同的模型。变量官方含义适合放什么活ANTHROPIC_DEFAULT_OPUS_MODELopus 别名解析到的模型最复杂架构设计、疑难调试ANTHROPIC_DEFAULT_SONNET_MODELsonnet 别名解析到的模型日常写功能、改代码ANTHROPIC_DEFAULT_HAIKU_MODELhaiku 别名 / 后台功能如自动 title 等的模型轻量快速问答、后台杂活CLAUDE_CODE_SUBAGENT_MODEL所有子代理 / agent team 用的模型子任务建议给便宜快的以上含义全部来自官方《模型配置》文档。这套机制不是 DeepSeek 专属是 Claude Code 原生的——接第三方时你只是把这几个别名都指向第三方模型而已。类比餐厅排班。大厨最强模型工资高只让他做招牌硬菜家常小炒交给普通厨师中档模型端茶倒水洗菜这种后台杂活、子任务派学徒便宜快模型就行。全店都用大厨菜是好吃但你工资发不起。所以真正会玩的配法不是「全部填一个模型」而是分层——假设某平台同时有「强推理款」和「快而便宜款」两个模型# 复杂任务用强的export ANTHROPIC_DEFAULT_OPUS_MODEL强推理款模型名export ANTHROPIC_DEFAULT_SONNET_MODEL强推理款模型名# 轻量任务和子代理用便宜快的省钱export ANTHROPIC_DEFAULT_HAIKU_MODEL快而便宜款模型名export CLAUDE_CODE_SUBAGENT_MODEL快而便宜款模型名这么配的好处你在 Claude Code 里用/model opus切到「重档」时跑强模型平时默认跑便宜的子代理这种高频后台调用自动走最便宜的——账单一下就下来了。还有一个控制「思考深度」的变量CLAUDE_CODE_EFFORT_LEVEL官方支持low/medium/high/xhigh/max/autoauto表示恢复模型默认档位具体哪些档可用取决于模型。想让模型多想一会儿、结果更稳可以调高想省 token、要快就调低。一种好用的搭法默认档位填便宜模型 effort 给medium跑日常遇到硬骨头再/model手动切重档 临时拉到high。这么搭一个月 API 账单大概砍到原来的三分之一日常体感几乎没差。一句话总结别把所有档位填一个模型——糙活给便宜的、硬活给强的、子代理走最便宜的分层之后省钱和质量能兼得。06 两个新手必踩的坑最后拎出两个新手普遍会栽的坑专门说一下。坑一抄了已经被官方弃用的变量名网上包括一些教程的「参考配置」表里你会看到一个变量ANTHROPIC_SMALL_FAST_MODEL用来指定那个「快速小模型」。这个变量官方已经标了「已弃用deprecated」正主是ANTHROPIC_DEFAULT_HAIKU_MODEL。很多人第一次配的时候照着旧教程抄了ANTHROPIC_SMALL_FAST_MODEL虽然当时还能跑但心里一直没底——翻一翻官方《环境变量》文档就会发现它已经被替代了。结论新配置一律用ANTHROPIC_DEFAULT_HAIKU_MODEL看到老教程里的ANTHROPIC_SMALL_FAST_MODEL直接换掉别留着。坑二分不清AUTH_TOKEN和API_KEY接第三方模型时鉴权用哪个变量这俩长得像行为完全不同——直接看官方说法变量官方行为接第三方该用谁ANTHROPIC_AUTH_TOKEN作为 Authorization 头发送值自动加 Bearer 前缀✅ 接 DeepSeek 等第三方用这个ANTHROPIC_API_KEY作为 X-Api-Key 头发送非交互模式-p下只要存在就强制用它走官方 Anthropic API 时用为啥第三方推荐ANTHROPIC_AUTH_TOKEN因为 DeepSeek 这类兼容接口走的是标准Authorization: Bearer key这套正好对上。这也是社区方案和实测里都用ANTHROPIC_AUTH_TOKEN的原因。还有个连带的小坑要心里有数官方文档明确写了当ANTHROPIC_BASE_URL指向「非第一方主机」也就是非官方地址时MCP工具搜索默认会被关闭。简单说就是——接了第三方之后某些依赖官方的高级特性可能行为不一样甚至用不了。这也呼应了第 02 节那句「实验性、没人兜底」。日常编程用不太到但你要是重度依赖 MCP心里得有这根弦。一句话总结鉴权认准ANTHROPIC_AUTH_TOKEN、小模型认准ANTHROPIC_DEFAULT_HAIKU_MODEL老教程里的弃用变量直接换掉接了第三方部分高级特性会缩水。07 小结这一篇就干了一件事把 Claude Code 的「大脑」从官方 Claude 换成更便宜的第三方模型。串一下要点代码语言javascriptAI代码解释重度用户 / 国内直连党才值得换订阅党别折腾你现在应该能独立把 DeepSeek或任何兼容 Anthropic 协议的第三方模型接进 Claude Code验证接通并按任务分层配置来压低账单。再强调一遍那句反共识的话这是省钱手段不是必修课。值不值得折腾取决于你是不是真的在为 API 账单肉疼——多数轻度用户老老实实用官方就挺好。