本教程基于Windows 10/11 环境手把手带你从安装 Node.js → 配置 npm → 安装 Claude Code → 跑通第一条命令覆盖所有踩坑点。第一步安装 Node.js 和 npmClaude Code 基于 Node.js 运行需要先安装Node.jsnpm 会随 Node.js 一起自动安装。下载地址 Node.js 官网下载 → 选择LTS长期支持版→ 下载.msi安装包安装过程双击下载的.msi文件一路Next即可建议勾选 Add to PATH 选项安装完成后重启终端验证安装在 PowerShell 或 CMD 中分别检查版本node -v npm -v如果能看到版本号如v20.x.x和10.x.x说明安装成功 ✅第二步配置 npm 全局安装路径可选但推荐默认情况下npm 全局安装的包会放在C:\Users\你的用户名\AppData\Roaming\npm下。如果你想统一管理或放到 D 盘可以自定义全局安装路径⚠️ 注意PowerShell 中 npm 可能被拦截如果你在 PowerShell 中运行npm config set prefix时遇到以下错误npm : 无法加载文件 D:\Program Files\nodejs\npm.ps1因为在此系统上禁止运行脚本。这是因为 PowerShell 的安全策略阻止了.ps1脚本。解决方案有两个方案 A切换到 CMD 操作推荐在 CMD 中操作不会触发脚本策略限制npm config set prefix D:\npm-global运行后没有任何返回信息是正常的。可以用以下命令确认设置成功npm config get prefix应该输出D:\npm-global方案 B在 PowerShell 中用 cmd 嵌套执行cmd /c npm config set prefix D:\npm-global将自定义路径加入系统 PATH修改了 npm 全局路径后需要把新路径加到系统环境变量PATH中否则后续claude命令会找不到按Win S搜索环境变量点击编辑系统环境变量点击环境变量按钮在系统变量区域找到Path→ 双击编辑点击新建→ 输入D:\npm-global换成你实际设置的路径一路确定保存重启终端使生效第三步全局安装 Claude CodeCMD中可运行npm install -g anthropic-ai/claude-code安装过程可能需要几分钟取决于网速。看到类似以下输出说明安装成功added XX packages in Xs 安装到了哪里安装完成后Claude Code 的启动文件位于你设置的 npm 全局目录下文件用途D:\npm-global\claude.cmdCMD 启动器推荐使用D:\npm-global\claude.ps1PowerShell 启动器需处理策略限制 如果找不到D:\npm-global文件夹试试在 CMD 里运行npm config get prefix确认实际路径。第四步验证安装是否成功方法一直接运行查看版本claude --version如果能看到版本号输出如v2.1.196说明Claude Code 已安装成功✅方法二启动 Claude Codeclaude如果出现欢迎界面和像素风格图标说明一切正常第五步解决网络问题问题现象如果你遇到以下错误Welcome to Claude Code v2.1.196 Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST Note: Claude Code might not be available in your country.这是正常的解决方案方案 APowerShell 中设置$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890方案 BCMD 中设置⚠️重要区别CMD 不认识$env:语法必须用set命令set HTTP_PROXYhttp://127.0.0.1:7890 set HTTPS_PROXYhttp://127.0.0.1:7890注意把7890设置为你实际使用的端口。设置完成后运行以下命令测试curl -I https://api.anthropic.com返回结果含义下一步HTTP/1.1 401 Unauthorized或 JSON 错误信息✅ 通过401 是因为没带 API Key说明已到达服务器可以正常使用 Claude Code 了连接超时 / 无法访问❌ 端口不对或网络不畅检查端口号和相关软件状态第六步PowerShell 脚本执行策略报错解决问题现象在 PowerShell 中输入claude后报错claude : 无法加载文件 D:\npm-global\claude.ps1因为在此系统上禁止运行脚本。 所在位置 行:1 字符: 1 claude ~~~~~~ CategoryInfo : SecurityError (PSSecurityException)原因npm 全局安装后生成了两个启动文件claude.ps1→ PowerShell优先调用此文件被安全策略阻止 ❌claude.cmd→ CMD 版启动器不受限制 ✅PowerShell 默认禁止运行.ps1脚本所以报错。✅ 解决方案使用claude.cmd最简单零副作用不需要修改任何系统安全策略只需把命令中的claude换成claude.cmd❌ 这样会报错claude✅ 这样就能正常运行claude.cmd为什么不推荐改系统策略你可能在网上搜到这种解法Set-ExecutionPolicy -Scope CurrentUser RemoteSigned这确实能解决问题但降低了系统的安全性。用claude.cmd可以达到同样效果且不影响任何系统设置。第七步最终验证——成功运行 Claude Code完整的标准操作流程以power shell为例按顺序执行以下步骤1. 进入你的项目目录记忆等功能绑定目录cd D:\YourProjectName2. 设置网络替换为你的实际端口$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:78903. 使用 .cmd 启动器避免脚本策略报错claude.cmd成功标志看到以下界面就说明100% 安装配置成功此时光标闪烁等待输入你可以开始和 Claude 对话了完整流程速查表从零开始的一键复制版CMD 用户:: 第1步检查 Node.js node -v npm -v:: 第2步可选修改 npm 全局路径 npm config set prefix D:\npm-global:: 记得把 D:\npm-global 加到系统 PATH 环境变量中 :: 第3步安装 Claude Code npm install -g anthropic-ai/claude-code:: 第4步验证安装 claude --version:: 第5步设置网络环境 set HTTP_PROXYhttp://127.0.0.1:7890 set HTTPS_PROXYhttp://127.0.0.1:7890:: 第6步启动 Claude Code claudePowerShell 用户只需把第5步换成$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890并把第6步的claude换成claude.cmd。 进阶优化让网络永久生效每次新开终端都要重新设置网络环境太麻烦把它写入 PowerShell 配置文件打开 PowerShell 配置文件首次会自动创建notepad $PROFILE在打开的文件中添加7890替换为你的实际端口$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890保存后以后每次打开 PowerShell 会自动加载网络设置。写在最后整个安装流程总结下来就是6 步装 Node.js → 可选改 npm 路径 → npm install → 验证版本 → 设置网络 → claude.cmd 启动最常踩的两个坑PowerShell 的$env:语法在 CMD 中无效→ CMD 用setPowerShell 的脚本策略拦截claude.ps1→ 改用claude.cmd跨过这两个坑Claude Code 就能顺利跑起来了相关推荐Claude Code 菜单完全指南每个选项都是什么意思图文详解
Claude Code 安装配置全流程指南（Windows 从零到跑通）
本教程基于Windows 10/11 环境手把手带你从安装 Node.js → 配置 npm → 安装 Claude Code → 跑通第一条命令覆盖所有踩坑点。第一步安装 Node.js 和 npmClaude Code 基于 Node.js 运行需要先安装Node.jsnpm 会随 Node.js 一起自动安装。下载地址 Node.js 官网下载 → 选择LTS长期支持版→ 下载.msi安装包安装过程双击下载的.msi文件一路Next即可建议勾选 Add to PATH 选项安装完成后重启终端验证安装在 PowerShell 或 CMD 中分别检查版本node -v npm -v如果能看到版本号如v20.x.x和10.x.x说明安装成功 ✅第二步配置 npm 全局安装路径可选但推荐默认情况下npm 全局安装的包会放在C:\Users\你的用户名\AppData\Roaming\npm下。如果你想统一管理或放到 D 盘可以自定义全局安装路径⚠️ 注意PowerShell 中 npm 可能被拦截如果你在 PowerShell 中运行npm config set prefix时遇到以下错误npm : 无法加载文件 D:\Program Files\nodejs\npm.ps1因为在此系统上禁止运行脚本。这是因为 PowerShell 的安全策略阻止了.ps1脚本。解决方案有两个方案 A切换到 CMD 操作推荐在 CMD 中操作不会触发脚本策略限制npm config set prefix D:\npm-global运行后没有任何返回信息是正常的。可以用以下命令确认设置成功npm config get prefix应该输出D:\npm-global方案 B在 PowerShell 中用 cmd 嵌套执行cmd /c npm config set prefix D:\npm-global将自定义路径加入系统 PATH修改了 npm 全局路径后需要把新路径加到系统环境变量PATH中否则后续claude命令会找不到按Win S搜索环境变量点击编辑系统环境变量点击环境变量按钮在系统变量区域找到Path→ 双击编辑点击新建→ 输入D:\npm-global换成你实际设置的路径一路确定保存重启终端使生效第三步全局安装 Claude CodeCMD中可运行npm install -g anthropic-ai/claude-code安装过程可能需要几分钟取决于网速。看到类似以下输出说明安装成功added XX packages in Xs 安装到了哪里安装完成后Claude Code 的启动文件位于你设置的 npm 全局目录下文件用途D:\npm-global\claude.cmdCMD 启动器推荐使用D:\npm-global\claude.ps1PowerShell 启动器需处理策略限制 如果找不到D:\npm-global文件夹试试在 CMD 里运行npm config get prefix确认实际路径。第四步验证安装是否成功方法一直接运行查看版本claude --version如果能看到版本号输出如v2.1.196说明Claude Code 已安装成功✅方法二启动 Claude Codeclaude如果出现欢迎界面和像素风格图标说明一切正常第五步解决网络问题问题现象如果你遇到以下错误Welcome to Claude Code v2.1.196 Unable to connect to Anthropic services Failed to connect to api.anthropic.com: ERR_BAD_REQUEST Note: Claude Code might not be available in your country.这是正常的解决方案方案 APowerShell 中设置$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890方案 BCMD 中设置⚠️重要区别CMD 不认识$env:语法必须用set命令set HTTP_PROXYhttp://127.0.0.1:7890 set HTTPS_PROXYhttp://127.0.0.1:7890注意把7890设置为你实际使用的端口。设置完成后运行以下命令测试curl -I https://api.anthropic.com返回结果含义下一步HTTP/1.1 401 Unauthorized或 JSON 错误信息✅ 通过401 是因为没带 API Key说明已到达服务器可以正常使用 Claude Code 了连接超时 / 无法访问❌ 端口不对或网络不畅检查端口号和相关软件状态第六步PowerShell 脚本执行策略报错解决问题现象在 PowerShell 中输入claude后报错claude : 无法加载文件 D:\npm-global\claude.ps1因为在此系统上禁止运行脚本。 所在位置 行:1 字符: 1 claude ~~~~~~ CategoryInfo : SecurityError (PSSecurityException)原因npm 全局安装后生成了两个启动文件claude.ps1→ PowerShell优先调用此文件被安全策略阻止 ❌claude.cmd→ CMD 版启动器不受限制 ✅PowerShell 默认禁止运行.ps1脚本所以报错。✅ 解决方案使用claude.cmd最简单零副作用不需要修改任何系统安全策略只需把命令中的claude换成claude.cmd❌ 这样会报错claude✅ 这样就能正常运行claude.cmd为什么不推荐改系统策略你可能在网上搜到这种解法Set-ExecutionPolicy -Scope CurrentUser RemoteSigned这确实能解决问题但降低了系统的安全性。用claude.cmd可以达到同样效果且不影响任何系统设置。第七步最终验证——成功运行 Claude Code完整的标准操作流程以power shell为例按顺序执行以下步骤1. 进入你的项目目录记忆等功能绑定目录cd D:\YourProjectName2. 设置网络替换为你的实际端口$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:78903. 使用 .cmd 启动器避免脚本策略报错claude.cmd成功标志看到以下界面就说明100% 安装配置成功此时光标闪烁等待输入你可以开始和 Claude 对话了完整流程速查表从零开始的一键复制版CMD 用户:: 第1步检查 Node.js node -v npm -v:: 第2步可选修改 npm 全局路径 npm config set prefix D:\npm-global:: 记得把 D:\npm-global 加到系统 PATH 环境变量中 :: 第3步安装 Claude Code npm install -g anthropic-ai/claude-code:: 第4步验证安装 claude --version:: 第5步设置网络环境 set HTTP_PROXYhttp://127.0.0.1:7890 set HTTPS_PROXYhttp://127.0.0.1:7890:: 第6步启动 Claude Code claudePowerShell 用户只需把第5步换成$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890并把第6步的claude换成claude.cmd。 进阶优化让网络永久生效每次新开终端都要重新设置网络环境太麻烦把它写入 PowerShell 配置文件打开 PowerShell 配置文件首次会自动创建notepad $PROFILE在打开的文件中添加7890替换为你的实际端口$env:HTTP_PROXYhttp://127.0.0.1:7890 $env:HTTPS_PROXYhttp://127.0.0.1:7890保存后以后每次打开 PowerShell 会自动加载网络设置。写在最后整个安装流程总结下来就是6 步装 Node.js → 可选改 npm 路径 → npm install → 验证版本 → 设置网络 → claude.cmd 启动最常踩的两个坑PowerShell 的$env:语法在 CMD 中无效→ CMD 用setPowerShell 的脚本策略拦截claude.ps1→ 改用claude.cmd跨过这两个坑Claude Code 就能顺利跑起来了相关推荐Claude Code 菜单完全指南每个选项都是什么意思图文详解
