Mascot Logo
ai-agents-tutorial

Part 1 · 第 3 课，共 16 课

如何在 macOS、Windows 和 Linux 上安装 Claude Code

安装 Node.js。安装 CLI 工具。登录授权。

12 min

第 1 步 / 共 5 步 · 选择安装方式

Claude Code 是一个名为 claude 的命令行工具。常见的安装方式有两种，你只需要选其中一种即可。

  • 原生安装脚本（推荐）。 一条简短的脚本会下载一个独立的可执行文件。无需 Node.js，并且它会在后台自动保持更新。
  • npm。 如果你本来就在用 Node.js，可以把同一个二进制文件作为全局 npm 包来安装。

下面两种方式都会介绍。选择适合你环境的那一种，然后继续下一步。

第 2 步 / 共 5 步 · 安装 Claude Code（原生安装脚本）

这是最简单的方式，无需 Node.js 即可使用。打开你的终端，运行适用于你系统的命令。

macOS、Linux 或 WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows（PowerShell）：

irm https://claude.ai/install.ps1 | iex

Windows（命令提示符 / CMD）：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

安装脚本会把 claude 二进制文件放在 macOS/Linux 的 ~/.local/bin/claude（Windows 上是 %USERPROFILE%\.local\bin\claude.exe），并将该目录加入你的 PATH。原生安装会在后台自动更新，因此你会一直保持在最新版本。

第 3 步 / 共 5 步 · 或使用 npm 安装（可选）

更习惯通过 Node.js 来管理 Claude Code？你也可以把同一个工具作为全局 npm 包来安装。这种方式需要 Node.js 18 或更高版本。

先确认 Node 是否可用：

node -v

如果你看到类似 v18.16.0 或 v20.9.0 的版本号，就说明没问题。如果收到“command not found”的错误提示，请前往 nodejs.org 下载 LTS（长期支持）版本，运行安装程序，然后重启你的终端。

然后全局安装 Claude Code：

npm install -g @anthropic-ai/claude-code

第 4 步 / 共 5 步 · 启动 Claude Code 并登录

无论你用哪种方式安装，都可以运行以下命令来启动工具：

claude

首次运行时，Claude Code 会打开你的 Web 浏览器，让你登录并授权该 CLI。按照浏览器中的提示完成即可。

第 5 步 / 共 5 步 · 检查点与本节回顾

本节回顾

  • 原生安装脚本：curl -fsSL https://claude.ai/install.sh | bash（macOS/Linux/WSL）或 irm https://claude.ai/install.ps1 | iex（Windows）。无需 Node.js，自动更新。
  • npm（可选）：npm install -g @anthropic-ai/claude-code——需要 Node.js 18+，且切勿使用 sudo。
  • claude：启动 CLI 并触发首次登录认证流程。
  • claude --version：验证 CLI 是否已安装且可被系统识别。
  • claude doctor：当某些地方看起来不对劲时，运行更深入的健康检查。

常见问题

安装时遇到的多数小问题，归根结底都是你的终端还找不到 claude 命令。下面是几个常见情况及其解决办法。

“command not found: claude”

如果安装已经完成，但终端提示 command not found: claude（macOS/Linux）或 'claude' is not recognized（Windows），说明二进制文件其实已经装好了——只是你的终端还不知道去哪里找它。这几乎总是因为安装目录还没有加入你的 PATH。请参考下一节进行修复。

PATH 未更新（~/.local/bin）

原生安装脚本会把 claude 放在 ~/.local/bin。如果该目录不在你的 PATH 中，终端就无法运行这个命令。先检查它是否已经在其中：

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

如果这条命令打印出了你的 .local/bin 路径，就说明没问题。如果没有任何输出，就把该目录加入你的 shell 配置文件。在 macOS 上（默认是 Zsh）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

在多数 Linux 发行版上（默认是 Bash）：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

然后确认是否生效：

claude --version

在 Windows 上，二进制文件位于 %USERPROFILE%\.local\bin。如果系统无法识别 claude，请把该目录加入你的用户 PATH（通过 PowerShell 或系统设置），然后重启终端。

用“claude doctor”进行诊断

当 claude --version 能正常运行，但总感觉哪里不太对劲时，Claude Code 自带了一个诊断命令。在终端中运行：

claude doctor

它会一次性检查你的安装、设置和配置，并指出具体哪里出了问题。（如果你已经在 Claude Code 会话内，可以改用 /doctor。）在去搜索某条错误信息之前，这是值得最先尝试的一步。

安装 Claude Code 需要 Node.js 吗？

不需要。推荐的原生安装脚本（macOS/Linux 上的 curl -fsSL https://claude.ai/install.sh | bash，Windows 上的 irm https://claude.ai/install.ps1 | iex）会下载一个独立的二进制文件，无需 Node.js。只有当你选择可选的 npm install -g @anthropic-ai/claude-code 方式时，才需要 Node.js 18+。

安装 Claude Code 时应该用 sudo 吗？

不应该。官方文档专门提醒不要使用 sudo npm install -g，因为它可能引发权限和安全问题。如果你在用 npm 时遇到权限错误，请改用原生安装脚本——它会安装到你的主目录中，不需要管理员权限。

如何验证 Claude Code 安装是否成功？

运行 claude --version 确认 CLI 已安装且可被系统识别。如需更深入地检查安装和配置，可以在终端运行 claude doctor（或在会话内运行 /doctor）。

为什么终端提示“command not found: claude”？

安装其实成功了，只是安装目录（~/.local/bin）还没有加入你的 PATH，所以终端找不到这个命令。把 ~/.local/bin 加入你的 PATH——在 ~/.zshrc（macOS）或 ~/.bashrc（Linux）中添加，用 source 重新加载后，再次运行 claude --version 即可。