1. Windows 上跑 Claude Code 到底卡在哪Node.js、npm 与 PowerShell 执行策略Claude Code 是 Anthropic 推出的终端 AI 编程助手它不是一个带界面的编辑器插件而是一个跑在命令行里的 Agent你在项目目录里敲claude它就能读文件、改代码、跑命令。对 Windows 用户来说第一次部署最容易卡住的不是模型本身而是三件事Node.js 版本不对、npm 全局目录没进 PATH、PowerShell 执行策略拦住了脚本。这篇就按“从零到跑通第一个对话请求”的顺序把每一步命令和验证动作都写清楚。先说清楚它适合谁如果你平时用 VS Code、WebStorm 或者干脆在 Windows Terminal 里写代码又想让 AI 直接操作你的工程目录那 Claude Code 就是为你准备的。它和网页版对话最大的区别是——它能真正落到文件系统上而不是只给你一段代码让你复制。我试过在一台干净的 Windows 11 上从零装踩过的坑集中在两处一是 Node 装成了 18 甚至更老的版本claude启动直接报语法错误二是npm install -g之后敲claude提示“不是内部或外部命令”本质是 npm 全局前缀目录没进环境变量。这两个问题下面都会给出可复制的排查命令。另外要提前说明一点Claude Code 默认走 Anthropic 官方通道国内直连体验不稳定。所以本文会用 TaoToken 的统一 Key 和 API 通道来接入把ANTHROPIC_BASE_URL指向统一入口这样你不需要改任何客户端代码只改环境变量就能跑通。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 。整条链路我拆成六段先讲问题场景再讲 TaoToken 前置准备然后是可直接复制的配置接着验证请求再列常见报错最后给分流入口。你可以按顺序跟做也可以直接跳到配置段。2. TaoToken 前置准备拿到统一 Key 与 API 通道在装 Claude Code 之前先把“通道”准备好否则装完客户端你会发现没有可用的 Key还得回头折腾。TaoToken 在这里扮演的角色是统一接入层它给你一个 Base URL 和一个 KeyClaude Code 通过环境变量读取这两个值就能把请求发到统一通道再由通道分发到具体模型。第一步是注册并创建 API Key。打开 https://taotoken.net/api-keys 登录后点创建复制那串以sk-开头的 Key。注意这个 Key 只在创建时完整显示一次建议先粘到记事本里备用。如果你还没账号从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 进官网注册即可。第二步是确认你要用的模型 ID。Claude Code 通过ANTHROPIC_MODEL环境变量指定模型这个值必须和通道侧支持的模型 ID 完全一致大小写、连字符都不能错。你可以在 https://taotoken.net/doc 的模型列表里查到当前可用的 ID。常见的写法类似claude-sonnet-4-5这种格式具体以文档为准。第三步是记下 Base URL。Claude Code 读取的是ANTHROPIC_BASE_URL这里填https://taotoken.net/api。注意不要带末尾斜杠也不要带/v1客户端会自己拼接路径。这一点很多人会搞错填成https://taotoken.net/api/v1之后请求就 404 了。提示Key、Base URL、Model ID 这三样东西建议先写在一个临时文本里后面配置环境变量时直接复制避免手打出错。尤其是 Key中间少一位就是 401。如果你后续还要用 Coding Plan 做长期编码或 Agent 任务可以在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 了解套餐只是想先验证模型能不能通用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 的对话页测一下也行。但本文的主线是本地 Claude Code所以先把 Key 拿到手就够了。这里强调一个原则不要把 Key 硬编码进任何提交到 Git 的文件里。环境变量是用户级别的只存在你本机注册表里相对安全。下面配置段会给出 PowerShell 写入用户级环境变量的完整命令。3. 可复制配置Node.js 20、npm 全局安装与用户级环境变量这一节是全文的核心所有命令都可以直接复制。顺序不能乱先装 Node.js再装 Claude Code最后写环境变量。3.1 安装 Node.js 20 LTSClaude Code 要求 Node.js 18 以上实测 20 LTS 最稳。去 https://nodejs.org/dist/v20.18.3/node-v20.18.3-x64.msi 下载这个 msi双击一路下一步。安装时保持默认勾选“Add to PATH”这样node和npm才能全局可用。装完打开一个新的 PowerShell 窗口一定要新开旧窗口读不到新 PATH执行node -v npm -v正常输出类似v20.18.3 10.8.2如果node -v报“不是内部或外部命令”说明 PATH 没生效重启一次终端或注销重登即可。如果版本低于 18卸载重装。3.2 调整 PowerShell 执行策略Windows 默认的 Restricted 策略会拦住 npm 的脚本导致安装时报无法加载文件 ... 因为在此系统上禁止运行脚本。用管理员身份打开 PowerShell执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser看到提示时输入Y确认。RemoteSigned的意思是本地脚本可跑、远程脚本需签名对日常开发足够也比Unrestricted安全。执行完可以用下面这条确认Get-ExecutionPolicy -Scope CurrentUser输出RemoteSigned就对了。3.3 全局安装 Claude Code回到普通 PowerShell 窗口执行npm install -g anthropic-ai/claude-code装完验证claude --version如果提示找不到命令先看 npm 全局前缀在哪npm config get prefix典型输出是C:\Users\你的用户名\AppData\Roaming\npm。把这个路径加进用户 PATH$npmPrefix npm config get prefix [Environment]::SetEnvironmentVariable(Path, $env:Path ; $npmPrefix, User)然后新开一个 PowerShell 再敲claude --version应该能输出版本号了。3.4 写入用户级环境变量这是接入 TaoToken 的关键一步。把下面三条里的 Key 和 Model ID 换成你自己的然后整段粘进 PowerShell 执行[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, sk-你的Key, User) [Environment]::SetEnvironmentVariable(ANTHROPIC_MODEL, 你的模型ID, User)User表示只对当前登录用户生效不需要管理员权限也不会污染系统级变量。写完之后必须重启 PowerShell因为环境变量是在进程启动时读取的旧窗口读不到新值。如果你更习惯用配置文件的方式Claude Code 也支持在用户目录下放settings.json。路径是C:\Users\你的用户名\.claude\settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: 你的模型ID } }两种方式二选一即可环境变量优先级更高。如果你同时用了 CC Switch 这类切换工具注意它管理的也是同一组变量别重复写冲突。注意ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY是两个不同的变量名Claude Code 读的是前者。填错变量名会直接 401这个坑很常见。4. 验证请求从 models 接口到第一个对话配置写完先别急着进项目目录用一条 HTTP 请求确认通道是通的。新开 PowerShell执行Invoke-RestMethod -Uri https://taotoken.net/api/v1/models -Headers {AuthorizationBearer sk-你的Key}如果返回一串 JSON里面有data数组和模型列表说明 Key 和 Base URL 都没问题。如果报 401回去检查 Key 有没有复制完整如果报 404检查 Base URL 是不是多写了/v1。通道确认后进任意一个代码项目目录敲cd D:\projects\demo claude第一次启动会进入交互界面你可以直接输入一句自然语言比如“看一下这个目录里有哪些文件帮我总结项目结构”。正常的话它会调用工具读取目录并返回结果。这一步跑通说明整条链路——Node.js、npm、环境变量、TaoToken 通道——全部打通。如果你想在非交互模式下快速测一次可以用管道输入用一句话解释这个项目是做什么的 | claude实测下来首次请求会有几秒延迟属于正常现象后续会快很多。如果长时间无响应多半是模型 ID 写错了通道找不到对应模型就会一直等。验证成功后建议把当前配置记下来Base URL、Key 前缀、Model ID。以后换机器或者重装系统照着第 3 节重跑一遍就行。如果你还想在浏览器里对比同一个模型的表现可以去 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 的对话页试试输入同样的 prompt看输出风格是否一致。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth这一节把最容易撞上的四类报错逐个拆开。你遇到问题时可以直接对号入座。401 Unauthorized。最常见的原因是 Key 没写对或变量名写错。先在 PowerShell 里确认变量真的写进去了[Environment]::GetEnvironmentVariable(ANTHROPIC_AUTH_TOKEN, User)如果输出为空说明写入失败或者你查的是另一个作用域。如果输出有值但请求仍 401检查 Key 是否被复制时带了空格或者 Key 已经过期。重新去 https://taotoken.net/api-keys 生成一个再试。local proxy failed / connection refused。这个报错通常出现在你把ANTHROPIC_BASE_URL指向了本地地址比如http://127.0.0.1:6006但本地并没有服务在跑。本文用的是统一通道https://taotoken.net/api正常不会出现这个错。如果你之前按别的教程配过本地代理先把变量改回来[Environment]::SetEnvironmentVariable(ANTHROPIC_BASE_URL, https://taotoken.net/api, User)然后重启终端。reading choices 或 undefined 报错。这类错误一般说明返回体结构和客户端预期不一致根源往往是 Base URL 填成了 OpenAI 兼容格式的地址而 Claude Code 走的是 Anthropic 格式。确认你的 Base URL 是https://taotoken.net/api不要带/v1/chat/completions这种后缀。OAuth 相关报错。Claude Code 某些版本会尝试走 OAuth 登录流程如果你已经用环境变量配了 Key它不应该再弹登录。如果仍然提示 OAuth检查是不是同时存在ANTHROPIC_API_KEY和ANTHROPIC_AUTH_TOKEN两个变量删掉多余的那个[Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, $null, User)再重启终端。排查时有一个通用动作每次改完环境变量一定新开 PowerShell 窗口。很多人改完直接在旧窗口重试结果报错没变以为没生效其实是进程读的还是旧值。另外如果你用了 Cline MCP 或 Codex 的auth.json注意它们各自有独立的配置文件Claude Code 不读那些文件别把 Key 写错地方。三件套永远是Base URL、Key、Model ID缺一不可。6. 后续怎么用模型对话、Coding Plan 与接入文档入口跑通第一个请求之后你大概率会想把它用在实际项目里。这里给几条实用建议。日常写代码时直接在项目根目录敲claude进入交互模式让它读文件、改代码、跑测试。它和编辑器不冲突你可以一边开着 VS Code 一边在终端里让它干活。如果只是临时问一个模型能力问题不想进项目目录用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 的对话页更快。如果你打算长期用 Claude Code 做编码或 Agent 任务建议看一下 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它针对高频编码场景做了额度优化比按次调用更划算。配置过程中如果遇到本文没覆盖的报错先去 https://taotoken.net/doc 查接入文档里面有针对 Claude Code 的专门章节。Key 管理在 https://taotoken.net/api-keys 随时可以新建或吊销。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 能看到调用量和余额。最后提醒一句环境变量里的 Key 不要截图发群、不要提交到 Git。如果怀疑泄露立刻去 API Keys 页面吊销重建然后更新本机变量。整条链路配好之后换项目、换目录都不需要重新配置直接cd过去敲claude就能用。