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