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_sourcetaotoken_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] networkingModemirrored dnsTunnelingtrue firewalltrue autoProxytrue保存后在 PowerShell 执行wsl --shutdown重新启动 WSL网络就变成镜像模式了。这一步对后面 Claude Code 能正常发出请求很关键如果网络不通你会卡在连接超时上。3. Node.js 环境准备与 Claude Code 安装配置3.1 安装 Node.js 和 npmClaude 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 Codenpm install -g anthropic-ai/claude-code安装完成后验证claude -v如果提示 command not found检查 npm 全局 bin 目录是否在 PATH 里可以用npm config get prefix看路径再把它加到.bashrc。3.3 配置 TaoToken 统一 KeyClaude 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/apiKey 是你在控制台生成的Model ID 填你要用的模型标识。如果你用的是其他兼容 Anthropic 格式的模型把 Model ID 换成对应的即可。Key 的获取入口在控制台的 API Keys 页面文档在接入文档里模型对话入口可以用来先测模型是否可用。这几个地址分别是API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite模型对话https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentchatutm_campaignrewrite如果你打算长期用 Claude Code 做编码或跑 Agent可以看下 Coding Plan入口是 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。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、OAuth5.1 401 Unauthorized最常见的是 Key 写错或没生效。检查~/.claude/settings.json里的ANTHROPIC_AUTH_TOKEN是否和 TaoToken 控制台里的一致注意不要有多余空格或换行。改完后要重新启动 claude环境变量是启动时读取的。5.2 local proxy failed这个报错通常和网络模式有关。如果你在 Windows 上开了代理类工具而 WSL 还是 NAT 模式就会出现 localhost 代理不通。回到第 2.3 节确认.wslconfig里networkingModemirrored和autoProxytrue都写了然后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 URLhttps://taotoken.net/api不要加多余路径API Keysk-你的Key控制台生成注意空格Model IDclaude-sonnet-4-20250514按文档可用模型填排查时按这个表逐项核对大部分连接问题都能定位到。6. 把通道固定下来后续换模型只改一个字段整套流程走完你得到的是一个可复制的本地环境WSL2 Ubuntu Node.js 20 Claude CodeAPI 通道统一指向 TaoToken。以后想换模型只需要改~/.claude/settings.json里的ANTHROPIC_MODEL一个字段Base URL 和 Key 都不用动。这对需要对比不同模型输出、或者团队里统一调用入口的场景很实用。如果你还没拿 Key先去 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成一个再对照 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里的接入说明确认参数格式。想先不写代码直接试模型效果可以用模型对话页面发一条消息看看返回。长期在终端里做编码和 Agent 任务的话Coding Plan 会比按量更省心入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。配置过程中如果卡在某个报错上优先回到第五节对照排查大部分问题都出在网络模式和 Key 格式这两处。