 保姆级教程：从 Node/npm 安装到 DeepSeek 模型接入的完整配置)
1. 从零跑通 Claude Code CLI：Node 环境准备与 DeepSeek 模型接入的完整链路
Claude Code CLI 是 Anthropic 推出的命令行编程助手，它能在终端里直接读写项目文件、执行命令、跑测试，把「对话式编程」搬进了本地工程目录。很多第一次接触它的开发者会卡在两个地方：一是 Node/npm 环境版本不对导致安装失败，二是默认模型在国内网络下无法直接调用。这篇教程就围绕这两个真实痛点展开，把从 Node 22 环境准备、全局安装 Claude Code，到接入 DeepSeek 模型、验证 CLI 是否正常调用模型的整条链路讲清楚。适合谁看？刚装好终端、想用命令行 AI 辅助写代码，但还没跑通第一个对话任务的开发者。跟着做，你会在本地得到一个能正常回答「你是什么大模型」的 Claude Code CLI。
我试过在几台不同系统的机器上装，最容易翻车的不是安装命令本身，而是 Node 版本太旧。Claude Code 依赖较新的运行时特性，Node 18 以下经常报奇怪的模块错误，所以第一步必须把 Node 升到 22。下面按顺序来，每一步都有可复制的命令和预期结果。
2. Node/npm 环境准备：用 nvm 切到 Node 22 避免安装报错
2.1 为什么必须用 Node 22
Claude Code 的 npm 包在安装时会检查运行时版本，低版本 Node 可能在解析依赖或执行 CLI 时抛出SyntaxError或ERR_REQUIRE_ESM。Node 22 是目前 LTS 里兼容性最稳的一档，nvm 又能让你在不同项目间自由切换版本，不会污染系统自带的 Node。所以推荐用 nvm 管理，而不是直接去官网下安装包覆盖。
Windows 用户可以用 nvm-windows，macOS/Linux 用官方的 nvm 脚本。装好之后，打开终端执行：
nvm install 22 nvm use 22 node -v npm -v预期输出类似v22.x.x和10.x.x。如果node -v还是旧版本，说明nvm use没生效，检查一下终端是不是需要重开，或者 nvm 的环境变量有没有写进 shell 配置。
2.2 配置 npm 镜像加速下载
国内直连官方 npm registry 经常超时，安装大包时尤其明显。可以先把 registry 指向国内镜像：
npm config set registry https://registry.npmmirror.com npm config get registry第二条命令用来确认配置生效，输出应该是https://registry.npmmirror.com。这个镜像同步频率高，绝大多数包都能拿到最新版本。注意这只是加速下载，不影响包本身的功能。
2.3 全局安装 Claude Code 并验证版本
环境就绪后，执行全局安装：
npm install -g @anthropic-ai/claude-code安装完成后验证：
claude --version能打印出版本号就说明 CLI 已经装好了。如果这一步报command not found，多半是 npm 全局 bin 目录没进 PATH，可以用npm config get prefix看下路径，再把它加到环境变量里。踩过的坑是：有些机器上同时装了多个 Node，npm install -g装到了另一个版本下，结果当前终端找不到命令，用nvm use 22统一一下就好。
到这里，CLI 本体已经可用，但它默认会去连 Anthropic 的模型服务，国内网络下这一步会失败。接下来要解决模型接入问题。
3. TaoToken 前置与 DeepSeek 模型接入配置
3.1 为什么需要一个兼容层
Claude Code 读取的是ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN这类环境变量，它期望后端提供 Anthropic 风格的接口。DeepSeek 提供了兼容 Anthropic 协议的入口，所以我们可以把 Base URL 指向 DeepSeek 的兼容地址，再把模型 ID 换成 DeepSeek 的型号。这样 Claude Code 的交互逻辑不变，底层跑的是 DeepSeek 模型。
如果你希望统一管理多个模型的 Key、随时切换供应商，可以用 TaoToken 的控制台来集中配置。它的 API 入口是https://taotoken.net/api，模型对话、Coding Plan、API Keys 都在同一套体系里。对于长期做编码和 Agent 任务的场景，Coding Plan 会比按量计费更省心。下面先给出直接接 DeepSeek 的配置，再说明如何用 TaoToken 做统一管理。
3.2 可复制的 settings 配置片段
Claude Code 的配置写在用户目录下的 settings 文件里。Windows 一般在C:\Users\你的用户名\.claude\settings.json，macOS/Linux 在~/.claude/settings.json。把下面这段 JSON 复制进去，替换掉你的 DeepSeek API Key：
{ "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的 DeepSeek API Key", "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[1m]", "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1", "CLAUDE_CODE_EFFORT_LEVEL": "max" } }这里几个字段的作用要理解清楚：ANTHROPIC_BASE_URL决定请求发往哪里；ANTHROPIC_AUTH_TOKEN是鉴权凭证；ANTHROPIC_MODEL是默认模型；后面三个DEFAULT_*分别对应 Claude Code 内部不同档位的模型映射，把 Opus/Sonnet 都指向 pro，Haiku 指向 flash，能在保证质量的同时控制成本。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关掉非必要遥测，CLAUDE_CODE_EFFORT_LEVEL设为 max 让模型在编码任务上多花点推理预算。
3.3 用 TaoToken 统一管理多模型 Key
如果你不想把 DeepSeek 的 Key 硬编码在 settings 里，或者想同时保留多个模型随时切换，可以在 TaoToken 控制台创建 API Key，然后把 Base URL 指向 TaoToken 的 API 入口。配置形态和上面一致，只是把ANTHROPIC_BASE_URL换成 TaoToken 提供的地址，ANTHROPIC_AUTH_TOKEN换成 TaoToken 的 Key，模型 ID 按你开通的型号填写。这样切换供应商时只改一个字段，不用动整个配置文件。API Key 的创建入口在控制台的 API Keys 页面，接入细节可以对照官方文档。
注意：API Key 只会在创建时完整显示一次，务必当场复制保存。不要把它提交到 Git 仓库，也不要写进前端代码。
4. 验证请求：确认 CLI 正常调用 DeepSeek 模型
4.1 首次启动与信任文件夹
配置写好后，打开终端进入你的项目目录，执行：
claude第一次进入会看到主题选择，用上下键选编号 1 的自动控制模式，回车。接着会弹出安全提示，说明 Claude Code 会读写当前目录的文件，直接回车确认。然后它会问是否信任这个文件夹，选 yes。默认启动目录是用户目录，建议先cd到具体项目再启动，避免误操作。
4.2 用一句话验证模型身份
进入交互界面后，直接输入：
你是什么大模型？如果配置正确，它会回答自己是 DeepSeek 系列模型。这一步是判断整条链路是否打通的关键：如果它仍然说自己是 Claude，说明ANTHROPIC_MODEL没生效，或者 settings 文件路径不对；如果报鉴权错误，说明 Key 或 Base URL 有问题。
4.3 跑一个真实的小任务
身份验证通过后，可以试一个实际编码任务，比如让它读当前目录的文件并解释结构：
列出当前目录的文件，并说明这个项目是做什么的观察它是否能正常调用工具读取文件、返回合理结果。能完成这一步，说明模型调用、工具调用、文件读写都正常。到这里，你的 Claude Code CLI 已经可以日常使用了。
5. 本篇常见错误排查：401、local proxy failed 与 reading choices 报错
5.1 401 鉴权失败
最常见的报错是401 Unauthorized。原因通常是ANTHROPIC_AUTH_TOKEN填错、Key 已失效，或者 Base URL 和 Key 不匹配。排查顺序：先确认 Key 没有多余空格，再确认ANTHROPIC_BASE_URL指向的是对应供应商的兼容入口。如果用的是 TaoToken 的 Key，Base URL 也要用 TaoToken 的地址，不能混用。
5.2 local proxy failed
出现local proxy failed或连接超时，一般是网络层问题。先确认终端能正常访问外网，再检查 Base URL 是否写错协议或域名。如果公司网络有出口限制，可能需要换网络环境。注意不要使用任何违规的网络工具，合规网络下 DeepSeek 的兼容入口通常可以直连。
5.3 reading choices 报错
error reading choices或类似解析错误，多半是后端返回的不是 Anthropic 兼容格式。检查ANTHROPIC_BASE_URL是否漏了/anthropic后缀，或者模型 ID 写成了不存在的型号。DeepSeek 的兼容入口需要完整的路径，模型 ID 也要和平台文档一致，比如deepseek-v4-pro[1m]这种带后缀的写法不能随意改。
5.4 OAuth 相关报错
如果看到 OAuth 登录提示或 token 刷新失败，说明 Claude Code 在尝试走官方账号体系。这时候要确认 settings 里的ANTHROPIC_AUTH_TOKEN已经覆盖了默认鉴权，并且没有残留的官方登录态。可以删掉~/.claude下的缓存文件重新启动。
5.5 配置三件套对照表
无论用哪家供应商，接入时都要保证三件套一致：
| 配置项 | 作用 | 常见错误 |
|---|---|---|
| Base URL | 请求发往的兼容入口 | 漏/anthropic后缀、协议写错 |
| API Key | 鉴权凭证 | 多余空格、Key 与入口不匹配 |
| Model ID | 指定调用的模型 | 型号不存在、后缀写错 |
这三项任意一个不对，都会导致调用失败。排查时逐项核对，比盲目重装有效得多。
6. 长期编码与 Agent 任务的进阶选择
跑通第一个对话任务只是起点。如果你打算把 Claude Code 用在日常编码、代码审查、Agent 自动化上，按量计费可能会让成本不可控。这时候可以考虑 TaoToken 的 Coding Plan，它面向长期编码场景，配合 API Keys 和接入文档可以快速把多个项目统一到一套配置下。验证模型能力时，可以先用模型对话页面快速试不同型号的表现，再决定主力模型。
具体操作上，进入控制台创建 API Key，把 Base URL 和 Key 写进 settings，模型 ID 按需选择。接入文档里有完整的字段说明和示例，照着改就行。对于需要频繁切换模型的团队，这套方式比每个项目单独维护配置文件要清爽得多。
最后留一个实用技巧：把 settings.json 纳入版本管理时，用环境变量占位符代替真实 Key，本地再通过 shell 注入。这样既方便团队共享配置结构，又不会泄露凭证。跑通之后，你可以试着让它读一个真实项目、修一个真实 bug，感受一下命令行 AI 编程的节奏。
