1. 为什么第一次装 Claude Code 总卡在环境这一步
Claude Code 是 Anthropic 推出的命令行编程助手，能直接在终端里读你的项目、改代码、跑命令，适合想用 AI 辅助写代码但又不想离开编辑器的开发者。它本身是个 npm 包，装起来就一行命令，真正让人头疼的是装完之后——默认它要连 Anthropic 官方通道，国内网络环境下经常连不上，或者你得单独去搞一套账号体系。
我见过太多人卡在claude敲下去没反应、或者报 401、或者一直转圈。问题不在 Claude Code 本身，而在「模型通道」这一层。这篇教程的思路是：Claude Code 只负责当客户端，模型请求统一走 TaoToken 的 API 通道，模型选 deepseek-V4-pro。这样你只需要一个 Key，就能把 Claude Code 跑起来，不用折腾多套账号。
适合谁看：第一次接触 Claude Code 的开发者，Windows 或 macOS 都行，只要你会打开终端、会复制粘贴命令。全程大概 15 分钟，其中一半时间在等 Node.js 安装包下载。
下面按「环境准备 → 装 Claude Code → 配 TaoToken 通道 → 验证 → 排错」的顺序走，每一步都给可复制的命令。我试过在 Windows 11 和 macOS 上各跑一遍，配置骨架是通用的，只有环境变量写法有区别。
2. 前置准备：Node.js、npm 和 TaoToken Key
2.1 装 Node.js（自带 npm）
Claude Code 依赖 Node.js 18 以上版本。去 Node.js 官网下载 LTS 版本，Windows 下运行安装包一路 Next，macOS 下用 pkg 安装包或 Homebrew 都行。装完打开终端验证：
node -v npm -v两条命令都有版本号输出就说明环境 OK。版本号和我的不一样没关系，只要是 LTS 且 Node 主版本 ≥ 18 即可。如果npm -v报「command not found」，说明 npm 没跟着 Node 一起装上，重装 Node.js 时注意勾选 npm 组件。
2.2 拿 TaoToken 的 Key
TaoToken 在这里的角色是「统一 API 通道」：Claude Code 发出的模型请求，通过它转发到 deepseek-V4-pro。你只需要在 TaoToken 控制台创建一个 API Key，后面所有配置都围绕这个 Key 展开。
操作路径：打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，进控制台，在 API Keys 页面新建一个 Key，复制出来保存好。这个 Key 只显示一次，丢了就得重建。
注意：Key 属于敏感凭证，别写进会提交到 Git 的代码里。本地配置用环境变量，团队协作场景建议走各自的 Key。
拿到 Key 之后，记住两个地址：API 基础地址是https://taotoken.net/api，接入文档在 https://taotoken.net/doc 。后面配ANTHROPIC_BASE_URL时会用到。
3. 安装 Claude Code 并写入 settings.json 配置骨架
3.1 全局安装 Claude Code
一条命令搞定：
npm install -g @anthropic-ai/claude-code装完验证：
claude -v有版本号输出就说明 CLI 装好了。如果这一步报权限错误（macOS 常见），在命令前加sudo，或者按 npm 官方建议配置一个用户级全局目录，避免每次都要提权。
3.2 配置通道：环境变量写法
Claude Code 读取的是ANTHROPIC_*系列环境变量。核心是三个：ANTHROPIC_API_KEY填你的 TaoToken Key，ANTHROPIC_BASE_URL填 TaoToken 的 API 地址，ANTHROPIC_MODEL指定模型为 deepseek-V4-pro。
Windows 下用setx永久写入用户环境变量，打开 CMD 整段复制执行（把sk-xxx换成你自己的 Key）：
setx ANTHROPIC_API_KEY "sk-xxx" setx ANTHROPIC_BASE_URL "https://taotoken.net/api" setx ANTHROPIC_MODEL "deepseek-V4-pro" setx ANTHROPIC_DEFAULT_OPUS_MODEL "deepseek-V4-pro" setx ANTHROPIC_DEFAULT_SONNET_MODEL "deepseek-V4-pro" setx ANTHROPIC_DEFAULT_HAIKU_MODEL "deepseek-V4-pro" setx CLAUDE_CODE_SUBAGENT_MODEL "deepseek-V4-pro"macOS / Linux 下写进 shell 配置文件（zsh 是~/.zshrc，bash 是~/.bashrc）：
export ANTHROPIC_API_KEY="sk-xxx" export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_MODEL="deepseek-V4-pro" export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-V4-pro" export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-V4-pro" export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-V4-pro" export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-V4-pro"写完执行source ~/.zshrc让它生效。
3.3 settings.json 配置骨架
除了环境变量，Claude Code 还支持项目级或用户级的settings.json。用户级路径在~/.claude/settings.json（Windows 是C:\Users\你的用户名\.claude\settings.json）。一个可用的骨架长这样：
{ "env": { "ANTHROPIC_API_KEY": "sk-xxx", "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_MODEL": "deepseek-V4-pro", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-V4-pro", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-V4-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-V4-pro", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-V4-pro" } }环境变量和 settings.json 二选一即可，同时存在时 settings.json 里的env会覆盖同名环境变量。我一般推荐环境变量方式，换项目不用改文件；如果你要在多台机器间同步配置，settings.json 更方便。
提示：
ANTHROPIC_DEFAULT_OPUS_MODEL这几个变量是给 Claude Code 内部不同档位的请求做映射用的，统一指向 deepseek-V4-pro，避免它去请求不存在的模型名导致 404。
4. 验证请求：一条命令确认通道打通
配置写完，必须重开终端（Windows 下环境变量要新开 CMD 才生效），然后进任意项目目录：
cd 你的项目目录 claude第一次启动会问你是否信任当前目录，回车确认。然后直接输入一句话测试，比如：
这个项目用的是什么语言和框架？帮我列一下主要目录结构。如果配置正确，Claude Code 会开始读取文件并返回分析结果。想更直接地验证通道，可以在 Claude Code 里输入/status查看当前模型和 API 地址，确认ANTHROPIC_BASE_URL指向 TaoToken、模型是 deepseek-V4-pro。
再给一条纯命令行的验证方式，不启动交互界面也能测通道：
curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-xxx" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model":"deepseek-V4-pro","max_tokens":64,"messages":[{"role":"user","content":"说一句你好"}]}'返回 JSON 里带content字段就说明 Key 和通道都没问题。这一步能过，Claude Code 里基本不会再有连接类报错。
5. 本篇常见报错排查
5.1claude命令找不到
先重开终端再试。仍然报错的话，检查 npm 全局目录是否在 PATH 里：
npm config get prefix把输出的路径（Windows 通常是C:\Users\你的用户名\AppData\Roaming\npm）手动加到系统 PATH，重开终端。
5.2 401 / 认证失败
九成是 Key 写错了或者没生效。验证环境变量：
echo %ANTHROPIC_API_KEY%macOS 用echo $ANTHROPIC_API_KEY。有输出且和你的 Key 一致，说明变量生效；没输出就是没写进去，重开终端或检查 shell 配置文件。另外确认 Key 没有多余空格，复制时容易带上换行。
5.3 一直转圈或超时
先确认ANTHROPIC_BASE_URL是https://taotoken.net/api，别多写或少写路径。然后用上面那条 curl 命令单独测通道，curl 能通说明是 Claude Code 配置问题，curl 不通说明是网络或 Key 问题。如果公司网络有出口限制，换手机热点试一下能快速定位。
5.4 模型名报 404
检查ANTHROPIC_MODEL和几个DEFAULT_*_MODEL是否都写成了deepseek-V4-pro，大小写和连字符要和文档一致。漏配ANTHROPIC_DEFAULT_HAIKU_MODEL时，Claude Code 后台的小请求会去请求默认模型名，容易报错。
5.5 更新 Claude Code
版本旧了偶尔会有兼容问题，更新命令：
npm install -g @anthropic-ai/claude-code@latest更新完重开终端，claude -v确认版本。
6. 接下来怎么用：按场景选入口
通道打通之后，Claude Code 就是个顺手的终端编程助手。日常写代码、改 bug、读开源项目，直接在项目目录敲claude就行。如果你更想先在网页里试试 deepseek-V4-pro 的对话效果，可以走模型对话入口：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。
需要长期跑编码任务、或者想接 Agent 工作流的，建议看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite ，它更适合高频调用场景。Key 管理和新建在控制台：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，API Keys 页面：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。配置过程中遇到接入细节问题，接入文档在 https://taotoken.net/doc ，里面有针对 Claude Code 的说明。
最后留个实用习惯：把~/.claude/settings.json备份一份，换电脑时直接拷过去改 Key 就能用，比重新配一遍环境变量快得多。
