1. Windows 上跑 Claude Code 为什么绕不开 WSL如果你在 Windows 上直接npm install -g anthropic-ai/claude-code大概率会在某个环节卡住要么是原生模块编译报错要么是路径分隔符把工具链搞晕要么是终端里中文乱码。Claude Code 这类 CLI 工具本质上是为类 Unix 环境设计的它依赖 shell 脚本、~/.bashrc这类配置文件、以及 POSIX 风格的路径处理。Windows 的 PowerShell 和 CMD 虽然也能跑 Node.js但遇到这些细节就容易出问题。WSLWindows Subsystem for Linux解决的正是这个矛盾你不需要装双系统也不用折腾虚拟机直接在 Windows 里得到一个完整的 Ubuntu 环境文件系统互通、终端原生支持、Node.js 生态跑起来和 Linux 服务器一模一样。对于想用 Claude Code 又不想离开 Windows 的人来说这是目前最省心的路径。这篇文章面向的是手上有 Windows 10/11 机器、想用 Claude Code 做日常编码辅助、但被环境问题劝退的开发者。我会从 WSL 安装开始一步步走到 Node.js 配置、Claude Code 初始化最后把 API 端点切到 TaoToken 统一通道完成连通性验证。整个过程不需要你懂 Linux 运维命令可以直接复制。核心检索词先明确Windows 下用 WSL 搭建 Claude Code本质是在 Windows 里创建一个隔离的 Linux 开发环境让 Claude Code 以它最舒服的方式运行同时通过配置 API 端点来控制成本和模型选择。为什么强调环境隔离与依赖冲突因为很多人在 Windows 上已经装了 Node.js、Python、各种全局包直接在上面再装 Claude Code很容易出现版本打架。WSL 给你一个干净的 Ubuntu里面从零开始配 Node.js和 Windows 侧的开发环境互不干扰。你 Windows 上的项目照样用 VS Code 打开WSL 里的 Claude Code 通过/mnt/c/访问同一批文件两边协作没有障碍。我试过在 Windows 原生环境硬扛 Claude Code最后卡在 node-gyp 编译上换到 WSL 后十分钟跑通。下面把完整流程拆开讲。2. TaoToken 前置准备拿 Key、选模型、认清 Base URL在动手装环境之前先把后端准备好。Claude Code 本身是个客户端它需要一个兼容 Anthropic API 协议的服务端来响应请求。TaoToken 提供的就是这样一个统一通道你用同一个 Base URL 和 Key就能调用包括 DeepSeek 系列在内的多种模型不用为每个模型单独配一套环境变量。第一步注册并获取 API Key打开 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册账号后进入控制台。在左侧菜单找到API Keys页面点新建 Key复制生成的字符串。这个 Key 就是后面配置里的ANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY。注意Key 只在创建时完整显示一次复制后先存到记事本或密码管理器里。如果你不小心关了页面只能重新建一个。第二步确认 Base URL 和模型 IDTaoToken 的 API 端点是https://taotoken.net/api注意这个地址不带 UTM 参数是纯 API 入口。在 Claude Code 的配置里ANTHROPIC_BASE_URL填这个值。模型 ID 方面TaoToken 控制台的模型列表里会显示可用模型。以 DeepSeek 系列为例常见的模型 ID 形如deepseek-chat、deepseek-reasoner等具体以你控制台看到的为准。Claude Code 通过ANTHROPIC_MODEL或CLAUDE_CODE_DEFAULT_MODEL来指定默认模型。第三步理解三个关键环境变量Claude Code 读取的配置主要来自三个环境变量变量名作用填什么ANTHROPIC_BASE_URLAPI 请求发往哪里https://taotoken.net/apiANTHROPIC_AUTH_TOKEN身份认证令牌你的 TaoToken API KeyANTHROPIC_MODEL默认使用的模型控制台里的模型 ID有些版本用ANTHROPIC_API_KEY而不是ANTHROPIC_AUTH_TOKEN两个都写上不冲突。配置文件方式里用ANTHROPIC_AUTH_TOKEN更稳。第四步想清楚你要走哪条路如果你只是偶尔用 Claude Code 问几个问题、改改小脚本用按量计费的 API Key 就够了。如果你打算长期用它做项目开发、跑 Agent 任务可以了解 TaoToken 的 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content它针对高频编码场景做了额度优化。前置准备就这些。接下来进 WSL 装环境。3. 可复制配置WSL Node.js Claude Code 全流程这一节是操作主体命令按顺序执行即可。我假设你用的是 Windows 10 版本 2004 以上或 Windows 11。3.1 一键安装 WSL 和 Ubuntu以管理员身份打开 PowerShell开始菜单搜索 PowerShell右键以管理员身份运行输入wsl --install这个命令会自动完成三件事启用 WSL 功能、启用虚拟机平台、下载并安装默认的 Ubuntu 发行版。执行完后重启电脑。重启后Ubuntu 会自动启动并让你设置用户名和密码。这个用户名密码是 Linux 环境里的和 Windows 账户无关记好就行。以后进入 WSL 有两种方式开始菜单搜索Ubuntu直接打开或者按Win R输入wsl回车。3.2 清理可能存在的旧环境如果你之前折腾过 Node.js 或 Claude Code先清一遍避免残留干扰sudo apt remove -y nodejs npm sudo rm -rf ~/.npm ~/.npm-global ~/.nvm ~/.claude-code sudo apt autoremove -y sudo apt clean第一次装的话执行这些也不会出错放心跑。3.3 安装 Node.js 18 以上版本Claude Code 要求 Node.js 18。用 NodeSource 官方源安装curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt install -y nodejs验证版本node -v npm -vnode -v应该输出v18.x.x或更高npm -v输出8.x.x以上。如果 node 版本低于 18检查一下是不是系统自带的旧版本没清干净。3.4 全局安装 Claude Codesudo npm install -g anthropic-ai/claude-code安装完成后验证claude-code --version有版本号输出就说明装好了。3.5 配置 TaoToken 通道环境变量方式编辑~/.bashrcnano ~/.bashrc在文件末尾添加以下内容把 Key 换成你自己的# TaoToken 统一通道配置 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENsk-你的TaoToken_API_Key export ANTHROPIC_API_KEYsk-你的TaoToken_API_Key export ANTHROPIC_MODELdeepseek-chat export CLAUDE_CODE_DEFAULT_MODELdeepseek-chat保存退出CtrlO回车然后CtrlX。让配置生效source ~/.bashrc3.6 配置文件方式备选和环境变量二选一如果环境变量方式不生效或者你想把配置集中管理用 settings.jsonmkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken_API_Key, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: deepseek-chat } } EOF注意 JSON 里不能有注释Key 和 URL 都要用双引号包起来。这个文件路径是~/.claude/settings.jsonClaude Code 启动时会自动读取。3.7 三件套对照表无论用哪种方式核心就三样东西缺一不可配置项环境变量名settings.json 字段值Base URLANTHROPIC_BASE_URLenv.ANTHROPIC_BASE_URLhttps://taotoken.net/apiKeyANTHROPIC_AUTH_TOKENenv.ANTHROPIC_AUTH_TOKEN你的 TaoToken KeyModel IDANTHROPIC_MODELenv.ANTHROPIC_MODEL控制台模型 ID这三样配对了Claude Code 就能把请求发到 TaoToken 并拿到模型响应。4. 验证请求启动 Claude Code 并确认模型连通配置写完后直接运行claude-code第一次启动可能会让你确认一些初始化选项按提示走就行。进入对话界面后输入你当前使用的模型是什么如果返回的内容里包含你配置的模型 ID比如deepseek-chat说明请求已经成功发到 TaoToken 并拿到了响应。再做一个更实际的验证——让它读一个文件请读取 /mnt/c/Users/你的用户名/Desktop/test.py 并解释这段代码WSL 里访问 Windows 文件通过/mnt/c/路径。如果它能正确读出文件内容并给出解释说明文件系统互通和 API 通道都正常。如果对话有响应但内容明显不对或者报错看下一节的排查。验证通过后你可以在 Windows 侧的 VS Code 里装 WSL 扩展然后code .在 WSL 终端里打开当前目录这样编辑器在 Windows、Claude Code 在 WSL两边操作同一批文件。5. 本篇常见错排查401、proxy failed、reading choices、OAuth这一节列的是实际配置中最容易撞上的几类报错对照着改。报错一401 Unauthorized / invalid api keyError: 401 {error:{message:Invalid API key provided}}原因通常是 Key 复制不完整、Key 前后有空格、或者环境变量没生效。排查步骤echo $ANTHROPIC_AUTH_TOKEN看看输出的 Key 和你复制的是否一致。如果为空说明source ~/.bashrc没执行或者写错了文件。如果 Key 末尾多了空格重新编辑~/.bashrc去掉。还有一种情况你同时配了环境变量和 settings.json两边 Key 不一致Claude Code 读了其中一个。建议只保留一种配置方式。报错二local proxy failed / connection refusedError: connect ECONNREFUSED 127.0.0.1:xxxx这个报错说明 Claude Code 试图走本地代理但代理没开或者端口不对。检查你的环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类设置env | grep -i proxy如果有且你不需要代理用unset HTTP_PROXY HTTPS_PROXY临时清掉或者去~/.bashrc里删掉对应行。另外确认ANTHROPIC_BASE_URL填的是https://taotoken.net/api没有多余路径。报错三reading choices / unexpected response formatError: Cannot read properties of undefined (reading choices)这个报错通常意味着 API 返回的 JSON 结构不符合 Claude Code 的预期。可能原因Base URL 填错了比如填成了 OpenAI 格式的端点或者模型 ID 不存在。检查ANTHROPIC_BASE_URL是否为https://taotoken.net/api以及ANTHROPIC_MODEL是否在 TaoToken 控制台的模型列表里。报错四OAuth / authentication flow 相关Error: OAuth token expired or invalid如果你之前登录过官方 Claude 账号本地可能残留了 OAuth 凭证。清理一下rm -rf ~/.claude/credentials.json rm -rf ~/.config/claude然后重新用 API Key 方式配置。Claude Code 优先读环境变量里的 Key但残留的 OAuth 文件有时会干扰。报错五command not found: claude-code安装完了但找不到命令。检查 npm 全局 bin 目录是否在 PATH 里npm config get prefix如果输出/usr或/usr/local确认/usr/bin在 PATH 中。或者直接用npx anthropic-ai/claude-code试试。实在不行重装一遍sudo npm install -g anthropic-ai/claude-code排查完这些基本能覆盖 90% 的配置问题。如果还有报错把完整错误信息复制下来对照检查 Base URL、Key、Model ID 三件套。6. 后续怎么用模型切换、成本控制与日常技巧环境跑通之后日常使用还有几个点值得注意。切换模型改~/.bashrc里的ANTHROPIC_MODEL值source ~/.bashrc后重启 Claude Code 即可。不同模型在代码理解和生成速度上有差异你可以根据任务类型切换。TaoToken 控制台里能看到各模型的可用状态。成本控制按量计费模式下每次对话消耗的 token 会计入账单。日常改小脚本、问语法问题消耗很低。如果要做大规模代码重构或长时间 Agent 任务可以关注 Coding Plan 的额度方案。在 TaoToken 控制台能看到用量明细。WSL 和 Windows 文件互通WSL 里访问 Windows 文件用/mnt/c/、/mnt/d/对应 C 盘、D 盘。反过来Windows 资源管理器地址栏输入\\wsl$可以访问 WSL 的文件系统。建议把项目放在 Windows 侧WSL 里通过/mnt/c/操作这样 VS Code 和 Claude Code 都能方便访问。每次进 WSL 都要重新配吗不用。写进~/.bashrc的环境变量每次打开终端自动生效。settings.json 方式也是持久的。想临时换 Key 测试直接在终端里export ANTHROPIC_AUTH_TOKENsk-新Key当前会话生效不影响配置文件。Claude Code 的常用命令在对话界面里输入/help能看到支持的命令列表/clear清空当前对话上下文/exit退出。这些在 WSL 终端里直接操作。最后说一个实际体验WSL 里的 Claude Code 响应速度和原生 Linux 服务器上基本一致文件读写通过/mnt/c/会有轻微延迟但日常编码感知不明显。如果你主要处理 Windows 侧的项目这个方案在便利性和环境纯净度之间平衡得不错。需要 Key 的话去 TaoToken 控制台建一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 有更详细的参数说明。想先试试模型效果可以直接用模型对话页面https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content发几条消息感受一下。
