0.4 安装 Claude Code

学习目标

• 在你的电脑上成功安装 Claude Code
• 确认安装成功（能看到版本号）
• 知道碰到报错怎么处理

---

安装前的准备

不管你用什么操作系统，安装 Claude Code 之前需要确保两件事：

1. Node.js 已安装（18 及以上版本）
2. 网络可以正常访问 npm 仓库

不知道 Node.js 是什么？别担心，下面会手把手教你装。

先装 Node.js（如果你还没有的话）

Node.js 是 JavaScript 的运行环境，Claude Code 依赖它。你可以理解为——Claude Code 是一个 App，Node.js 是它需要的"操作系统"。

检查你是否已经装过

打开终端（macOS 的 Terminal / Windows 的 PowerShell），输入：

node --version

如果看到类似 v20.11.0 这样的版本号，说明已经装好了，可以跳过这一步。

如果提示"command not found"或者版本低于 18，就需要安装/更新。

[截图: 终端中运行 node --version 的结果]

安装 Node.js（推荐方式）

访问 Node.js 官网：

https://nodejs.org

下载 LTS 版本（长期支持版，更稳定），然后双击安装包，一路点"下一步"就行。

[截图: Node.js 官网下载页面，标注 LTS 版本]

踩坑提醒：一定要下 LTS 版本，不要下 Current 版本。LTS 更稳定，兼容性更好。

安装完成后，关闭终端再重新打开，然后再次运行 node --version 确认。

---

macOS 安装 Claude Code（2 种方式）

方式一：npm 安装（推荐）

这是最通用的方式。打开终端（Launchpad → 搜索 "Terminal"），运行：

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

等它跑完就好了，通常 1-2 分钟。

[截图: npm 安装过程的终端输出]

踩坑提醒：如果提示 permission denied（权限不足），在命令前加 sudo：

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

输入你的电脑登录密码（输入时看不到任何字符，这是正常的），回车即可。

方式二：Homebrew 安装

如果你用 Homebrew（macOS 的包管理器），可以这样装：

brew install claude-code

没用过 Homebrew？那就用方式一，不需要折腾这个。

说明

Claude Code 是一个纯命令行工具，没有独立的桌面版 App。它运行在终端里，这也是它强大的原因 — 能直接操作你电脑上的一切。后面会教你怎么用，别怕。

---

Windows 安装

第 1 步：安装 Claude Code

打开 PowerShell（搜索栏搜"PowerShell"），运行：

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

第 2 步：安装 Git

Claude Code 需要 Git 来管理代码版本。访问 Git 官网下载安装：

https://git-scm.com/download/win

下载后双击安装，一路点"Next"用默认选项就行。

第 3 步：用 Git Bash 运行 Claude Code

安装 Git 后，你会获得一个叫 Git Bash 的终端。推荐用 Git Bash 来运行 Claude Code，而不是 PowerShell。

打开方式：在桌面或任意文件夹里右键 → 「Open Git Bash here」

[截图: 右键菜单中的 Open Git Bash here]

然后在 Git Bash 里输入 claude 就能启动了。

为什么用 Git Bash 而不是 PowerShell？ Git Bash 提供了类 Unix 的终端环境，很多命令（如 ls、cat、grep）和 macOS/Linux 一致，Claude Code 运行起来兼容性更好。

---

Linux 安装

如果你用 Linux，大概率不需要我教你这个。简单过一下：

# Ubuntu / Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
npm install -g @anthropic-ai/claude-code

# 或者如果你已经有 Node.js
npm install -g @anthropic-ai/claude-code

---

安装验证

不管你用哪种方式安装的，最后都要验证一下。

打开终端，运行：

claude --version

如果看到版本号（比如 1.0.x），恭喜你，安装成功了。

[截图: claude --version 输出版本号]

如果提示"command not found"，说明安装有问题，按下面的步骤排查。

---

常见安装问题

Q：npm install 速度特别慢怎么办？

npm 默认从国外服务器下载，国内可能会很慢。可以设置镜像源：

npm config set registry https://registry.npmmirror.com

设置完之后重新运行安装命令。

踩坑提醒：装完 Claude Code 之后建议把镜像源改回来，因为有些包在镜像源上可能不是最新的：

npm config set registry https://registry.npmjs.org

Q：提示 Node.js 版本太低怎么办？

Claude Code 需要 Node.js 18 及以上版本。如果你装的是旧版：

• 去 https://nodejs.org 下载最新 LTS 版本覆盖安装
• 或者用 nvm（Node Version Manager）管理多个版本

Q：安装成功了但 claude 命令找不到？

可能是环境变量没配好。试试关闭终端重新打开。如果还不行：

# 查看 npm 全局安装路径
npm config get prefix

# 确认这个路径在你的 PATH 环境变量里
echo $PATH

---

小结

• 先装 Node.js（18+），再装 Claude Code
• macOS 推荐 npm install -g @anthropic-ai/claude-code
• Windows 安装 Git，用 Git Bash 运行 Claude Code
• Claude Code 是纯命令行工具，没有独立桌面版
• 安装完跑 claude --version 验证
• npm 速度慢就换镜像源，权限不够就加 sudo

下一节 → 首次启动与登录