前阵子有朋友问我手头没有 Anthropic 官方的 Claude 订阅但特别想试试 Claude Code 这个命令行编程助手有没有办法让它跑在国产大模型上我一开始以为他只是想省钱后来才发现他需要的是更现实的方案——既想体验 Claude Code 的终端交互和自动化改代码能力又不想在账号、订阅、模型选择这些环节上被卡住。其实这条路完全走得通而且现在国产模型在代码能力上已经相当能打了。这篇东西就是给纯小白准备的我会从原理讲起再一步步带你把 Node.js 环境、Claude Code 本体和国产大模型接起来。整个过程不需要你有多少编程基础只要会复制粘贴命令、看懂报错信息就能跟着走完。文章里所有配置我都实测过也会把坑一个个提前说出来。1. 先别急着装Claude Code 接国产大模型的原理是怎么一回事很多教程上来就让你敲命令但没讲清楚原理结果配到一半报错就抓瞎。我建议先花三分钟搞明白 Claude Code 的构成后面所有配置逻辑就顺了。1.1 Claude Code 是个“编辑器头”不是模型本身Claude Code 本质上是 Anthropic 推出的命令行编程助手它跑在你的终端里让你用自然语言让 AI 读取项目、改代码、跑命令、提交 Git。你可以把它理解成一个“聪明的壳子”真正干活的模型在背后。这个“壳子”和模型之间是通过 API 连接的。官方默认把模型指向 Anthropic 自家的 Claude 系列但既然是 API 连接理论上我只要把请求的目标地址换一下就能让它调用别的模型。这正是集成国产大模型的理论基础。我在给朋友演示时常用的比喻是Claude Code 就像一个支持“随心换卡”的手机官方给你装的是 Anthropic 的 SIM 卡而我们要做的事就是把 SIM 卡抽出来换上一张国产运营商的卡。手机本身的打电话、发消息功能不变但走的网络已经从官方变成国产模型服务商了。1.2 “API 兼容”才是整件事的钥匙换个“SIM 卡”不是随便换的关键看对方的接口长什么样。Anthropic 给 Claude Code 定义了一套 API 格式这套格式里包含了请求头、消息结构、模型名称等规定。理论上任何模型服务商只要把这套格式“仿照”出来Claude Code 就能无缝对接。这里有两类服务商可以选直接兼容 Anthropic API 格式的国产服务商比如 DeepSeek 官方就专门开放了一个 Anthropic 兼容端点这个最省事。本地模型运行工具比如 Ollama它本身不提供云端模型但能在你的电脑上跑开源模型并且暴露一个兼容层接口让 Claude Code 能调用本地模型。所以整个集成的核心就两件事把ANTHROPIC_BASE_URL指向国产模型的地址把ANTHROPIC_AUTH_TOKEN换成对应 API Key。后面所有配置都是围绕这两个环境变量展开的。2. 基础环境一次性收拾好Node.js、nvm 与 npm 源Claude Code 是 Node.js 应用官方安装方式是全局 npm 包。所以要跑起来第一关不是装 Claude Code 本身而是先有一个干净、可用的 Node.js 环境。这一步对老手来说很简单但对小白来说处处是坑我拆细一点讲。2.1 非装不可的 Node.js 18以及为什么Claude Code 要求 Node.js 版本在 18 以上。如果版本太低npm 安装时不会立刻报错但一运行claude命令就会蹦出一堆莫名其妙的错误比如语法不支持、内部模块找不到。我自己习惯的做法是安装最新的 LTS长期支持版比如 20.x 或 22.x。LTS 版本最稳社区反馈也多万一遇到问题更容易搜到解决方案。不建议追新装奇数版本或太激进的预览版否则可能遇到兼容性 bug排起来非常头疼。这里有个很容易忽略的地方装完 Node.js 之后在终端里执行node -v和npm -v验证一下看到版本号才说明装好了。有些同学装完直接开干结果发现命令找不到往往是因为安装时没有把node和npm加入系统 PATH或者安装完成后没有重新打开终端窗口。2.2 用 nvm 管理 Node 版本避免升级灾难如果只是装一个 Node.js最简单的是去官网下载安装包。但我强烈建议小白一开始就使用 nvmNode Version Manager也就是 Node 版本管理器。原因很简单你以后一定会遇到某个项目要求用 Node 16另一个要求用 Node 20这时候用 nvm 就能一键切换不用卸载重装。Windows 用户去搜nvm-windows下载安装包后安装然后终端里执行nvm install 20和nvm use 20。macOS 或 Linux 用户直接在终端执行安装脚本再同样执行nvm install 20和nvm use 20。使用 nvm 后在每个新终端窗口里检查node -v确认当前用的 Node 版本是你刚设置的那个。我碰到过不少案例安装完 nvm 后忘了nvm use导致实际跑的仍然是旧版本后面 Claude Code 时报错又查不出原因纯属自折腾。2.3 npm 换源别让安装卡在进度条上npm 是 Node.js 自带的包管理器Claude Code 就靠它安装。默认 npm 官方源在海外的下载速度真心不稳定尤其国内网络环境下经常卡在进度条上或者下载到一半直接超时失败。我在国内环境装包之前会先把 npm 源切到国内镜像比如淘宝镜像。命令如下npm config set registry https://registry.npmmirror.com设置完可以执行npm config get registry确认已经生效。这一步能让你后面安装 Claude Code 的速度提升一个量级基本几十秒就能装完。而且这个设置是持久化的以后装其他全局包也受益。这里补充一句换源只会影响 npm 下载包的仓库地址不会影响你本机的 Node.js 运行逻辑所以放心换不会弄坏环境。唯一需要注意的是如果你将来要发布自己的 npm 包记得换回官方源否则发布地址会不对但那是后话了。3. 安装 Claude Code 并跑通第一次对话环境收拾利索之后真正的安装就变得很简单了。我用最小步骤带你走一遍顺便把第一次登录时最容易困惑的选择题讲清楚。3.1 一行命令装好全局工具Claude Code 的安装命令是npm install -g anthropic-ai/claude-code这段命令里的-g表示全局安装意味着之后你在任何目录下都能直接使用claude命令。安装完成后执行claude --version如果能看到版本号说明核心程序已经装好了。如果你用的是 nvm 管理的 Node 环境有个细节要注意nvm 切换版本后全局包并不会自动跟随。比如你在 Node 20 下装了 Claude Code切到 Node 18 后突然找不到claude命令就是这个原因。解决方法是切到对应版本后重新执行一次安装命令或者把当前 Node 版本设置为默认版本。3.2 第一次登录有订阅账号和纯 API Key 是两条路线在终端里输入claude回车程序会开始初始化。这时你会看到需要登录的提示。这里有两条路线决定了你后面配置走多远路线一有 Anthropic 官方账号且开通了 Claude 订阅或 API 计费账号。走官方交互式登录浏览器里授权完就能直接用。这种体验最省心但和你“想用国产模型”的目标不太一致除非你想做官方模型和国产模型的对比测试。路线二没有官方订阅想直接用国产模型。这种情况下不需要在 Claude Code 的登录流程里走完只需要在启动claude前把环境变量指向国产模型服务商即可。Claude Code 发起请求时会读取环境变量里的 Base URL 和 Token如果发现指向的是第三方地址它会跳过官方登录直接用你提供的第三方配置。我第一次配置时就卡在这个位置以为是必须先登录才能用结果一直填邮箱、跳转浏览器、授权失败折腾半天。后来搞清楚只要环境变量设对了claude启动后直接进入对话界面完全不用管官方登录流程。3.3 在 VS Code 里把 Claude Code 用顺手Claude Code 本身是一个终端工具但很多人习惯在 VS Code 里写代码。这里我推荐的方式不是装什么第三方插件最稳的做法是直接用 VS Code 内置终端。打开 VS Code按快捷键Ctrl \macOS 是Control ~打开终端确保当前终端使用的 Node 版本正确然后输入claude 命令。这样 Claude Code 就在你编辑器的底下跑起来了它读取的是当前目录的项目文件你在对话里让它改代码它会直接操作项目目录里的文件非常贴合写代码的工作流。还有一个实用技巧在 VS Code 的终端里如果中途想和 Claude Code 说要换一个上下文或开始新对话可以使用命令/clear。如果想带着当前对话上下文继续在另一个会话里操作可以用claude -c启动这会尝试继续上次会话。4. 接国产模型的方案 A本地 Ollama免费且离线可用环境变量明白了原理清楚了现在可以正式接国产模型。第一种方案是在本地跑开源模型最常用的工具是 Ollama。这个方案的最大优点是免费、数据不出电脑缺点是模型能力受限于你电脑的性能。4.1 Ollama 的安装和模型下载去 Ollama 官网下载对应系统的安装包装完在终端验证ollama --version然后下载模型比如我常用的几个ollama pull deepseek-coder ollama pull qwen2.5-coder:7b这里的deepseek-coder和qwen2.5-coder都是适合编程的开源模型。下载大小通常几个 GB取决于模型参数规模所以要有耐心。下载完成后可以先用自带命令验证模型能正常对话ollama run deepseek-coder如果能正常回复说明模型已经被 Ollama 管理起来了。这一步不能省因为很多人配置完 Claude Code 发现连不上最后排查半天发现是 Ollama 服务根本没启动或者模型压根没下载成功。4.2 Claude Code 对接 Ollama 的配置写法Ollama 提供了一个兼容 Anthropic API 格式的接口地址是http://localhost:11434/anthropic我们要做的就是把 Claude Code 的请求指向这里。在启动claude命令前先设置几个环境变量。以 Windows PowerShell 为例$env:ANTHROPIC_BASE_URL http://localhost:11434/anthropic $env:ANTHROPIC_AUTH_TOKEN ollama $env:ANTHROPIC_MODEL deepseek-coder $env:ANTHROPIC_SMALL_FAST_MODEL deepseek-codermacOS 或 Linux 用户用 export 语法export ANTHROPIC_BASE_URLhttp://localhost:11434/anthropic export ANTHROPIC_AUTH_TOKENollama export ANTHROPIC_MODELdeepseek-coder export ANTHROPIC_SMALL_FAST_MODELdeepseek-coder然后输入claude启动。如果配置正确你会直接进入对话界面这时让 Claude Code 帮你写一个 Python 脚本试试它能正常响应就说明联通成功。这里的ANTHROPIC_AUTH_TOKEN设置为一个占位符ollama就可以因为 Ollama 本身不校验 Key但不能不填否则 Claude Code 会认为没有凭证直接拒绝请求。4.3 本地模型的体验边界能干活但不是全能本地模型方案并不是十全十美我在实际使用中总结了几条边界响应速度取决于硬件7B 级别的模型在普通笔记本上还能接受14B 以上就开始明显变慢。如果电脑没有 NVIDIA 独显建议乖乖用 7B 或更小的模型。上下文窗口有限本地模型通常不如云端模型能容纳那么多代码上下文。处理大型项目时可能会感到 Claude Code“记不住”之前的修改这时需要更主动地清理会话或分模块让它干活。代码能力有天花板DeepSeek-Coder 或 Qwen2.5-Coder 在常见编程任务上已经很能打但和顶级的云端闭源模型比还是有差距特别是在复杂架构设计、跨文件重构这类任务上。所以我的看法是本地 Ollama 方案最适合对数据隐私敏感、或不想为 AI 编程助手付费的开发者入门。作为尝鲜、日常脚本编写、小项目辅助完全够用。5. 接国产模型的方案 B云端 API 直连效果接近原版如果本地模型不能满足你的需求或者你电脑性能不够第二种方案是直接用云端国产大模型的 API。目前最省事也最推荐给小白的是 DeepSeek 官方提供的 Anthropic 兼容端点。这一节我详细讲配置方法再告诉你判断其他服务商能不能接入的方法。5.1 DeepSeek 官方兼容端点的配置DeepSeek 是国内比较早开放 Anthropic API 兼容格式的国产模型厂商这意味着 Claude Code 能直接用官方提供的方式对接不需要额外中转层。先去 DeepSeek 开放平台注册账号创建一个 API Key然后按下面的方式配置环境变量export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN这里填你的DeepSeek API Key export ANTHROPIC_MODELdeepseek-chat export ANTHROPIC_SMALL_FAST_MODELdeepseek-chat配置好后在终端里运行claude正常情况会直接绕过官方登录进入对话界面。这时让它读取你项目目录里的代码、写一个测试用例、或者解释一段陌生代码体验和官方版 Claude Code 几乎没有差别只是背后的模型换成了 DeepSeek。DeepSeek 史无前例地把 Anthropic 兼容端点做得足够原生连 Claude Code 会用到的Anthropic-API-Version请求头都能正确响应。所以配置过程中基本不会遇到兼容性报错对小白友好度相当高。5.2 其他国产模型服务的接入判断方法除了 DeepSeek市面上还有通义千问、Kimi、智谱等国产模型但它们的 API 格式并不都原生兼容 Anthropic。这时候不要慌可以先做一个判断登录对应模型服务商的开发者文档搜索“Anthropic”或“Claude Code”如果官方有提供 Anthropic 兼容端点直接照抄 DeepSeek 的配置模式只是换掉 Base URL、Token 和模型名即可。如果官方文档只提供 OpenAI 兼容格式那么通常不能直接接到 Claude Code 上。这时可以找一些网关工具做格式转换但这需要额外部署复杂度高不适合纯小白。在我测试过的模型服务里DeepSeek 是目前对接 Claude Code 最无痛的国产云端模型。这不是广告而是实际踩坑总结出来的结论——其他家我也试过有的需要额外加载 Json 格式转换有的对长上下文支持不稳定综合体验都差点意思。5.3 用 CC Switch 这类工具管理多套配置你可能会想今天想用 DeepSeek明天想切回官方 Claude后天又想试试本地 Ollama每次都在环境变量里改来改去太麻烦了。这个问题社区里早就有人做了工具叫做 CC Switch。CC Switch 是一个配置切换工具相当于给 Claude Code 装了一个“遥控器”你可以在图形界面里预先保存好几套环境变量配置比如“DeepSeek 云端”“Ollama 本地”“官方 Claude”之后点一下就能切换不用每次手敲 export 命令。这类工具的原理就是帮你临时改写当前 shell 的环境变量然后重新启动 Claude Code。如果你喜欢折腾也可以用脚本自己实现但小白我建议直接用现成工具省心。切换配置后记得要重新启动claude因为环境变量是在进程启动时读取的改完不重启不会生效。这是一个很多人忽略的细节。6. 排错实录三类最常见的故障与完整排查思路配置过程不会总是一帆风顺我在帮朋友配置时遇到最多的故障主要三类。这一节我不仅给答案更会把排查链路讲清楚下次你再遇到类似问题可以按这个思路自己定位。6.1 403 Forbidden先查 Base URL、Token 和模型名三者是否自洽如果启动claude后对话窗口刚发出一条消息就弹出一大段403 Forbidden错误不用慌这几乎可以断定是认证配置出了问题。先检查ANTHROPIC_BASE_URL是否写对少一个/anthropic、多一个/v1就会让请求打到错误路径上。再检查ANTHROPIC_AUTH_TOKEN是不是正确的 API Key有些服务商新建的 Key 要过几分钟才生效。最后检查ANTHROPIC_MODEL的模型名是否真实存在比如 DeepSeek 的模型名是deepseek-chat而不是deepseek-coder后者是本地模型的叫法。我总结过一个排查顺序先跑通服务商自己的测试接口用curl命令直接请求一次确认服务端正常再检查 Claude Code 环境变量最后看 Claude Code 实际请求的 URL 是什么。注意不要输出包含 API Key 的请求体到公网注意安全。如果 curl 直接访问服务商接口是通的但 Claude Code 报 403那大概率是环境变量没有被正确传到 Claude Code 进程里。检查一下是不是在同一个终端窗口里设置了环境变量然后又在另一个窗口运行了claude这是新手最容易犯的错误。6.2 “Your organization has disabled”这类账号限制怎么绕有些同学一开始先用官方账号登录过 Claude Code后来想切到国产模型结果每次启动都提示类似Your organization has disabled Claude subscription access for Claude Code的报错。出现这个提示的根本原因是 Claude Code 检测到了某个官方配置残留优先走了官方认证流程而该账号没有权限使用 Claude Code。解决办法不是去和官方客服申诉而是把你配置里的官方相关痕迹清干净删除用户目录下 Claude Code 存放的本地认证信息文件。一般是~/.claude这个隐藏目录Windows 在C:\Users\你的用户名\.claudemacOS/Linux 在~/.claude。找到和 auth、credentials、tokens 相关的文件后备份并删除。同时检查项目目录下有没有.claude文件夹如果有也一并处理。确保在启动claude前已经明确设置了ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN让进程知道该走哪个端点。处理完后再启动报错就会消失。这个坑的隐蔽性在于它和你的代码没有关系而是残留的本地状态在捣鬼。以后不要再拿这个被限制的账号走官方流程专心用国产模型配置即可。6.3 连接超时、模型答非所问环境与上下文的锅连接超时这个问题分成两种情况看。第一种情况是本地 Ollama 方案连接超时。先执行ollama ps或ollama list确认 Ollama 服务还活着、模型还在。如果 Ollama 服务没启动执行ollama serve启动后再试。如果 Ollama 正常但 Claude Code 还是超时检查一下你设的ANTHROPIC_BASE_URL是不是用了https而不是http本地服务通常是http://localhost:11434用https就会超时。第二种情况是云端 API 超时。检查 API Key 账户余额是否充足有些服务商欠费后不报 401 而是直接超时。如果余额正常尝试换一个更稳定的网络环境重试。至于“模型答非所问”或者“突然开始说英文”大多数时候是ANTHROPIC_MODEL设错了模型导致 Claude Code 心里想的是用一个模型实际请求的是另一个模型。比如你想用 DeepSeek Chat却在环境变量里写成了deepseek-coder就会出现奇怪的响应。另一个可能性是上下文填得太满模型被大量历史消息干扰用/clear清空后重开就好。7. 我的最终配置存档和几个使用习惯教程写到这里整个集成的关键路径已经走完了。最后我把目前自己机器上最常用的一套配置和几个使用习惯放出来你可以照着抄也可以在这个基础上按需调整。我的 Windows 机器上当前默认用的是 DeepSeek 云端方案配置长这样$env:ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKEN sk-你的DeepSeek Key $env:ANTHROPIC_MODEL deepseek-chat $env:ANTHROPIC_SMALL_FAST_MODEL deepseek-chat如果你想要一套既能用云端又能在本地来回切的方案建议把两套配置存成两个脚本文件比如use-deepseek.ps1和use-ollama.ps1每次要切换时直接执行对应脚本。熟练之后也可以只配置一套 Ollama 本地但遇到大任务时再切到云端灵活度最高。平时用 Claude Code 跑国产模型时有三个习惯对我的实际效率提升很明显。第一个是每次让 Claude Code 动手改代码前先在对话里明确告诉它项目背景和约束条件而不是直接扔一句“帮我优化一下”。第二个是做完一步就检查一步用/clear分隔不同子任务避免上下文纠缠。第三个是涉及到重要的重构操作会先让 Claude Code 输出改动计划再让它落地因为国产模型在一些极端情况下会“用力过猛”提前制定计划可以避免大范围误改。这也是我反复跟身边朋友强调的一点工具是放大器你的使用方式决定了它能放大多少倍。把 Claude Code 接到国产大模型只是第一步之后你如何使用它、如何给它设定边界才是真正影响你开发效率的关键。希望这篇教程能帮你顺利跑通第一段对话剩下的路就得靠你自己在项目里来回试了。
前阵子有朋友问我手头没有 Anthropic 官方的 Claude 订阅但特别想试试 Claude Code 这个命令行编程助手有没有办法让它跑在国产大模型上我一开始以为他只是想省钱后来才发现他需要的是更现实的方案——既想体验 Claude Code 的终端交互和自动化改代码能力又不想在账号、订阅、模型选择这些环节上被卡住。其实这条路完全走得通而且现在国产模型在代码能力上已经相当能打了。这篇东西就是给纯小白准备的我会从原理讲起再一步步带你把 Node.js 环境、Claude Code 本体和国产大模型接起来。整个过程不需要你有多少编程基础只要会复制粘贴命令、看懂报错信息就能跟着走完。文章里所有配置我都实测过也会把坑一个个提前说出来。1. 先别急着装Claude Code 接国产大模型的原理是怎么一回事很多教程上来就让你敲命令但没讲清楚原理结果配到一半报错就抓瞎。我建议先花三分钟搞明白 Claude Code 的构成后面所有配置逻辑就顺了。1.1 Claude Code 是个“编辑器头”不是模型本身Claude Code 本质上是 Anthropic 推出的命令行编程助手它跑在你的终端里让你用自然语言让 AI 读取项目、改代码、跑命令、提交 Git。你可以把它理解成一个“聪明的壳子”真正干活的模型在背后。这个“壳子”和模型之间是通过 API 连接的。官方默认把模型指向 Anthropic 自家的 Claude 系列但既然是 API 连接理论上我只要把请求的目标地址换一下就能让它调用别的模型。这正是集成国产大模型的理论基础。我在给朋友演示时常用的比喻是Claude Code 就像一个支持“随心换卡”的手机官方给你装的是 Anthropic 的 SIM 卡而我们要做的事就是把 SIM 卡抽出来换上一张国产运营商的卡。手机本身的打电话、发消息功能不变但走的网络已经从官方变成国产模型服务商了。1.2 “API 兼容”才是整件事的钥匙换个“SIM 卡”不是随便换的关键看对方的接口长什么样。Anthropic 给 Claude Code 定义了一套 API 格式这套格式里包含了请求头、消息结构、模型名称等规定。理论上任何模型服务商只要把这套格式“仿照”出来Claude Code 就能无缝对接。这里有两类服务商可以选直接兼容 Anthropic API 格式的国产服务商比如 DeepSeek 官方就专门开放了一个 Anthropic 兼容端点这个最省事。本地模型运行工具比如 Ollama它本身不提供云端模型但能在你的电脑上跑开源模型并且暴露一个兼容层接口让 Claude Code 能调用本地模型。所以整个集成的核心就两件事把ANTHROPIC_BASE_URL指向国产模型的地址把ANTHROPIC_AUTH_TOKEN换成对应 API Key。后面所有配置都是围绕这两个环境变量展开的。2. 基础环境一次性收拾好Node.js、nvm 与 npm 源Claude Code 是 Node.js 应用官方安装方式是全局 npm 包。所以要跑起来第一关不是装 Claude Code 本身而是先有一个干净、可用的 Node.js 环境。这一步对老手来说很简单但对小白来说处处是坑我拆细一点讲。2.1 非装不可的 Node.js 18以及为什么Claude Code 要求 Node.js 版本在 18 以上。如果版本太低npm 安装时不会立刻报错但一运行claude命令就会蹦出一堆莫名其妙的错误比如语法不支持、内部模块找不到。我自己习惯的做法是安装最新的 LTS长期支持版比如 20.x 或 22.x。LTS 版本最稳社区反馈也多万一遇到问题更容易搜到解决方案。不建议追新装奇数版本或太激进的预览版否则可能遇到兼容性 bug排起来非常头疼。这里有个很容易忽略的地方装完 Node.js 之后在终端里执行node -v和npm -v验证一下看到版本号才说明装好了。有些同学装完直接开干结果发现命令找不到往往是因为安装时没有把node和npm加入系统 PATH或者安装完成后没有重新打开终端窗口。2.2 用 nvm 管理 Node 版本避免升级灾难如果只是装一个 Node.js最简单的是去官网下载安装包。但我强烈建议小白一开始就使用 nvmNode Version Manager也就是 Node 版本管理器。原因很简单你以后一定会遇到某个项目要求用 Node 16另一个要求用 Node 20这时候用 nvm 就能一键切换不用卸载重装。Windows 用户去搜nvm-windows下载安装包后安装然后终端里执行nvm install 20和nvm use 20。macOS 或 Linux 用户直接在终端执行安装脚本再同样执行nvm install 20和nvm use 20。使用 nvm 后在每个新终端窗口里检查node -v确认当前用的 Node 版本是你刚设置的那个。我碰到过不少案例安装完 nvm 后忘了nvm use导致实际跑的仍然是旧版本后面 Claude Code 时报错又查不出原因纯属自折腾。2.3 npm 换源别让安装卡在进度条上npm 是 Node.js 自带的包管理器Claude Code 就靠它安装。默认 npm 官方源在海外的下载速度真心不稳定尤其国内网络环境下经常卡在进度条上或者下载到一半直接超时失败。我在国内环境装包之前会先把 npm 源切到国内镜像比如淘宝镜像。命令如下npm config set registry https://registry.npmmirror.com设置完可以执行npm config get registry确认已经生效。这一步能让你后面安装 Claude Code 的速度提升一个量级基本几十秒就能装完。而且这个设置是持久化的以后装其他全局包也受益。这里补充一句换源只会影响 npm 下载包的仓库地址不会影响你本机的 Node.js 运行逻辑所以放心换不会弄坏环境。唯一需要注意的是如果你将来要发布自己的 npm 包记得换回官方源否则发布地址会不对但那是后话了。3. 安装 Claude Code 并跑通第一次对话环境收拾利索之后真正的安装就变得很简单了。我用最小步骤带你走一遍顺便把第一次登录时最容易困惑的选择题讲清楚。3.1 一行命令装好全局工具Claude Code 的安装命令是npm install -g anthropic-ai/claude-code这段命令里的-g表示全局安装意味着之后你在任何目录下都能直接使用claude命令。安装完成后执行claude --version如果能看到版本号说明核心程序已经装好了。如果你用的是 nvm 管理的 Node 环境有个细节要注意nvm 切换版本后全局包并不会自动跟随。比如你在 Node 20 下装了 Claude Code切到 Node 18 后突然找不到claude命令就是这个原因。解决方法是切到对应版本后重新执行一次安装命令或者把当前 Node 版本设置为默认版本。3.2 第一次登录有订阅账号和纯 API Key 是两条路线在终端里输入claude回车程序会开始初始化。这时你会看到需要登录的提示。这里有两条路线决定了你后面配置走多远路线一有 Anthropic 官方账号且开通了 Claude 订阅或 API 计费账号。走官方交互式登录浏览器里授权完就能直接用。这种体验最省心但和你“想用国产模型”的目标不太一致除非你想做官方模型和国产模型的对比测试。路线二没有官方订阅想直接用国产模型。这种情况下不需要在 Claude Code 的登录流程里走完只需要在启动claude前把环境变量指向国产模型服务商即可。Claude Code 发起请求时会读取环境变量里的 Base URL 和 Token如果发现指向的是第三方地址它会跳过官方登录直接用你提供的第三方配置。我第一次配置时就卡在这个位置以为是必须先登录才能用结果一直填邮箱、跳转浏览器、授权失败折腾半天。后来搞清楚只要环境变量设对了claude启动后直接进入对话界面完全不用管官方登录流程。3.3 在 VS Code 里把 Claude Code 用顺手Claude Code 本身是一个终端工具但很多人习惯在 VS Code 里写代码。这里我推荐的方式不是装什么第三方插件最稳的做法是直接用 VS Code 内置终端。打开 VS Code按快捷键Ctrl \macOS 是Control ~打开终端确保当前终端使用的 Node 版本正确然后输入claude 命令。这样 Claude Code 就在你编辑器的底下跑起来了它读取的是当前目录的项目文件你在对话里让它改代码它会直接操作项目目录里的文件非常贴合写代码的工作流。还有一个实用技巧在 VS Code 的终端里如果中途想和 Claude Code 说要换一个上下文或开始新对话可以使用命令/clear。如果想带着当前对话上下文继续在另一个会话里操作可以用claude -c启动这会尝试继续上次会话。4. 接国产模型的方案 A本地 Ollama免费且离线可用环境变量明白了原理清楚了现在可以正式接国产模型。第一种方案是在本地跑开源模型最常用的工具是 Ollama。这个方案的最大优点是免费、数据不出电脑缺点是模型能力受限于你电脑的性能。4.1 Ollama 的安装和模型下载去 Ollama 官网下载对应系统的安装包装完在终端验证ollama --version然后下载模型比如我常用的几个ollama pull deepseek-coder ollama pull qwen2.5-coder:7b这里的deepseek-coder和qwen2.5-coder都是适合编程的开源模型。下载大小通常几个 GB取决于模型参数规模所以要有耐心。下载完成后可以先用自带命令验证模型能正常对话ollama run deepseek-coder如果能正常回复说明模型已经被 Ollama 管理起来了。这一步不能省因为很多人配置完 Claude Code 发现连不上最后排查半天发现是 Ollama 服务根本没启动或者模型压根没下载成功。4.2 Claude Code 对接 Ollama 的配置写法Ollama 提供了一个兼容 Anthropic API 格式的接口地址是http://localhost:11434/anthropic我们要做的就是把 Claude Code 的请求指向这里。在启动claude命令前先设置几个环境变量。以 Windows PowerShell 为例$env:ANTHROPIC_BASE_URL http://localhost:11434/anthropic $env:ANTHROPIC_AUTH_TOKEN ollama $env:ANTHROPIC_MODEL deepseek-coder $env:ANTHROPIC_SMALL_FAST_MODEL deepseek-codermacOS 或 Linux 用户用 export 语法export ANTHROPIC_BASE_URLhttp://localhost:11434/anthropic export ANTHROPIC_AUTH_TOKENollama export ANTHROPIC_MODELdeepseek-coder export ANTHROPIC_SMALL_FAST_MODELdeepseek-coder然后输入claude启动。如果配置正确你会直接进入对话界面这时让 Claude Code 帮你写一个 Python 脚本试试它能正常响应就说明联通成功。这里的ANTHROPIC_AUTH_TOKEN设置为一个占位符ollama就可以因为 Ollama 本身不校验 Key但不能不填否则 Claude Code 会认为没有凭证直接拒绝请求。4.3 本地模型的体验边界能干活但不是全能本地模型方案并不是十全十美我在实际使用中总结了几条边界响应速度取决于硬件7B 级别的模型在普通笔记本上还能接受14B 以上就开始明显变慢。如果电脑没有 NVIDIA 独显建议乖乖用 7B 或更小的模型。上下文窗口有限本地模型通常不如云端模型能容纳那么多代码上下文。处理大型项目时可能会感到 Claude Code“记不住”之前的修改这时需要更主动地清理会话或分模块让它干活。代码能力有天花板DeepSeek-Coder 或 Qwen2.5-Coder 在常见编程任务上已经很能打但和顶级的云端闭源模型比还是有差距特别是在复杂架构设计、跨文件重构这类任务上。所以我的看法是本地 Ollama 方案最适合对数据隐私敏感、或不想为 AI 编程助手付费的开发者入门。作为尝鲜、日常脚本编写、小项目辅助完全够用。5. 接国产模型的方案 B云端 API 直连效果接近原版如果本地模型不能满足你的需求或者你电脑性能不够第二种方案是直接用云端国产大模型的 API。目前最省事也最推荐给小白的是 DeepSeek 官方提供的 Anthropic 兼容端点。这一节我详细讲配置方法再告诉你判断其他服务商能不能接入的方法。5.1 DeepSeek 官方兼容端点的配置DeepSeek 是国内比较早开放 Anthropic API 兼容格式的国产模型厂商这意味着 Claude Code 能直接用官方提供的方式对接不需要额外中转层。先去 DeepSeek 开放平台注册账号创建一个 API Key然后按下面的方式配置环境变量export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN这里填你的DeepSeek API Key export ANTHROPIC_MODELdeepseek-chat export ANTHROPIC_SMALL_FAST_MODELdeepseek-chat配置好后在终端里运行claude正常情况会直接绕过官方登录进入对话界面。这时让它读取你项目目录里的代码、写一个测试用例、或者解释一段陌生代码体验和官方版 Claude Code 几乎没有差别只是背后的模型换成了 DeepSeek。DeepSeek 史无前例地把 Anthropic 兼容端点做得足够原生连 Claude Code 会用到的Anthropic-API-Version请求头都能正确响应。所以配置过程中基本不会遇到兼容性报错对小白友好度相当高。5.2 其他国产模型服务的接入判断方法除了 DeepSeek市面上还有通义千问、Kimi、智谱等国产模型但它们的 API 格式并不都原生兼容 Anthropic。这时候不要慌可以先做一个判断登录对应模型服务商的开发者文档搜索“Anthropic”或“Claude Code”如果官方有提供 Anthropic 兼容端点直接照抄 DeepSeek 的配置模式只是换掉 Base URL、Token 和模型名即可。如果官方文档只提供 OpenAI 兼容格式那么通常不能直接接到 Claude Code 上。这时可以找一些网关工具做格式转换但这需要额外部署复杂度高不适合纯小白。在我测试过的模型服务里DeepSeek 是目前对接 Claude Code 最无痛的国产云端模型。这不是广告而是实际踩坑总结出来的结论——其他家我也试过有的需要额外加载 Json 格式转换有的对长上下文支持不稳定综合体验都差点意思。5.3 用 CC Switch 这类工具管理多套配置你可能会想今天想用 DeepSeek明天想切回官方 Claude后天又想试试本地 Ollama每次都在环境变量里改来改去太麻烦了。这个问题社区里早就有人做了工具叫做 CC Switch。CC Switch 是一个配置切换工具相当于给 Claude Code 装了一个“遥控器”你可以在图形界面里预先保存好几套环境变量配置比如“DeepSeek 云端”“Ollama 本地”“官方 Claude”之后点一下就能切换不用每次手敲 export 命令。这类工具的原理就是帮你临时改写当前 shell 的环境变量然后重新启动 Claude Code。如果你喜欢折腾也可以用脚本自己实现但小白我建议直接用现成工具省心。切换配置后记得要重新启动claude因为环境变量是在进程启动时读取的改完不重启不会生效。这是一个很多人忽略的细节。6. 排错实录三类最常见的故障与完整排查思路配置过程不会总是一帆风顺我在帮朋友配置时遇到最多的故障主要三类。这一节我不仅给答案更会把排查链路讲清楚下次你再遇到类似问题可以按这个思路自己定位。6.1 403 Forbidden先查 Base URL、Token 和模型名三者是否自洽如果启动claude后对话窗口刚发出一条消息就弹出一大段403 Forbidden错误不用慌这几乎可以断定是认证配置出了问题。先检查ANTHROPIC_BASE_URL是否写对少一个/anthropic、多一个/v1就会让请求打到错误路径上。再检查ANTHROPIC_AUTH_TOKEN是不是正确的 API Key有些服务商新建的 Key 要过几分钟才生效。最后检查ANTHROPIC_MODEL的模型名是否真实存在比如 DeepSeek 的模型名是deepseek-chat而不是deepseek-coder后者是本地模型的叫法。我总结过一个排查顺序先跑通服务商自己的测试接口用curl命令直接请求一次确认服务端正常再检查 Claude Code 环境变量最后看 Claude Code 实际请求的 URL 是什么。注意不要输出包含 API Key 的请求体到公网注意安全。如果 curl 直接访问服务商接口是通的但 Claude Code 报 403那大概率是环境变量没有被正确传到 Claude Code 进程里。检查一下是不是在同一个终端窗口里设置了环境变量然后又在另一个窗口运行了claude这是新手最容易犯的错误。6.2 “Your organization has disabled”这类账号限制怎么绕有些同学一开始先用官方账号登录过 Claude Code后来想切到国产模型结果每次启动都提示类似Your organization has disabled Claude subscription access for Claude Code的报错。出现这个提示的根本原因是 Claude Code 检测到了某个官方配置残留优先走了官方认证流程而该账号没有权限使用 Claude Code。解决办法不是去和官方客服申诉而是把你配置里的官方相关痕迹清干净删除用户目录下 Claude Code 存放的本地认证信息文件。一般是~/.claude这个隐藏目录Windows 在C:\Users\你的用户名\.claudemacOS/Linux 在~/.claude。找到和 auth、credentials、tokens 相关的文件后备份并删除。同时检查项目目录下有没有.claude文件夹如果有也一并处理。确保在启动claude前已经明确设置了ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN让进程知道该走哪个端点。处理完后再启动报错就会消失。这个坑的隐蔽性在于它和你的代码没有关系而是残留的本地状态在捣鬼。以后不要再拿这个被限制的账号走官方流程专心用国产模型配置即可。6.3 连接超时、模型答非所问环境与上下文的锅连接超时这个问题分成两种情况看。第一种情况是本地 Ollama 方案连接超时。先执行ollama ps或ollama list确认 Ollama 服务还活着、模型还在。如果 Ollama 服务没启动执行ollama serve启动后再试。如果 Ollama 正常但 Claude Code 还是超时检查一下你设的ANTHROPIC_BASE_URL是不是用了https而不是http本地服务通常是http://localhost:11434用https就会超时。第二种情况是云端 API 超时。检查 API Key 账户余额是否充足有些服务商欠费后不报 401 而是直接超时。如果余额正常尝试换一个更稳定的网络环境重试。至于“模型答非所问”或者“突然开始说英文”大多数时候是ANTHROPIC_MODEL设错了模型导致 Claude Code 心里想的是用一个模型实际请求的是另一个模型。比如你想用 DeepSeek Chat却在环境变量里写成了deepseek-coder就会出现奇怪的响应。另一个可能性是上下文填得太满模型被大量历史消息干扰用/clear清空后重开就好。7. 我的最终配置存档和几个使用习惯教程写到这里整个集成的关键路径已经走完了。最后我把目前自己机器上最常用的一套配置和几个使用习惯放出来你可以照着抄也可以在这个基础上按需调整。我的 Windows 机器上当前默认用的是 DeepSeek 云端方案配置长这样$env:ANTHROPIC_BASE_URL https://api.deepseek.com/anthropic $env:ANTHROPIC_AUTH_TOKEN sk-你的DeepSeek Key $env:ANTHROPIC_MODEL deepseek-chat $env:ANTHROPIC_SMALL_FAST_MODEL deepseek-chat如果你想要一套既能用云端又能在本地来回切的方案建议把两套配置存成两个脚本文件比如use-deepseek.ps1和use-ollama.ps1每次要切换时直接执行对应脚本。熟练之后也可以只配置一套 Ollama 本地但遇到大任务时再切到云端灵活度最高。平时用 Claude Code 跑国产模型时有三个习惯对我的实际效率提升很明显。第一个是每次让 Claude Code 动手改代码前先在对话里明确告诉它项目背景和约束条件而不是直接扔一句“帮我优化一下”。第二个是做完一步就检查一步用/clear分隔不同子任务避免上下文纠缠。第三个是涉及到重要的重构操作会先让 Claude Code 输出改动计划再让它落地因为国产模型在一些极端情况下会“用力过猛”提前制定计划可以避免大范围误改。这也是我反复跟身边朋友强调的一点工具是放大器你的使用方式决定了它能放大多少倍。把 Claude Code 接到国产大模型只是第一步之后你如何使用它、如何给它设定边界才是真正影响你开发效率的关键。希望这篇教程能帮你顺利跑通第一段对话剩下的路就得靠你自己在项目里来回试了。
 到 withHeadroom 的 LLM 上下文压缩全链路)
