安装 Claude Code

Mac / Windows 傻瓜步骤。装一次只需 10-15 分钟，之后都很简单。

安装 Claude Code

装之前先看完这 5 行

• 会有点折腾，但只折腾一次。 装好之后每天用只是输入命令。
• 要先装一个叫 Node.js 的东西——它是 Claude Code 的”地基”。
• 要打开一个叫”终端”的黑色窗口——它就是你以后下命令的地方。看着吓人，其实就是个能打字的窗口。
• 要在网上付费——免费账号也能用，但每天有用量上限，建议直接用 Pro 订阅或 API。
• 不要相信”一键安装包”骗局——目前为止官方只给两条正路：Anthropic 官网 installer 和 npm 命令。其他都是高仿。

Mac 用户

第 1 步：打开终端

按 ⌘ + 空格 调出 Spotlight，输入 Terminal，回车。 会出现一个黑色窗口。这就是你以后下命令的地方。

第 2 步：安装 Node.js

如果你确定自己装过 Node.js，跳过。否则：

1. 打开 nodejs.org
2. 下载 LTS 版本（写着 “Recommended for most users” 那个）
3. 双击 .pkg 文件，一路下一步
4. 装完打开终端，输入：

   node --version

   如果显示 v20.x.x 或更高，说明成功。

第 3 步：安装 Claude Code

在终端里输入：

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

回车。等 1-2 分钟。看到一堆滚动的字别慌，最后停下不报红色错误就是好的。

第 4 步：登录

在终端里输入：

claude

第一次运行会让你登录 Anthropic 账号。按提示在浏览器里完成登录，回到终端就能用了。

---

Windows 用户

第 1 步：打开 PowerShell（或 cmd）

按 Win + X，选 “Windows PowerShell” 或 “Terminal”。 出现的蓝色 / 黑色窗口就是命令行。

第 2 步：安装 Node.js

1. 打开 nodejs.org
2. 下载 LTS 版本 (.msi 文件)
3. 双击安装，全部默认即可
4. 重启 PowerShell（关掉重开），输入：

   node --version

   显示版本号就是成功。

第 3 步：安装 Claude Code

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

如果报”权限不足”，用管理员模式重开 PowerShell（搜索时右键”以管理员身份运行”）再试。

第 4 步：登录

claude

按提示在浏览器登录账号即可。

---

验证装好了

在终端里输入：

claude --version

显示版本号 = 成功。 显示 “command not found” = 失败，看下面的常见问题。

---

三个常见报错

报错	原因	解决
command not found: claude	没装好或没刷新终端	关掉终端重开；或重装 Node.js 时勾选 “Add to PATH”
EACCES permission denied	权限不足	Mac：命令前加 sudo；Windows：管理员模式
Cannot connect to anthropic.com	网络问题	claude.ai 在中国大陆需要海外网络。香港、新加坡、台湾、欧美正常。

一个不要做的事

不要听信”国内镜像”或”破解版”。 Claude Code 会执行你电脑上的命令——一旦装到第三方魔改版，等于把你的电脑钥匙交给陌生人。只用官方源（npm + anthropic.com）。

---

下一篇：第一次跑通 —— 5 分钟实操，让 Claude Code 整理你电脑上的一个文件夹。