Windows 10/11 怎么安装 Claude Code？从环境检查到首次运行的完整指南

Windows 下安装 Claude Code，真正容易出问题的地方通常不是“输入哪条命令”，而是版本、终端、目录、权限和登录方式没有对齐。由于 Claude Code 的安装方式和要求可能更新，本文不写死某个版本命令，而是提供一套不容易过时的安装流程。

安装前先记录你的环境

在开始前写下以下信息：

项目	需要确认的内容
系统	Windows 版本、系统架构和更新状态
终端	PowerShell、Windows Terminal、WSL 或其他终端
运行时	当前官方文档要求的运行时及版本
项目	使用的语言、包管理器和测试命令
账号	登录方式、工作区和服务主体
权限	允许读取、修改和执行的目录范围

把环境信息记录下来，后续遇到“命令找不到”“权限不足”或“项目无法识别”时，才能判断是安装问题、路径问题还是项目配置问题。

从官方文档确认安装方式

Claude Code 的命令、运行时、系统支持和登录方式都可能变化。打开官方文档时，重点确认：

1. 当前 Windows 支持哪些安装路径。
2. 需要哪些运行时和最低版本。
3. 登录是通过浏览器、令牌还是其他方式完成。
4. 哪些命令会修改系统、安装依赖或访问网络。
5. 当前版本如何升级、卸载和排查问题。

不要同时复制多个教程里的安装命令。不同文章可能针对不同版本、终端或第三方接入方式，混用后更容易出现路径冲突。

Windows 安装的一般流程

第一步：准备独立的开发目录

先选一个明确的项目目录，不要直接把用户主目录、下载目录或包含大量私人文件的位置作为工作区。项目目录中也不要放 API Key、密码和生产凭据。

第二步：安装并验证官方要求的运行环境

按照官方文档安装所需运行时，安装后分别检查版本和路径是否被系统识别。如果同一台电脑上存在多个版本，先解决路径优先级，再继续安装 Claude Code。

第三步：完成 Claude Code 安装

严格按官方当前文档执行安装步骤。遇到系统弹出管理员权限、网络访问或脚本执行提示时，先读清楚操作对象和来源，不要因为教程写着“一键安装”就无条件批准。

第四步：确认命令和登录状态

安装完成后，先执行官方文档中用于查看版本或状态的检查方式。确认终端能找到命令，再完成登录。不要把登录验证码、恢复码和 API Key 粘贴到截图、Issue 或陌生网站。

第五步：用只读任务首次运行

第一次进入项目时，不要立即要求改代码。可以这样描述：

请先只读检查这个项目，不要修改文件。
输出项目入口、主要模块、运行测试的命令和你实际读取过的文件。
不要读取 .env、密钥文件、生产配置和无关目录。
如果无法确认某项，请标记为未知。

当它的项目理解经过人工抽查后，再允许处理一个很小的修改。

Windows 下最容易遇到的五类问题

命令找不到

先确认安装是否完成、终端是否重新打开、路径是否进入当前用户环境变量，以及是否存在多个运行时。不要立刻重复安装；重复安装可能产生更多路径冲突。

权限被拒绝

确认当前目录是否可写、是否被安全软件占用，以及工具是否试图访问不应访问的位置。优先调整工作目录和权限范围，不要直接以管理员身份运行所有任务。

项目依赖无法安装

记录完整错误、网络环境、包管理器和项目锁文件。先让 Claude 解释失败发生在哪一步，再由人工确认是否要修改依赖。不要为了让安装通过而随意删除锁文件。

中文路径或换行符导致脚本异常

检查项目路径、终端编码、脚本解释器和仓库约定。重要项目不要仅凭模型猜测修改构建配置，应先复现并保存当前状态。

登录完成但项目不可用

核对登录账号、工作区、模型权限和当前目录。网页产品的订阅状态、API 权限和 Claude Code 使用条件不能直接互相推断。

安全配置比安装成功更重要

• 在版本控制中保存安装前的项目状态。
• 使用隔离分支或临时目录运行代理。
• 明确不允许读取的目录和文件名模式。
• 禁止把 .env、SSH 密钥、云凭据和客户数据放入上下文。
• 任何批量编辑前先查看计划和文件清单。
• 任何自动执行命令后都要查看输出、退出码和副作用。

完成首次安装后，可以继续阅读Claude Code 中文工作流和Claude 编程代码审查方法。

结论

Windows 安装 Claude Code 的可靠顺序是：记录环境、核对当前官方要求、准备隔离目录、安装并验证命令、先做只读任务、再逐步开放权限。教程中的命令会变化，但这套检查顺序可以帮助你减少版本冲突和误操作。