1. Windows 上跑 Claude Code为什么总卡在“模型接不进来”Claude Code 本身是个命令行里的编码代理能读你项目里的文件、改代码、跑命令适合谁适合已经在用 Windows 做开发、想让它帮忙重构或补测试的人。但很多人第一次装完就发现默认它只认官方通道想换成第三方大模型环境变量、配置文件、PowerShell 脚本三处对不上命令敲下去要么报 401要么直接超时。我试过在 Windows 上把 Claude Code 接到第三方大模型踩过的坑集中在三点一是 PowerShell 里$env:变量只在当前窗口生效关掉就没了二是settings.json的字段名写错一个字母插件就静默忽略三是 base URL 末尾多一个斜杠请求直接 404。这篇就把这条链路拆开用 TaoToken 做统一 Key 和 API 通道给你一份能直接复制的settings.json骨架再配一个 PowerShell 包装脚本目标是配置一次就能稳定调用。TaoToken 在这里的角色是“统一入口”你不需要为每个模型单独记一套 Key 和地址拿到一个 Key改ANTHROPIC_BASE_URL指向它的 API 通道Claude Code 就以为自己在跟原来的服务说话。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意这个不带 UTM 后缀配置里要写干净的。2. 前置准备Node、Claude Code 与 TaoToken Key2.1 确认 Node 和 npm 可用Claude Code 通过 npm 分发Windows 上建议用 Node 18 以上。打开 PowerShell先验证node -v npm -v如果node不是内部命令去 Node 官网下 LTS 版安装包装完重开一个 PowerShell 窗口。别在旧窗口里试PATH 不会刷新。2.2 单独目录安装 Claude Code不建议全局装因为后面要给它配独立配置目录隔离更干净。新建一个工作目录比如D:\claude-modelmkdir D:\claude-model cd D:\claude-model npm init -y npm install anthropic-ai/claude-code装完后可执行文件在D:\claude-model\node_modules\.bin\claude.ps1这个路径后面脚本里要用先记下来。2.3 拿 TaoToken 的 Key打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来。这个 Key 就是后面ANTHROPIC_AUTH_TOKEN的值。同时确认你的 API 通道地址是https://taotoken.net/api不要自己加/v1之类的后缀通道内部会处理。注意Key 只显示一次复制后先存到密码管理器别直接贴在聊天窗口里。3. 可复制的 settings.json 骨架与 PowerShell 包装脚本3.1 建两个子目录在D:\claude-model下建配置目录和脚本目录mkdir D:\claude-model\.claude-taotoken mkdir D:\claude-model\bin.claude-taotoken用来放这个通道专属的配置和缓存bin放包装脚本。3.2 写 PowerShell 包装脚本在D:\claude-model\bin下新建claude-taotoken.ps1内容如下# Wrapper for Claude Code CLI using TaoToken unified API $CLAUDE_BIN D:\claude-model\node_modules\.bin\claude.ps1 # 注入 TaoToken 认证信息 $env:ANTHROPIC_AUTH_TOKEN 你的 TaoToken API Key $env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 1 $env:API_TIMEOUT_MS 3000000 # 独立配置目录避免和官方通道互相覆盖 $env:CLAUDE_CONFIG_DIR D:\claude-model\.claude-taotoken # 转发命令给 claude CLI $CLAUDE_BIN args把你的 TaoToken API Key换成第 2.3 步复制的值$CLAUDE_BIN和$CLAUDE_CONFIG_DIR换成你自己的实际路径。路径里有空格要加引号这里没有空格所以直接写。3.3 把 bin 加进 PATH临时生效当前窗口$env:Path ;D:\claude-model\bin永久生效用户级[Environment]::SetEnvironmentVariable( Path, [Environment]::GetEnvironmentVariable(Path, User) ;D:\claude-model\bin, User )改完重开 PowerShell敲claude-taotoken --version能出版本号就说明脚本被找到了。3.4 VS Code 插件的 settings.json 骨架如果你在 VS Code 终端里用 Claude Code插件会读它自己的环境变量设置。打开命令面板搜Preferences: Open User Settings (JSON)在settings.json里加这一段claudeCode.environmentVariables: [ { name: ANTHROPIC_AUTH_TOKEN, value: 你的 TaoToken API Key }, { name: ANTHROPIC_BASE_URL, value: https://taotoken.net/api }, { name: API_TIMEOUT_MS, value: 3000000 }, { name: CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, value: 1 } ]字段名对照表方便你核对字段作用常见写错ANTHROPIC_AUTH_TOKEN认证 Key写成 ANTHROPIC_API_KEYANTHROPIC_BASE_URLAPI 通道地址末尾多加/API_TIMEOUT_MS超时毫秒写成秒数CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC关掉非必要流量TRAFFIC 拼成 TRAFFIC 以外的形式注意CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC这个变量名在部分旧教程里被拼错插件会静默忽略配置完没反应先回来查这一行。4. 验证请求从 --version 到一次真实对话4.1 先验证脚本能跑claude-taotoken --version输出类似1.x.x (Claude Code)就说明包装脚本转发成功。如果报“无法加载文件因为在此系统上禁止运行脚本”是 PowerShell 执行策略拦的用管理员身份跑一次Set-ExecutionPolicy -Scope CurrentUser RemoteSigned4.2 发一次真实请求进一个你有代码的项目目录比如D:\my-project然后cd D:\my-project claude-taotoken 用一句话说明这个目录里 package.json 的 name 字段是什么正常情况它会读文件、返回答案。这一步能过说明 Key、base URL、超时三个环节都通了。如果卡住不动等 10 秒左右API_TIMEOUT_MS设的是 3000000 毫秒不会那么快断。4.3 确认走的是 TaoToken 通道在项目里让它做一件需要多轮的事比如claude-taotoken 列出当前目录所有 .js 文件并统计行数观察它是否正常调用工具、返回结果。如果返回 401去 https://taotoken.net/api-keys 确认 Key 没过期如果返回 404检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api/多了斜杠。4.4 长期编码场景的入口如果你打算把 Claude Code 当日常编码代理用跑长任务、多轮改代码可以了解下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它和按量 Key 是两条路按你的使用频率选。5. 本篇常见错排查5.1 报 401 Unauthorized九成是 Key 的问题。先确认ANTHROPIC_AUTH_TOKEN的值没有多余空格PowerShell 里复制粘贴容易带上换行。再确认 Key 在 https://taotoken.net/api-keys 里状态正常。如果 VS Code 插件和命令行同时配了注意插件读的是settings.json命令行读的是包装脚本两边 Key 要一致。5.2 报 404 或连接被拒检查ANTHROPIC_BASE_URL。正确值是https://taotoken.net/api不要加/v1、不要加末尾斜杠。有些教程让你写https://taotoken.net/api/anthropic那是别的通道格式这里不适用。5.3 命令找不到 claude-taotokenPATH 没生效。先确认D:\claude-model\bin真的在 PATH 里$env:Path -split ; | Select-String claude-model没有输出就回到 3.3 重新设。设完必须重开窗口旧窗口的 PATH 是快照。5.4 插件里没反应命令行正常VS Code 插件的环境变量设置项名字可能随版本变。打开命令面板搜Claude Code: Environment Variables点进去看它跳转到settings.json的哪个位置把 3.4 的骨架贴到那个位置别自己另起一个顶层键。5.5 超时或请求中断API_TIMEOUT_MS设大一点3000000 是 50 分钟够长任务用。如果还是断检查网络是否稳定以及是否开了会改本地代理的工具——这类工具会改HTTP_PROXY之类的变量导致请求走错路。把相关环境变量清掉再试Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue6. 配置完之后的日常用法与入口配好之后日常就两条命令claude走官方通道claude-taotoken走 TaoToken 通道互不干扰。VS Code 里则靠settings.json那段环境变量插件启动时自动读。如果你还想在网页里直接对比不同模型的表现可以用模型对话入口https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 同一个 Key 就能开聊不用再配一遍。接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 字段有变动以文档为准。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 用量和 Key 管理都在里面。最后留一个我自己的习惯把claude-taotoken.ps1里的 Key 换成从系统环境变量读而不是硬编码在脚本里。这样脚本可以进 GitKey 留在本机$env:ANTHROPIC_AUTH_TOKEN $env:TAOTOKEN_API_KEY然后在系统环境变量里设TAOTOKEN_API_KEY。多一步但脚本能复用换机器时只改环境变量就行。