1. Windows 下 WSL + Claude Code 安装配置：从零到跑通一次真实请求
如果你在 Windows 上想用 Claude Code 做终端里的编码助手，但又不想装双系统、不想开虚拟机，那 WSL 就是最省事的路径。WSL 全称 Windows Subsystem for Linux，它让你在 Windows 里直接跑一个完整的 Linux 环境，文件互通、命令互通，Claude Code 这种为类 Unix 终端设计的工具跑起来最舒服。这篇内容面向的是刚接触 WSL、Node.js 环境还没配好、Claude Code 装完不知道怎么接 API 通道的 Windows 用户。我会从 WSL 安装、发行版选择、Node.js 准备，一路写到 Claude Code 初始化，再把 API 通道统一到 TaoToken，最后用一次真实请求验证整条链路是通的。整个过程你都可以直接复制命令跟做，遇到报错我也会在第五节把常见坑列出来。
先说清楚一件事：Claude Code 本身是一个命令行工具，它底层通过 Anthropic Messages API 格式和模型通信。也就是说，只要某个服务兼容这个 API 格式，你就可以通过环境变量把请求转发过去。TaoToken 提供的就是这样一个统一入口，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end ，API 地址是 https://taotoken.net/api 。你拿到一个 Key，就能在 Claude Code 里把 Base URL、Key、Model ID 三件套配好，不用在多个厂商之间来回切换配置。这对经常换模型、或者想统一管理调用通道的人来说，省掉了很多重复劳动。
我实测下来，Windows 11 + WSL2 + Ubuntu 这套组合最稳。Windows 10 需要 2004 及以上版本，太老的系统 WSL2 支持不完整，建议先升级。下面按步骤来，每一步都有命令和预期结果。
2. WSL 安装与发行版选择：避开 C 盘空间和网络模式的坑
2.1 安装 WSL 与选择发行版
打开 PowerShell（管理员权限），执行：
wsl --install这条命令会默认安装 Ubuntu 发行版并启用 WSL2。安装完成后系统会要求你设置 Linux 用户名和密码。注意，输入密码时屏幕上不会显示任何字符，这是正常的盲键入，不是键盘坏了。设置完重启电脑，在开始菜单搜索 wsl 就能启动。
如果你想要别的发行版，可以先看列表：
wsl --list --online然后指定安装，比如：
wsl --install -d Ubuntu-22.04发行版选择上，Ubuntu 22.04 LTS 或 24.04 LTS 都可以，LTS 版本软件源稳定，Node.js 和 npm 的安装文档也最全。不建议用太新的非 LTS 版本，有些依赖包还没跟上，容易在 npm install 阶段报编译错误。
进入 WSL 后验证版本：
lsb_release -a你会看到类似Ubuntu 22.04 LTS的输出。确认发行版正常后，先更新一次软件源：
sudo apt update && sudo apt upgrade -y2.2 迁移 WSL 安装目录，别让 C 盘爆掉
默认情况下 WSL 的根文件系统装在 C 盘，用久了动辄几十 GB。建议迁移到其他盘。先在 PowerShell 里导出：
wsl --export Ubuntu F:\wsl-ubuntu.tar然后注销当前发行版：
wsl --unregister Ubuntu在目标盘创建目录并导入：
wsl --import Ubuntu E:\WSL\ubuntu F:\wsl-ubuntu.tar导入后启动 WSL，用wsl -l -v确认状态是 Running、版本是 2。迁移完成后原来的 tar 包可以删掉，省空间。
2.3 网络模式：mirrored 让 WSL 和 Windows 共享网络
WSL2 默认是 NAT 模式，Windows 宿主机和 Linux 子系统在独立子网里。如果你在 Windows 上开了代理类网络工具，启动 WSL 时经常会看到提示：
wsl: 检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理。这个提示的意思是 WSL 没法直接用 Windows 上的 localhost 代理。解决办法是启用镜像网络模式。在 Windows 用户目录（通常是C:\Users\你的用户名）下创建.wslconfig文件，注意文件名以点开头、没有扩展名。写入：
[wsl2] networkingMode=mirrored dnsTunneling=true firewall=true autoProxy=true保存后在 PowerShell 执行：
wsl --shutdown重新启动 WSL，网络就变成镜像模式了。这一步对后面 Claude Code 能正常发出请求很关键，如果网络不通，你会卡在连接超时上。
3. Node.js 环境准备与 Claude Code 安装配置
3.1 安装 Node.js 和 npm
Claude Code 通过 npm 分发，所以先要有 Node.js。用二进制包安装最干净，不污染系统包管理。在 WSL 里执行：
wget https://nodejs.org/dist/v20.11.1/node-v20.11.1-linux-x64.tar.xz tar -xf node-v20.11.1-linux-x64.tar.xz sudo mv node-v20.11.1-linux-x64 /usr/local/nodejs rm node-v20.11.1-linux-x64.tar.xz配置环境变量：
echo 'export PATH=/usr/local/nodejs/bin:$PATH' >> ~/.bashrc source ~/.bashrc验证：
node -v npm -v能打印出版本号就说明环境好了。这里建议用 Node.js 18 以上，20 LTS 更稳，Claude Code 对 Node 版本有最低要求，太老的版本会在安装时报 engine 不匹配。
3.2 安装 Claude Code
npm install -g @anthropic-ai/claude-code安装完成后验证：
claude -v如果提示 command not found，检查 npm 全局 bin 目录是否在 PATH 里，可以用npm config get prefix看路径，再把它加到.bashrc。
3.3 配置 TaoToken 统一 Key
Claude Code 安装后不会自动创建配置目录，需要手动建。先创建目录和配置文件：
mkdir -p ~/.claude vim ~/.claude/settings.json写入以下 JSON，把sk-你的Key换成你在 TaoToken 控制台拿到的真实 Key：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }保存退出（vim 里按:wq）。这里三件套要对应上：Base URL 是https://taotoken.net/api，Key 是你在控制台生成的，Model ID 填你要用的模型标识。如果你用的是其他兼容 Anthropic 格式的模型，把 Model ID 换成对应的即可。
Key 的获取入口在控制台的 API Keys 页面，文档在接入文档里，模型对话入口可以用来先测模型是否可用。这几个地址分别是：
- API Keys：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
- 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite
- 模型对话：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite
如果你打算长期用 Claude Code 做编码或跑 Agent，可以看下 Coding Plan，入口是 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。
4. 验证请求：跑通一次真实对话
配置写完后，创建工作目录并启动：
mkdir -p ~/workspace cd ~/workspace claude首次运行会提示选择主题样式，默认 Dark mode 即可。进入交互界面后，先确认当前模型：
/model应该显示你配置的 Model ID。然后输入一句简单的话测试，比如「用一句话解释什么是递归」。如果模型正常返回，说明整条链路通了。
你也可以用非交互方式快速验证：
claude -p "输出当前配置的模型名称"如果返回内容正常，说明 Base URL、Key、Model ID 三件套都生效了。这一步能过，后面就可以正常在项目里用 Claude Code 读写文件、执行命令了。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth
5.1 401 Unauthorized
最常见的是 Key 写错或没生效。检查~/.claude/settings.json里的ANTHROPIC_AUTH_TOKEN是否和 TaoToken 控制台里的一致，注意不要有多余空格或换行。改完后要重新启动 claude，环境变量是启动时读取的。
5.2 local proxy failed
这个报错通常和网络模式有关。如果你在 Windows 上开了代理类工具，而 WSL 还是 NAT 模式，就会出现 localhost 代理不通。回到第 2.3 节，确认.wslconfig里networkingMode=mirrored和autoProxy=true都写了，然后wsl --shutdown重启。重启后在 WSL 里用curl -I https://taotoken.net/api测一下连通性，能返回 HTTP 状态码就说明网络通了。
5.3 reading choices 相关报错
这类报错一般是返回体格式不符合预期，常见原因是 Base URL 写成了带路径的完整地址，或者 Model ID 填了一个服务端不认识的模型。确认ANTHROPIC_BASE_URL就是https://taotoken.net/api，不要多加/v1之类的后缀。Model ID 用文档里列出的可用模型标识。
5.4 OAuth 相关提示
Claude Code 某些版本会尝试走 OAuth 登录流程，如果你已经用环境变量配了 Key，可以忽略或跳过登录。如果它强制要求登录导致卡住，检查 settings.json 的 env 段是否被正确读取，可以用claude -p "test"看是否直接走 Key 认证。
5.5 配置三件套对照表
| 配置项 | 值 | 说明 |
|---|---|---|
| Base URL | https://taotoken.net/api | 不要加多余路径 |
| API Key | sk-你的Key | 控制台生成，注意空格 |
| Model ID | claude-sonnet-4-20250514 | 按文档可用模型填 |
排查时按这个表逐项核对，大部分连接问题都能定位到。
6. 把通道固定下来，后续换模型只改一个字段
整套流程走完，你得到的是一个可复制的本地环境：WSL2 + Ubuntu + Node.js 20 + Claude Code，API 通道统一指向 TaoToken。以后想换模型，只需要改~/.claude/settings.json里的ANTHROPIC_MODEL一个字段，Base URL 和 Key 都不用动。这对需要对比不同模型输出、或者团队里统一调用入口的场景很实用。
如果你还没拿 Key，先去 https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 生成一个，再对照 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&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 格式这两处。
