2.1.3 macOS Homebrew 安装

适合已使用 Homebrew 管理开发环境的 macOS 用户，便于统一版本管理和自动更新。

前置要求

• Homebrew：需已安装 4.0 及以上版本（运行 brew --version 检查）
• macOS：12.0 (Monterey) 及以上（见 1.1 节）
• 权限：当前用户需对 /opt/homebrew (Apple Silicon) 或 /usr/local (Intel) 有写入权限

安装步骤

Homebrew 已收录官方公式，无需额外添加 Tap：

# 直接安装
brew install claude-code

# 验证安装路径
which claude
# 典型输出：/opt/homebrew/bin/claude (Apple Silicon) 或 /usr/local/bin/claude (Intel)

首次安装后刷新：
如终端提示 command not found，执行以下命令刷新路径：

hash -r  # 或重启终端窗口

更新与卸载

更新（跟随 Homebrew 常规更新流程）：

# 单独更新 Claude Code
brew upgrade claude-code

# 或统一更新所有包
brew update && brew upgrade

卸载：

brew uninstall claude-code

# 清理相关配置（可选）
rm -rf ~/.claude

与官方脚本安装的对比

| 维度 | Homebrew 安装 | 官方脚本（2.1.1） |
|------|---------------|------------------|
| 版本时效 | 通常滞后 1-3 天 | 官方源，实时最新 |
| 更新体验 | brew upgrade 一键更新 | 需重新运行安装脚本 |
| 权限管理 | 自动处理，无需 sudo | 可能需处理 /usr/local/bin 权限 |
| 多版本 | 不支持回滚旧版本 | 可手动下载指定版本二进制 |
| 依赖处理 | 自动检查并提示 Node 等依赖 | 仅安装本体，依赖需自行准备 |

注意事项

版本滞后：
Homebrew 的更新需经过社区审核合并，紧急安全补丁可能比官方渠道晚 24-72 小时。如需立即使用最新功能，建议临时切换到官方脚本安装：

# 先卸载 Homebrew 版本
brew uninstall claude-code

# 安装官方最新版
curl -fsSL https://claude.ai/install.sh | sh

Apple Silicon 与 Intel：
Homebrew 会自动根据芯片架构下载对应版本（ARM64 或 x86_64），无需手动指定。如通过 Rosetta 2 使用，需确保终端未在转译模式下运行。

与 npm 共存冲突：
如之前通过 npm 安装过，需先卸载避免路径冲突：

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

下一步

安装完成后，执行 claude --version 确认版本号，然后进入 3.4 节 完成首次启动验证。如遇 claude 命令未找到，检查 Homebrew 的 bin 目录是否已正确加入 shell 的 PATH（通常安装 Homebrew 时已自动配置）。