Skip to content

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。

这样系统才能识别刚刚安装好的 nodenpm 命令。

第三步:检查 Node.js 是否安装成功

打开 PowerShell 或 CMD。

复制下面这行命令,粘贴进去,然后按回车:

bash
node -v

这个命令用来查看 Node.js 版本。

如果看到类似 v20.x.xv22.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 -vnpm -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 的提示继续配置。