macOS 安装 Claude Code：官方脚本和 Homebrew 怎么选
在 Mac 上装 Claude Code，现在主流是两条路：官方安装脚本（原生包）和 Homebrew cask。两者都能用，差别主要在更新方式和 PATH。下面按「先装上、再登录、再自检」走一遍；跨平台总览见 完整安装指南，Windows 见 Windows 安装。
先确认环境和订阅
- 系统：macOS 13 及以上（Ventura / Sonoma / Sequoia 均可）。
- 账号：需要 Pro / Max / Team（或企业）订阅。免费计划不能用 Claude Code，装上了也会卡在登录或额度提示。
- 终端：系统自带 Terminal、iTerm2、Warp 都行；下面命令默认在 zsh。
装之前不必先装 Node——当前官方脚本和 cask 都不依赖你本机全局 npm install -g。若你机器里还留着旧的 @anthropic-ai/claude-code npm 全局包，建议卸掉，避免 PATH 里两个 claude 互相抢。
方式一：官方脚本（推荐新手）
官方原生安装一行搞定：
curl -fsSL https://claude.ai/install.sh | bash脚本会把二进制放到用户目录（常见是 ~/.local/bin/claude），并尽量帮你写好 shell 配置。装完后新开一个终端，再验证：
which claude
claude --version
claude doctorclaude doctor 会检查二进制、网络、登录态等，比只看版本号更靠谱。若提示 command not found，多半是 PATH 没带上 ~/.local/bin，见下一节。
方式二：Homebrew
已经在用 brew 的同学，可以直接：
brew install --cask claude-code部分文档或镜像会写 claude-code@latest 这类配方名；以你本机 brew search claude 的实际结果为准。cask 装好后同样执行：
claude --version
claude doctor和官方脚本怎么选？
| 维度 | 官方脚本 | Homebrew cask |
|---|---|---|
| 门槛 | 一条 curl，不依赖 brew | 需已装 Homebrew |
| 路径 | 通常 ~/.local/bin | brew 前缀下的 symlink |
| 更新 | 客户端侧自动更新为主 | brew upgrade --cask claude-code |
| 适合谁 | 只想快点用上 | 习惯用 brew 管软件的人 |
两条路不要混装抢 PATH。若先脚本后 brew（或反过来），用 which -a claude 看实际命中的是哪一个，必要时卸掉多余的那份。
PATH：让终端找得到 claude
官方脚本路径常见：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc若用 bash，改 ~/.bash_profile 或 ~/.bashrc。Homebrew 用户一般已有 brew 的 PATH；若没有，按 brew doctor 提示补上。
验证：
echo $PATH | tr ':' '\n' | head
command -v claude仍找不到时，对照 安装排错 里的 command not found 一节。
登录：浏览器走 OAuth
终端里运行：
claude或显式登录流程（视版本菜单略有差异）。它会打开浏览器完成 Anthropic 账号授权，再回到终端。注意：
- 浏览器里登录的账号必须是已订阅的那一个。
- 若环境变量里设了
ANTHROPIC_API_KEY，可能绕过订阅登录走 API Key 路径——调试完记得清掉，避免和 Pro/Max 订阅混用。 - 国内网络卡住、403、粘贴授权码失败，先看 国内使用优化 与 安装排错。
更新：原生 vs brew
- 官方脚本安装：客户端通常会提示或自动拉取新版本；出问题再重跑一次 install 脚本也行。
- Homebrew：主动升级用
brew upgrade --cask claude-code，再claude --version确认。
大版本或行为变更后，建议再跑一次 claude doctor。
装好后的最小验收
claude --version有版本号。claude doctor无致命红项。- 在任意空目录
claude，能正常进入会话并提问。 - 打开真实项目：
cd your-repo && claude，让它读一下 README。
第一次会话想按 30 分钟节奏走，看 新手第一次用。权限与沙箱边界见 permissions / sandbox；命令与工作流总览见 完整使用指南 和 官方中文概览。