1. Windows 上装 Claude Code为什么先要搞定 nvm 和 git bashClaude Code 是 Anthropic 推出的终端 AI 编程助手能在命令行里直接读写项目文件、跑命令、改代码适合习惯在终端里干活的开发者。但它在 Windows 上有个硬性前提需要一个类 Unix 的 shell 环境也就是 Git Bash。同时它本身是 Node.js 写的得靠 npm 全局安装。这两个条件缺一个装完要么跑不起来要么一执行就报错。很多人第一次装 Claude Code 卡住不是卡在 Claude Code 本身而是卡在 Node 版本混乱和 Git Bash 路径没配。Windows 上如果直接去官网下 Node.js 安装包一台机器只能留一个版本后面想切到别的版本就得卸载重装项目一多非常难受。nvmNode Version Manager就是来解决这个问题的它让你同时装多个 Node 版本一条命令来回切还避开了全局 npm 权限混乱的坑。这篇记录按我实际跑通的顺序来先装 nvm用它装并切换 Node配好 npm 源再装 Git 配好 Git Bash 路径最后装 Claude Code 并验证能用。每一步都给可复制的命令和检查动作你照着走一遍基本能一次跑通。适合刚接触 Claude Code、Node 环境还没理顺的 Windows 用户。2. 前置准备nvm、Node、npm、Git Bash 各是什么关系动手前先把几个名词理清不然后面命令容易懵。Node.js 是基于 Chrome V8 引擎的 JavaScript 运行时让 JS 能脱离浏览器在终端跑。Claude Code 就依赖它。nvm 是 Node 版本管理器负责装多个 Node 版本并切换。它本身要先装装完才能用它装 Node。npm 是 Node 自带的包管理器用来下载安装依赖包Claude Code 就是通过npm install -g全局装的。npx 是临时执行包的工具和 npm 的区别是 npm 会把包持久装到 node_modules 或全局占硬盘npx 跑完可以不保留。Git Bash 是 Git for Windows 自带的一个轻量 Unix 环境基于 MSYS2里面有 bash.exe。Claude Code 内部很多逻辑会调用 Linux 风格的 .sh 脚本需要这个 bash.exe 来翻译执行所以 Windows 上必须配。名词作用和 Claude Code 的关系Node.jsJS 运行时Claude Code 的运行基础nvm管理多个 Node 版本解决版本切换和权限问题npm包管理器用来全局安装 Claude CodeGit Bash类 Unix shell 环境Claude Code 在 Windows 上必需理清这层关系后顺序就明确了nvm → Node → npm 源 → Git Bash → Claude Code。3. 可复制配置nvm 安装、Node 切换、npm 源与 Git Bash 路径3.1 安装 nvm去 nvm 的 Windows 版本发布页下载安装包搜 nvm-windows 即可找到一路下一步装完。装完后关掉当前终端重新开一个让环境变量生效。验证nvm version能打印出版本号就说明 nvm 可用了。如果提示找不到命令多半是终端没重启或者安装时没勾选加入 PATH。3.2 用 nvm 装 Node 并切换先看有哪些版本可装nvm list available挑一个稳定版安装比如 20.17.0nvm install 20.17.0装完切换到这个版本nvm use 20.17.0查看已安装的版本列表确认当前用的是哪个nvm ls再验证 Node 和 npm 都跟着切过来了node -v npm -v这里有个容易踩的点nvm use只对当前终端会话生效新开终端可能回到默认版本。如果你希望固定可以用nvm use 20.17.0后确认或者设置默认版本。切换后node -v和npm -v输出的版本要对得上不然说明 PATH 里还有别的 Node 残留。3.3 配置 npm 源默认 npm 源在国内拉包可能慢换成国内镜像会顺很多npm config set registry https://registry.npmmirror.com验证是否生效npm config get registry输出你刚设的地址就对了。这一步不是必须但装 Claude Code 这种全局包时能明显省时间。3.4 安装 Git 并配置 Git Bash 路径如果机器上还没有 Git去 Git for Windows 官网下载安装。装完后找到 bash.exe 的位置通常在Git\bin\bash.exe。假设你的路径是E:\软件\Git\bin\bash.exe需要把它写进环境变量变量名固定为CLAUDE_CODE_GIT_BASH_PATH。在 Windows 里设置环境变量的方式搜索“环境变量” → 编辑系统环境变量 → 环境变量 → 新建用户变量变量名填CLAUDE_CODE_GIT_BASH_PATH变量值填你的 bash.exe 完整路径。设置完同样要重开终端。验证一下变量是否读到echo %CLAUDE_CODE_GIT_BASH_PATH%能打印出路径就说明配好了。这一步是 Claude Code 在 Windows 上能不能跑起来的关键路径写错或变量名拼错都会导致后面启动失败。4. 安装 Claude Code 并验证请求成功环境齐了装 Claude Code 就一行npm install -g anthropic-ai/claude-code装完验证版本claude -v能打印版本号说明安装成功。然后直接启动claude第一次启动可能会遇到两个常见情况。一是提示无法连接或卡在引导页。可以在用户目录~下找到.claude.json在末尾加上一个字段{ installMethod: unknown, autoUpdates: true, hasCompletedOnboarding: true }注意 JSON 里字段之间要有英文逗号位置别放错加完保存再启动。二是想换用别的模型。在~目录下找到settings.json写入对应配置后重启 Claude Code。启动后可以直接问它“你是什么模型”看回答确认是否切到了你配的模型。如果你打算长期在终端里用 AI 辅助编码、跑 Agent 任务可以了解下 Coding Plan 这类长期方案比每次单独配模型省心https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite想先快速验证模型对话效果可以直接在模型对话页试https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite5. 本篇常见错排查装的过程中最容易卡在下面几个地方对照着查。nvm 命令找不到终端没重启或者安装时没加入 PATH。重开终端还不行就检查环境变量里有没有 nvm 的路径。nvm use 后 node -v 没变PATH 里存在另一个 Node 安装比如之前官网装的它优先级更高。去控制面板卸载那个独立 Node或者调整 PATH 顺序让 nvm 的路径在前。npm 装包报权限错误说明你在用系统级 Node 而不是 nvm 管理的。确认nvm ls里当前版本是你要的且node -v输出和它一致。Claude Code 启动报找不到 bashCLAUDE_CODE_GIT_BASH_PATH没设、设错或者路径里有中文/空格导致解析失败。确认变量名拼写完全正确路径指向真实的 bash.exe。启动卡在引导页按第 4 节在.claude.json里加hasCompletedOnboarding: true注意 JSON 格式别写坏。换模型后没生效settings.json位置放错或者改完没重启 Claude Code。确认文件在~目录下改完完全退出再启动。排查时建议每改一处就重开终端验证一次别一次改一堆不然出问题不好定位。6. 环境跑通后接入和排障去哪查Claude Code 装好只是起点后面接入 API、配 Key、调模型参数这些才是日常。如果你在接入环节遇到报错或者想确认 Key 怎么配直接看 API Keys 和接入文档最省事API Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite控制台入口https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite如果你用的是 Claude Code 这类终端工具Anthropic 兼容接入的说明在这里https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite官网首页https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteAPI 地址统一用https://taotoken.net/api最后留个我自己的习惯nvm 切完版本后一定顺手跑一遍node -v npm -v claude -v三个版本号都正常再开始干活能省掉很多“昨天还好好的今天怎么跑不起来”的排查时间。