主题
Win安装
安装前准备
Claude Code 需要通过 npm 安装。
npm 会跟随 Node.js 一起安装,所以 Windows 电脑需要先安装 Node.js。
安装前请先准备好:
- 一台 Windows 电脑
- 可以正常打开网页的浏览器
- 可以正常联网
- 可以打开 PowerShell 或 CMD
注意:Node.js 请从官方地址下载,不要随便下载来路不明的安装包。
Node.js 官方地址:
text
https://nodejs.org/第一步:下载 Node.js
打开浏览器,进入 Node.js 官方网站:
text
https://nodejs.org/进入页面后,下载 LTS 长期支持版。
如果页面显示 Windows Installer,就下载这个 Windows 安装包。
不要随便下载其他网站提供的安装包,避免安装到不安全的软件。
第二步:安装 Node.js
找到刚才下载好的 Node.js 安装包。
双击打开安装包。
安装时一般一路点击“Next”或“下一步”即可。
如果看到“Install”或“安装”,继续点击安装。
安装完成后,点击“Finish”或“完成”。
安装完成后,请关闭当前已经打开的 PowerShell 或 CMD,然后重新打开一个新的 PowerShell 或 CMD。
这样系统才能识别刚刚安装好的 node 和 npm 命令。
第三步:检查 Node.js 是否安装成功
打开 PowerShell 或 CMD。
复制下面这行命令,粘贴进去,然后按回车:
bash
node -v这个命令用来查看 Node.js 版本。
如果看到类似 v20.x.x、v22.x.x 这样的版本号,说明 Node.js 已经安装成功。
如果提示 node 不是内部或外部命令,先关闭 PowerShell 或 CMD,再重新打开一次。
如果重新打开后还是不行,说明 Node.js 可能没有加入环境变量,需要重新安装 Node.js,或者检查系统的 PATH 设置。
第四步:检查 npm 是否可用
继续在 PowerShell 或 CMD 里输入下面这行命令:
bash
npm -v这个命令用来查看 npm 版本。
如果看到一串版本号,说明 npm 可以正常使用。
如果 node -v 正常,但 npm -v 不正常,可以重新安装 Node.js 的 LTS 版本。
第五步:使用 npm 安装 Claude Code
确认 node -v 和 npm -v 都正常后,再安装 Claude Code。
复制下面这行命令,粘贴到 PowerShell 或 CMD 里,然后按回车:
bash
npm install -g @anthropic-ai/claude-code这行命令的意思是:使用 npm 在电脑上安装 Claude Code。
安装过程可能需要等待一会儿,请不要中途关闭窗口。
如果安装很慢,可以先等几分钟。网络不稳定时,安装时间会变长。
第六步:检查 Claude Code 是否安装成功
安装完成后,输入下面这行命令:
bash
claude --version这个命令用来查看 Claude Code 的版本。
如果能看到版本号,说明 Claude Code 已经安装成功。
也可以再执行下面这行命令,做更完整的检查:
bash
claude doctor这个命令会检查 Claude Code 当前环境是否正常。
如果检查结果没有明显错误,就可以继续使用。
第七步:第一次启动 Claude Code
安装完成后,复制下面这行命令,粘贴到 PowerShell 或 CMD 里,然后按回车:
bash
claude这个命令会启动 Claude Code。
第一次启动时,页面可能会提示你登录或进行初始化设置。
按照终端里的提示一步一步操作即可。
常见问题
node 命令不存在怎么办?
先关闭 PowerShell 或 CMD,然后重新打开。
如果还是提示找不到 node,说明 Node.js 可能没有安装成功,或者没有加入环境变量。
建议重新从 Node.js 官网下载 LTS 长期支持版并安装。
npm 命令不存在怎么办?
正常情况下,安装 Node.js 后会自动带上 npm。
如果 npm -v 不可用,可以重新安装 Node.js LTS 长期支持版。
安装完成后记得重新打开 PowerShell 或 CMD。
claude 命令不存在怎么办?
先确认前面的安装命令是否执行成功:
bash
npm install -g @anthropic-ai/claude-code然后关闭 PowerShell 或 CMD,重新打开后再执行:
bash
claude --version如果还是不行,可能是 npm 全局安装目录没有加入 PATH。
安装很慢怎么办?
安装慢通常是网络原因。
可以先等待几分钟,不要反复关闭窗口。
如果长时间没有反应,可以换一个网络环境后再试。
终端看不懂怎么办?
不用害怕。
你只需要把文档里的命令复制进去,然后按回车。
如果出现报错,可以把报错内容截图发给客服或懂电脑的人帮你看。
安装完成后下一步做什么?
先执行:
bash
claude doctor确认没有明显错误后,再执行:
bash
claude然后按照 Claude Code 的提示继续配置。
