1. Windows 上跑 Claude Code 到底卡在哪node.js、npm 与环境变量全流程拆解很多人第一次在 Windows 上装 Claude Code卡住的地方往往不是 Claude Code 本身而是它背后依赖的 node.js、npm 和环境变量。Claude Code 是一个跑在终端里的 AI 编码助手能读你的项目文件、执行命令、改代码适合习惯命令行、想让 AI 直接参与工程开发的开发者。它本身是个 npm 全局包所以你的 Windows 机器上必须先有一套能正常工作的 Node.js 运行环境否则npm install -g这一步就会直接失败。我见过太多人在这条链路上翻车node 装完了但npm -v报错、全局包装上了但命令行找不到claude、环境变量配了但新开的终端读不到、Git Bash 路径没设导致 Claude Code 启动就退出。这些问题看起来零散其实都指向同一件事——Windows 的环境变量和 npm 全局路径没有理顺。这篇就按真实操作顺序走一遍先装 node.js 和 npm再配 npm 全局目录和环境变量然后装 Claude Code接着把模型接入的 Base URL 和 Key 配好最后逐项验证并排查常见报错。每一步都给可复制的命令和明确的验证动作你照着做就能在本地把 Claude Code 跑通。下面先从最基础的环境准备开始。2. 装 node.js 与 npm 并配好环境变量Windows 从零搭建 Claude Code 运行环境2.1 安装 node.js顺带把 npm 带进来去 nodejs 官网下载 Windows 安装包选 LTS 长期支持版即可。双击安装一路默认下一步安装程序会自动把 node 和 npm 一起装好npm 是随 node 附带的包管理器不需要单独装。装完后按Win R输入cmd回车打开命令行窗口分别执行node -v npm -v正常会输出类似v20.11.0和10.2.4的版本号。如果这里就报「不是内部或外部命令」说明安装时没勾选加入 PATH重新跑一遍安装包在自定义步骤里确认勾上「Add to PATH」。2.2 给 npm 配全局目录避免全局包找不到npm 默认把全局包装到用户目录下但很多教程和实际项目会期望一个明确的全局路径。不配的话运行某些 js 程序时可能报找不到包。做法是先在 Node.js 安装目录下新建两个文件夹node_global和node_cache。然后在 cmd 里执行路径换成你自己的安装目录npm config set prefix C:\Program Files\nodejs\node_global npm config set cache C:\Program Files\nodejs\node_cache npm config set registry https://registry.npmmirror.comregistry 换成国内镜像装包速度会快很多。执行完可以用npm config get prefix确认路径生效。2.3 配置系统环境变量右键「此电脑」→ 属性 → 高级系统设置 → 环境变量。在系统变量里新增NODE_PATH值指向 node_modules 目录NODE_PATH C:\Program Files\nodejs\node_modules再编辑系统变量Path新增一行指向刚才的全局目录C:\Program Files\nodejs\node_global这样全局安装的命令行工具才能被系统找到。改完环境变量后必须关掉所有已打开的 cmd、PowerShell、VSCode 窗口再重新打开否则读到的还是旧配置。2.4 装 Git 并配置 Claude Code 需要的 bash 路径Claude Code 在 Windows 上依赖 Git Bash 来执行部分 shell 操作所以要先装 Git for Windows。装完后新增一个系统变量指向 bash.exeCLAUDE_CODE_GIT_BASH_PATH C:\Program Files\Git\bin\bash.exe路径按你实际安装位置调整。这一步不做Claude Code 启动时可能直接报错退出。3. 安装 Claude Code 并接入模型Base URL、Key 与 Model ID 三件套配置3.1 全局安装 Claude Code环境准备好后在 cmd 里执行npm install -g anthropic-ai/claude-code claude --version能打印出版本号就说明安装成功。如果报权限错误用管理员身份打开 cmd 再试一次。3.2 配置模型接入的三件套Claude Code 要真正干活需要指向一个可用的模型服务。这里用 TaoToken 提供的接入方式它兼容 Anthropic 接口协议配置起来很直接。你需要准备三样东西Base URL、API Key、Model ID。在系统环境变量里新增ANTHROPIC_BASE_URL https://taotoken.net/api ANTHROPIC_AUTH_TOKEN 你的 API KeyAPI Key 在 TaoToken 控制台的 API Keys 页面生成地址是 https://taotoken.net/api-keys 。Model ID 在 Claude Code 里通过启动参数或配置文件指定常用的是 Claude 系列模型标识。如果你用的是 Claude Code 的 settings 配置文件可以在项目或用户目录下建.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的 API Key } }配完同样要重开终端让环境变量生效。想先确认模型能不能正常对话可以到模型对话页面直接试一条消息地址 https://taotoken.net/models 比在终端里盲调更快定位问题。3.3 启动并跑通第一个请求进入你的项目目录在 cmd 或 terminal 里输入claude首次启动会引导你做一些初始化选择一路回车按提示走即可。进入交互界面后输入一句「帮我看看当前目录有哪些文件」如果模型能正常返回内容说明整条链路已经通了。4. 验证请求是否成功从版本号到模型响应的逐项检查装完不等于跑通得逐项验证。第一步确认 node 和 npmnode -v npm -v npm config get prefix第二步确认 Claude Code 本体claude --version where claudewhere claude应该指向你配的 node_global 目录如果指向别的地方说明 PATH 里有旧的全局路径需要清理。第三步确认环境变量被读到。在 cmd 里执行echo %ANTHROPIC_BASE_URL% echo %ANTHROPIC_AUTH_TOKEN%能打印出你配的值就对了。如果打印的是%ANTHROPIC_BASE_URL%原样说明变量没生效多半是没重开终端。第四步做一次真实请求。启动claude后发一条简单指令观察返回。成功的话你会看到模型流式输出的回答失败的话终端会给出错误码下一节专门对照排查。一个容易被忽略的点VSCode 内置终端有时会缓存旧的环境变量改完配置后建议完全退出 VSCode 再打开而不是只关终端面板。5. 常见报错逐条排查401、local proxy failed、reading choices 与 OAuth 问题401 Unauthorized最常见基本是 API Key 不对或没生效。先echo %ANTHROPIC_AUTH_TOKEN%确认值存在再去 TaoToken 控制台确认这个 Key 还有效、没被删。注意 Key 前后不要有多余空格复制时容易带上换行。local proxy failed / connection error终端连不上 Base URL。检查ANTHROPIC_BASE_URL是不是写成了https://taotoken.net/api末尾不要多加斜杠或路径。如果公司网络有代理设置确认终端能正常访问外网接口。reading choices 相关报错这类通常出现在返回体解析阶段多半是 Base URL 指错了端点或者模型返回了非预期格式。确认你用的是兼容 Anthropic 协议的地址而不是 OpenAI 格式的端点。OAuth / 登录相关报错Claude Code 某些版本会尝试走账号登录流程。如果你用的是 API Key 方式接入确保ANTHROPIC_AUTH_TOKEN已设置它会优先走 token 认证避免触发登录流程。claude 命令找不到where claude没结果说明 node_global 没进 PATH或者装包时 prefix 没配对。重新检查第 2.3 节的环境变量。启动即退出、报 bash 相关错误CLAUDE_CODE_GIT_BASH_PATH没配或路径写错。确认 bash.exe 真实存在路径里不要有中文歧义字符。排查时有个通用思路先确认命令能不能找到再确认环境变量能不能读到最后确认网络请求能不能通。三层依次过一遍绝大多数问题都能定位。6. 把 Claude Code 用起来长期编码与 Agent 场景的接入建议环境跑通只是起点。如果你打算把 Claude Code 当成日常编码和 Agent 任务的常驻工具建议把接入配置固化下来而不是每次手动设环境变量。用.claude/settings.json管理 Base URL 和 Key团队协作时也方便统一。对于需要长时间跑编码任务、频繁调用模型的场景可以了解下 Coding Plan 这类方案地址 https://taotoken.net/coding-plan 它在持续调用上更省心。日常调试模型能力、验证某条 prompt 效果直接用模型对话页面最快https://taotoken.net/models 。需要管理多个 Key 或查看用量去控制台 https://taotoken.net/console 。完整的接入文档在 https://taotoken.net/doc 遇到接口细节问题可以对照查。最后提醒一句Windows 上环境变量改动后重开终端这个动作能省掉你一半的「明明配了却不生效」的困惑。把这一步养成习惯后面接入任何命令行 AI 工具都会顺很多。