2.1 安装 Claude Code

一条命令的事

Claude Code 的安装没什么神秘的，就是在终端里跑一条命令。

根据你的操作系统选对应的：

macOS / Linux / WSL（Windows 的 Linux 子系统）

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

⚠️ Windows 用户注意：需要先装 Git for Windows，没装的话先去装，不然后面会出问题。

安装完之后，重新打开一个终端窗口，运行：

claude --version

看到版本号就说明装好了。比如：

Claude Code 1.x.x

---

也可以用 Homebrew（macOS）

如果你习惯用 Homebrew 管理软件包：

brew install --cask claude-code

💡 Homebrew 安装的版本不会自动更新，需要手动运行 brew upgrade claude-code 来升级。原生安装脚本装的版本会在后台自动更新，省事一些。

---

如何更新

原生安装的版本会自动更新，一般不需要手动管。如果你想强制更新到最新版：

claude update

---

如何卸载

如果哪天你不想用了（很难想象，但万一呢）：

claude uninstall

---

🚨 踩坑指南：作者从屎坑里趟出来的经验

以下内容来自真实踩坑经历。写出来不是为了让你笑，是为了让你少痛苦半小时。

---

坑 1：M1/M2/M3 Mac 上 command not found

安装脚本跑完了，但输入 claude 提示"command not found"。

原因：安装路径没加进 PATH。 解法：关掉终端，重新打开一个新窗口再试。还不行的话，手动加路径：

# 找一下 claude 装在哪了
which claude || ls ~/.local/bin/claude

# 把这行加到你的 ~/.zshrc 或 ~/.bashrc 末尾
export PATH="$HOME/.local/bin:$PATH"

# 重新加载配置
source ~/.zshrc

---

坑 2：Windows 上 PowerShell 提示"执行策略"错误

cannot be loaded because running scripts is disabled on this system

原因：Windows 默认禁止运行从网络下载的脚本。 解法：用管理员身份打开 PowerShell，先运行：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

然后再跑安装命令。

---

坑 3：WSL 里装了，但 Windows 这边找不到

WSL（Windows Subsystem for Linux）里的 Claude Code 和 Windows 本体是隔离的。在 WSL 终端里装，就只能在 WSL 里用；在 Windows PowerShell 里装，就只能在 Windows 里用。

建议：如果你主要在 WSL 里开发，就在 WSL 里装；如果你用 VS Code + WSL Remote，在 WSL 里装就够了。

---

坑 4：网络超时/安装卡住

国内网络访问 claude.ai 可能不稳定，下载脚本会卡住或报错。

解法：挂代理后再跑安装命令。如果你用的是终端代理，确认一下代理对当前终端会话生效：

# 检查代理是否生效
echo $https_proxy
curl -I https://claude.ai

---

好了，坑介绍完了。大部分人顺顺当当一条命令就过了，上面这些只是以防万一。

下一节，装好了之后登录账号。