1. Windows11 装 Claude Code 前先把 Node.js 和 PowerShell 这两道坎迈过去Claude Code 是 Anthropic 推出的终端 AI 编程助手能直接在命令行里读代码、改文件、跑命令适合习惯用 PowerShell 或终端干活的开发者。它本身是个 npm 全局包所以 Windows11 上能不能跑通关键不在 Claude Code 本身而在两件事Node.js 版本对不对、PowerShell 执行策略放不放行。我见过太多人卡在claude : 无法加载文件或者npm.ps1 cannot be loaded这类报错上其实都不是 Claude Code 的问题是环境没铺好。这篇就按真实安装链路走一遍从 winget 装 Node.js LTS到 npm 全局装 Claude Code再到 PowerShell 执行策略调整、环境变量刷新、版本验证和登录状态确认。每一步都给可复制的命令和预期输出你照着敲就行。如果你之前装过 Node 但版本太老或者 PowerShell 一直报脚本被禁用这篇也能帮你把坑填平。核心检索词就三个Windows11、Claude Code、Node.js围绕它们把整条链路讲透。先说清楚适合谁看一是刚换 Windows11 想用终端 AI 助手的开发者二是 npm 全局包装了但命令找不到的人三是 PowerShell 一跑脚本就红字报错、想彻底搞明白执行策略的人。下面从原问题场景开始一步步往下走。2. 原问题与场景为什么 Windows11 上 Claude Code 总装不顺Windows11 和 macOS、Linux 最大的差别在于两套东西一是 Node.js 的安装来源杂winget、官网 msi、nvm-windows 都能装装完 PATH 还不一定刷新二是 PowerShell 默认执行策略是Restricted任何.ps1脚本都不让跑而 npm 全局安装的npm.ps1、claude.ps1恰恰就是脚本。这两点叠加就出现了「明明装好了却用不了」的经典现象。先看 Node.js 版本。Claude Code 官方要求 Node.js 18 及以上实测 LTS 20 或 22 最稳。如果你系统里是 Node 16 甚至更老npm install -g可能直接报 engine 不匹配或者装上了运行时报语法错误。所以第一步不是急着装 Claude Code而是确认node -v输出的是不是 v18。很多人node -v一看是 v16还以为是 Claude Code 的锅其实是 Node 太旧。再看 PowerShell 执行策略。Windows11 默认Get-ExecutionPolicy返回Restricted意思是「禁止运行任何脚本文件」。npm 在 Windows 上生成的全局命令是.ps1包装脚本你一敲claudePowerShell 就去加载claude.ps1结果被策略拦下报错长这样claude : 无法加载文件 C:\Users\你的用户名\AppData\Roaming\npm\claude.ps1 因为在此系统上禁止运行脚本。有关详细信息请参阅 about_Execution_Policies。这个报错跟 Claude Code 一点关系没有纯粹是 PowerShell 的安全策略。解决办法是把当前用户的执行策略改成RemoteSigned既能让本地脚本跑又保留从网络下载脚本的签名校验比直接Unrestricted安全。命令是Set-ExecutionPolicy -Scope CurrentUser RemoteSigned注意加-Scope CurrentUser不需要管理员权限也不会影响系统其他用户。还有一个高频坑是 PATH 没刷新。winget 装完 Node.js 后当前 PowerShell 会话的$env:Path还是旧的node -v可能提示找不到命令。这时候要么关掉重开 PowerShell要么手动刷新环境变量。手动刷新的命令后面会给能省一次重启终端的时间。场景理清了接下来进入 TaoToken 前置配置。Claude Code 默认连 Anthropic 官方接口国内直连不稳定用 TaoToken 这类兼容 Anthropic 协议的接入点会更顺配置方式在下一节展开。3. TaoToken 前置Base URL、Key、Model ID 三件套怎么配Claude Code 支持通过环境变量指定 API 接入点这样你就不用改它内部代码只要把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN两个变量设好它就会把请求发到你指定的地址。TaoToken 提供 Anthropic 兼容接口Base URL 是https://taotoken.net/apiKey 在控制台的 API Keys 页面生成。先说清楚三件套分别是什么这是后面所有配置的基础配置项值在哪拿Base URLhttps://taotoken.net/api固定直接填API Keysk-开头的一串控制台 API Keys 页面生成Model ID如claude-sonnet-4-5等模型列表里选填到 Claude Code 配置生成 Key 的入口在控制台进去后点 API Keys新建一个复制出来。注意 Key 只在创建时完整显示一次关掉页面就看不到了先存好。模型 ID 按你实际要用的填Claude Code 默认会用一个 Sonnet 系列模型你也可以在配置里指定。配置方式有两种一种是临时环境变量只对当前 PowerShell 会话生效适合先验证另一种是写进用户级环境变量永久生效。先给临时的方便你快速试$env:ANTHROPIC_BASE_URL https://taotoken.net/api $env:ANTHROPIC_AUTH_TOKEN sk-你的Key这两行敲完当前窗口里再跑claude它就会走 TaoToken 的接口。缺点是关掉窗口就没了下次还得重设。要永久生效用setx写进用户环境变量setx ANTHROPIC_BASE_URL https://taotoken.net/api setx ANTHROPIC_AUTH_TOKEN sk-你的Keysetx写完后当前会话不会立即生效需要新开一个 PowerShell 窗口或者手动刷新环境变量下一节给命令。这里有个细节setx有长度限制Key 太长一般也没问题但如果遇到截断改用系统属性面板里的「环境变量」图形界面添加更稳。如果你用的是 Claude Code 的配置文件方式也可以在用户目录下建settings.json路径是C:\Users\你的用户名\.claude\settings.json内容如下{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key } }这个 JSON 片段里的路径和字段名要跟原文一致env下面放两个变量Claude Code 启动时会读取。用配置文件的好处是不依赖系统环境变量换机器时把文件拷过去就行。注意 JSON 不能有注释末尾不能有多余逗号否则解析失败。配好之后Claude Code 发出的请求就会带上你的 Key走 TaoToken 的接口。这一步是整个链路里最容易被忽略的很多人装完 Claude Code 直接跑结果卡在登录或网络超时其实就是没配 Base URL。三件套齐了下一节进入可复制的完整安装配置流程。4. 可复制配置从 winget 装 Node.js 到 claude 跑通这一节是全文的核心操作区按顺序敲每步都给验证命令和预期输出。全程在 PowerShell 里操作不需要管理员权限除了个别系统级改动这里都用用户级。4.1 用 winget 安装 Node.js LTSWindows11 自带 winget直接用它装最省事。打开 PowerShell敲winget install OpenJS.NodeJS.LTSwinget 会下载并安装 Node.js LTS 版本过程中可能弹 UAC 授权点允许。装完后当前会话的 PATH 不会自动刷新所以node -v可能还找不到命令。手动刷新一下$env:Path [System.Environment]::GetEnvironmentVariable(Path,Machine) ; [System.Environment]::GetEnvironmentVariable(Path,User)这行把机器级和用户级的 PATH 重新拼进当前会话省得关窗口重开。刷新后验证node -v npm -v预期输出类似v20.18.0和10.8.2版本号不用完全一样Node 是 v18 以上就行。如果node -v还是报找不到说明 winget 装的位置没进 PATH可以重开一个 PowerShell 窗口再试或者去C:\Program Files\nodejs\确认 node.exe 在不在。4.2 npm 全局安装 Claude CodeNode 就绪后装 Claude Codenpm install -g anthropic-ai/claude-code-g是全局安装装完claude命令会进 npm 的全局 bin 目录Windows 上一般是C:\Users\你的用户名\AppData\Roaming\npm。这个目录通常已经在 PATH 里如果不在后面验证时会报找不到命令那时再手动加。安装过程会拉包网速正常的话一两分钟。装完先别急着跑claude因为 PowerShell 执行策略可能拦.ps1。先验证版本claude --version如果这一步直接输出了版本号比如1.0.xx说明执行策略没问题可以跳到 4.4。如果报「无法加载文件……禁止运行脚本」就进 4.3 调整策略。4.3 调整 PowerShell 执行策略查看当前策略Get-ExecutionPolicy -List你会看到几行CurrentUser那行大概率是Undefined或Restricted。改成RemoteSignedSet-ExecutionPolicy -Scope CurrentUser RemoteSigned会提示确认输入Y回车。这个改动只影响当前用户不需要管理员权限也不会动系统级策略。改完再查一次确认Get-ExecutionPolicy -Scope CurrentUser输出RemoteSigned就对了。然后重新验证claude --version这次应该能正常输出版本号。RemoteSigned的含义是本地写的脚本可以直接跑从网络下载的脚本必须有签名。npm 装的.ps1属于本地生成所以放行安全性比Unrestricted好。4.4 配置 TaoToken 三件套并验证登录状态按第 3 节的方式设好环境变量临时或永久都行。设完新开窗口或刷新 PATH然后跑claude第一次跑会进入交互界面可能提示你选择主题或确认一些设置。如果 Base URL 和 Key 配对了它会直接进入对话状态不会卡在登录页。你可以敲一句你好测试能正常回复就说明链路通了。验证登录状态还有个办法看 Claude Code 启动时有没有报 401。如果报401 Unauthorized说明 Key 不对或没生效如果报连接超时说明 Base URL 没配或网络不通。这两个报错在下一节详细排。到这里从 Node.js 到 Claude Code 再到 TaoToken 接入整条链路就跑通了。整个过程最花时间的其实是 PowerShell 执行策略那一步很多人不知道.ps1被拦以为是安装失败。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 逐条对装 Claude Code 过程中会碰到几类典型报错这里按真实错误信息逐条给排查思路。你遇到哪个就翻哪个。5.1 401 Unauthorized报错长这样API Error: 401 Unauthorized原因就两个Key 没配、Key 配错。先确认环境变量在当前会话里生效echo $env:ANTHROPIC_AUTH_TOKEN如果输出为空说明变量没设上或者设了但没刷新会话。用setx设的要新开窗口。如果输出有值但还报 401检查 Key 是不是复制时带了空格或者 Key 已经失效。去控制台重新生成一个替换掉再试。还有一种情况是 Base URL 配成了官方地址但 Key 是 TaoToken 的两边对不上也会 401确认ANTHROPIC_BASE_URL是https://taotoken.net/api。5.2 local proxy failed报错类似Error: local proxy failed to start这个通常跟本地网络环境有关Claude Code 启动时会尝试建立本地连接。排查顺序先确认没有其他程序占用端口再确认系统代理设置没有干扰。如果你之前设过系统级代理Claude Code 可能会走代理导致失败。检查环境变量里有没有HTTP_PROXY、HTTPS_PROXYecho $env:HTTP_PROXY echo $env:HTTPS_PROXY有值的话临时清掉Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue再跑claude试试。另外确认 Base URL 拼写正确多了斜杠或少了https都可能导致连接异常。5.3 reading choices 相关报错报错里带reading choices或类似字段读取失败一般是接口返回格式跟 Claude Code 预期不一致。Claude Code 走的是 Anthropic 协议如果你把 Base URL 指到了一个 OpenAI 格式的接口返回体里是choices字段而不是 Anthropic 的content就会报这个。确认你用的是 Anthropic 兼容接入点TaoToken 的https://taotoken.net/api是兼容 Anthropic 的别填成 OpenAI 格式的地址。模型 ID 也要填对填了个不存在的模型接口可能返回错误结构同样触发这类报错。5.4 OAuth 相关提示如果启动时提示 OAuth 登录或跳转浏览器授权说明 Claude Code 没读到你的ANTHROPIC_AUTH_TOKEN走了默认的 OAuth 流程。这时候别去点授权先退出来检查环境变量。OAuth 是官方账号的登录方式你用 Key 接入就不需要它。确认ANTHROPIC_AUTH_TOKEN和ANTHROPIC_BASE_URL都设了再重新跑claude。如果配置文件和环境变量同时存在以配置文件为准检查settings.json里的字段有没有写错。5.5 claude 命令找不到报错claude : 无法将“claude”项识别为 cmdlet、函数、脚本文件或可运行程序的名称这是 PATH 问题。npm 全局 bin 目录没进 PATH。先找目录npm config get prefix输出一般是C:\Users\你的用户名\AppData\Roaming\npm。把这个路径加进用户 PATHsetx PATH $env:PATH;C:\Users\你的用户名\AppData\Roaming\npm注意setx会覆盖别把原有 PATH 弄丢上面这行是先读当前再追加。更稳的做法是用图形界面「环境变量」编辑手动加一行。加完新开窗口验证。5.6 版本验证与登录状态确认清单排完错用这几条命令做最终确认node -v npm -v claude --version echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN前三条输出正常版本号后两条输出 TaoToken 地址和你的 KeyKey 会明文显示注意别截图外发。都对了跑claude进交互界面发一句话能回复就彻底通了。6. 跑通之后把 Claude Code 用起来的几个实际建议装好只是开始真正用起来还有几个细节值得注意。第一Claude Code 在项目目录里跑效果最好它会读取当前目录的代码上下文所以进项目文件夹再敲claude别在用户根目录跑。第二长任务建议配合 Coding Plan 这类套餐用按量计费在频繁调用时更划算具体入口在控制台的 Coding Plan 页面。第三模型 ID 可以按任务切换写代码用 Sonnet 系列简单问答用更轻的模型成本能降下来。如果你还想验证模型对话效果可以先用模型对话页面测一下接口通不通确认 Key 和 Base URL 没问题再回到终端跑 Claude Code这样排错更直观。接入文档里有完整的参数说明和示例遇到不确定的字段去那里查。最后提醒一句环境变量里的 Key 是敏感信息别提交到 Git 仓库也别写进会分享的脚本里。用settings.json配置的话记得把.claude目录加进.gitignore。整套流程走下来Windows11 上跑 Claude Code 并不复杂难的是那几个报错背后的原因搞明白了下次换机器十分钟就能重装一遍。