1. Windows 上跑 Claude Code 到底卡在哪Node.js、npm 与 PowerShell 执行策略很多人第一次在 Windows 上装 Claude Code卡住的地方往往不是 Claude Code 本身而是它依赖的那条链路Node.js 装没装对、npm 能不能在 PowerShell 里跑、脚本执行策略放不放行。这三个环节任意一个出问题你看到的报错都长得差不多——一串红字末尾跟着npm.ps1或者禁止运行脚本然后你就不知道该从哪下手了。Claude Code 是什么简单说它是 Anthropic 官方出的命令行编程助手能在终端里直接读你的项目文件、改代码、跑命令。适合谁适合习惯在终端里干活、想让 AI 直接操作本地代码库的开发者。它不是一个网页聊天框而是一个跑在你机器上的 CLI 工具所以对本地环境有要求。Windows 上的坑集中在三处。第一Node.js 版本太老Claude Code 要求 Node 18 以上最好直接上 LTS。第二PowerShell 默认的执行策略是Restricted意思是任何.ps1脚本都不让跑而 npm 在 Windows 上恰恰是通过npm.ps1来执行的于是你敲npm install就炸了。第三网络问题npm 默认源在国内访问经常超时装到一半断掉。我试过在一台全新的 Windows 11 上从零走一遍整个过程其实十分钟能搞定前提是你知道每一步在干什么。下面我按真实操作顺序拆开讲命令都可以直接复制。核心思路是先把 Node.js 和 npm 这条地基打稳再处理 PowerShell 的执行策略最后装 Claude Code 并配置好模型接入。每一步都有验证动作做完一步确认一步不要一口气全敲完再回头找错。这一节你先记住三个关键词Node.js 版本、PowerShell 执行策略、npm 源。后面所有报错基本都能归到这三类里。2. 装 Claude Code 前的地基Node.js LTS 与 npm 环境准备Claude Code 是 npm 包没有 Node.js 就没有 npm没有 npm 就装不了它。所以第一步永远是 Node.js。Windows 上装 Node.js 最省事的方式是用 winget这是 Windows 自带的包管理器Win10 较新版本和 Win11 都有。打开 PowerShell直接敲winget install OpenJS.NodeJS.LTS这条命令会拉取 Node.js 的 LTS 版本并安装。装完之后必须重新开一个 PowerShell 窗口因为环境变量是在新会话里才生效的。很多人装完在当前窗口敲node -v发现找不到命令就是没重开窗口。重开之后验证node -v npm -v正常的话会分别输出类似v20.x.x和10.x.x的版本号。如果node -v有输出但npm -v报错那大概率就是下一节要讲的 PowerShell 执行策略问题。如果你不想用 winget也可以去 Node.js 官网下.msi安装包一路下一步效果一样。winget 的好处是升级方便以后winget upgrade就能更新。Node.js 版本这块有个硬要求Claude Code 需要 Node 18 及以上。如果你机器上原本有个老版本 Node建议先卸掉再装 LTS避免多版本打架。用where.exe node可以看当前用的是哪个路径下的 node确认没有残留的旧版本。npm 源的问题也在这里一起处理。默认源registry.npmjs.org在国内访问不稳定装包时容易卡住或者超时。换成国内镜像npm config set registry https://registry.npmmirror.com验证换源成功npm config get registry输出应该是https://registry.npmmirror.com。这一步不是必须的如果你网络本来就通可以跳过。但如果你装 Claude Code 时卡在sill fetch或者超时回来换源基本能解决。到这里地基就打好了Node.js LTS 装好、npm 可用、源也换好了。接下来处理 Windows 上最容易绊倒人的那个报错。3. 可复制配置PowerShell 执行策略、Claude Code 安装与 settings.json这一节是全文的核心操作区包含三段可复制的配置PowerShell 执行策略、Claude Code 安装命令、以及 Claude Code 的 settings.json 配置文件。先说 PowerShell 执行策略。当你在 PowerShell 里敲npm install看到这样的报错npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1因为在此系统上禁止运行脚本。这不是 npm 坏了是 PowerShell 不让跑脚本。解决办法是改执行策略。以管理员身份打开 PowerShell先看当前策略Get-ExecutionPolicy如果返回Restricted就改成RemoteSignedSet-ExecutionPolicy RemoteSigned -Scope CurrentUserRemoteSigned的意思是本地写的脚本可以直接跑从网上下载的脚本需要有签名。对日常开发来说这个级别够用也比直接设成Unrestricted安全。-Scope CurrentUser表示只对当前用户生效不需要动系统级设置。改完再验证一次Get-ExecutionPolicy应该返回RemoteSigned。然后关掉管理员窗口用普通 PowerShell 继续。现在装 Claude Codenpm install -g anthropic-ai/claude-code-g是全局安装装完之后claude命令在任何目录都能用。装完验证claude --version有版本号输出就说明装好了。接下来是配置。Claude Code 的配置分两个文件位置都在你的用户目录下。第一个是.claude.json用来跳过首次引导。打开用户目录在 PowerShell 里敲echo $HOME能看到路径通常是C:\Users\你的用户名找到或新建.claude.json加上{ hasCompletedOnboarding: true }第二个是settings.json放在.claude目录下也就是C:\Users\你的用户名\.claude\settings.json。这个文件负责模型接入配置{ env: { ANTHROPIC_AUTH_TOKEN: sk-xxxxxxxxxxxxxxxx, ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_MODEL: claude-sonnet-4-5 } }这里三个字段要一起配齐缺一个都可能连不上。ANTHROPIC_AUTH_TOKEN是你的 API KeyANTHROPIC_BASE_URL是接口地址ANTHROPIC_MODEL指定用哪个模型。Key 的获取在 TaoToken 控制台里生成地址是 https://taotoken.net/api-keys 生成后复制进来替换掉sk-xxxxxxxxxxxxxxxx。如果你用的是 Claude Code 的 coding plan 场景Base URL 和 Key 的对应关系要确认清楚别把对话接口的 Key 填到 coding 接口上。TaoToken 的 coding plan 入口在 https://taotoken.net/coding-plan 里面有对应的接入说明。配置文件的目录结构长这样C:\Users\你的用户名\ ├── .claude.json └── .claude\ └── settings.json注意.claude.json在用户目录根下settings.json在.claude子目录里两个位置别搞混。这是最容易出错的地方之一。4. 验证请求从 claude 启动到成功返回结果配置写完怎么确认真的能跑通分三步验证。第一步重开一个 PowerShell 窗口敲claude如果配置正确你会看到 Claude Code 的交互界面启动而不是报错退出。如果它提示你登录或者走引导流程说明.claude.json里的hasCompletedOnboarding没生效检查一下文件路径和 JSON 格式JSON 里不能有多余的逗号。第二步在 Claude Code 界面里输入一句简单的话比如让它解释当前目录下的某个文件。这时候它会真正发起一次 API 请求。如果 Base URL、Key、Model 三个字段都对你会看到它开始读取文件并返回分析结果。第三步看返回内容是否正常。如果返回的是模型生成的文本说明整条链路通了PowerShell 能跑 claude 命令、Claude Code 能读到 settings.json、请求能打到 Base URL、Key 验证通过、模型正常响应。如果这一步失败报错信息会告诉你卡在哪。常见的几种401或authentication_errorKey 不对或者没填。检查ANTHROPIC_AUTH_TOKEN是不是完整的有没有多余空格。model not foundANTHROPIC_MODEL填的模型名不对。确认你用的接入方支持这个模型 ID。连接超时Base URL 写错了或者网络到不了。确认ANTHROPIC_BASE_URL是https://taotoken.net/api注意结尾不要多加斜杠。验证通过之后你就可以在任意项目目录下敲claude直接用了。它会以当前目录为工作区读文件、改代码都在这个范围内。有一点要提醒Claude Code 会实际修改你的文件第一次用建议在一个测试项目或者 git 仓库里跑改坏了能回滚。别一上来就在生产代码上让它大改。5. 本篇常见错排查npm.ps1 禁止运行、401、local proxy failed 与 reading choices这一节把 Windows 上装 Claude Code 最常撞到的几个报错集中过一遍每个都给定位思路和解决动作。报错一npm.ps1因为在此系统上禁止运行脚本这是最高频的。根因是 PowerShell 执行策略为Restricted。解决就是第 3 节里的Set-ExecutionPolicy RemoteSigned -Scope CurrentUser。注意要用管理员身份开 PowerShell 才能改。改完重开窗口。如果改完还报检查是不是改到了错误的 Scope用Get-ExecutionPolicy -List看各层级的策略。报错二401或invalid api keyKey 的问题。三种可能Key 复制时带了空格或换行Key 已经失效或被删Key 和 Base URL 不匹配比如拿 A 平台的 Key 去连 B 平台的地址。解决重新在 https://taotoken.net/api-keys 生成一个完整复制确认settings.json里ANTHROPIC_AUTH_TOKEN的值前后没有空格。JSON 文件里字符串要用英文双引号。报错三local proxy failed或连接被拒绝这个通常出现在你本地配了什么网络工具或者 Base URL 指向了一个本地端口但那个服务没起来。检查ANTHROPIC_BASE_URL是不是写成了http://localhost:xxxx之类。正常应该指向https://taotoken.net/api。如果你之前手动设过HTTP_PROXY/HTTPS_PROXY环境变量用echo $env:HTTPS_PROXY看一下有的话清掉Remove-Item Env:\HTTPS_PROXY -ErrorAction SilentlyContinue Remove-Item Env:\HTTP_PROXY -ErrorAction SilentlyContinue报错四reading choices或cannot read properties of undefined这类报错说明请求发出去了但返回的结构不是 Claude Code 期望的格式。常见原因是 Base URL 指向了一个 OpenAI 格式的接口而 Claude Code 要的是 Anthropic 格式。确认你的接入地址是 Anthropic 兼容的。TaoToken 的 API 地址https://taotoken.net/api是 Anthropic 兼容格式直接填这个。报错五OAuth相关或反复要求登录如果你看到 OAuth 登录提示说明 Claude Code 在走官方登录流程而不是用你配置的 Key。检查settings.json是否放在了正确位置C:\Users\你的用户名\.claude\settings.json以及 JSON 格式是否合法。可以用Get-Content $HOME\.claude\settings.json | ConvertFrom-Json验证 JSON 能不能解析报错就说明格式有问题。排查的通用思路先确认claude --version能跑说明安装没问题再确认settings.json能被解析说明配置没问题最后看请求报错的具体 HTTP 状态码说明接入有没有通。一层一层往下剥别跳步。6. 长期编码与 Agent 场景把 Claude Code 接进日常工作流装好只是开始真正省时间的是把它接进日常编码流程。Claude Code 的定位是终端里的编程 Agent它和编辑器里的补全插件不一样——它能跨文件操作、能跑命令、能根据你的描述改一整个模块。如果你打算长期用它做编码和 Agent 任务建议走 coding plan 这条路入口在 https://taotoken.net/coding-plan 。coding plan 针对的就是高频编码场景比按次调用更划算也更适合让 Claude Code 长时间挂着跑任务。日常用法上几个实用习惯在项目根目录启动claude它会以这个目录为工作区。让它改代码前先确保项目在 git 管理下改完git diff一眼就能看出它动了什么。让它跑测试、跑构建这类命令时它会实际执行所以别在敏感环境里放开权限。模型选择上settings.json里的ANTHROPIC_MODEL可以按任务换。复杂重构用能力强的模型简单改动用快的。换模型就是改这一个字段改完重开claude生效。如果你同时用多个接入方可以准备多份 settings 配置用的时候切换文件内容。但注意 Claude Code 读的是固定路径的settings.json所以切换靠改文件内容不是靠命令行参数。想先试试模型对话效果、确认接入没问题可以走 https://taotoken.net/models 这个入口先在对话界面里验证 Key 和模型可用再回到 Claude Code 里配。这样能把「接入问题」和「Claude Code 配置问题」分开排查省得两头猜。最后一句实在话Windows 上这套流程的难点从来不是 Claude Code 本身而是 Node.js、npm、PowerShell 这三样东西的默认状态不友好。把执行策略和源这两处一次性配好后面基本不会再被环境问题打断。配置文件和 Key 的管理入口都在 https://taotoken.net/api-keys 需要重新生成或查看用量时去那里。