macOS / Linux 安装 Claude Code：官方脚本、Homebrew、apt 与常见坑

macOS 和 Linux 是 Claude Code 支持最顺滑的平台，但安装方式有好几种，各有取舍。本文命令均核实自 Claude Code 官方安装文档，以官方文档为准。登录与中转配置见通用安装教程，这里专注平台细节。

系统要求

• macOS 13.0 及以上；
• Linux：Ubuntu 20.04+ / Debian 10+ / Alpine 3.19+；
• 4 GB 以上内存，x64 或 ARM64（Apple Silicon 原生支持）。

方式一：官方一键脚本（推荐）

macOS 和 Linux 命令相同：

curl -fsSL https://claude.ai/install.sh | bash
claude --version

这种「原生安装」的最大好处是后台自动更新，装一次就不用管了。

方式二：Homebrew（macOS / Linux）

brew install --cask claude-code

注意官方提供两个 cask：claude-code 跟踪稳定通道（通常滞后约一周、会跳过有严重回归的版本）；claude-code@latest 跟踪最新通道。Homebrew 安装不会自动更新，要手动 brew upgrade claude-code。

方式三：Linux 包管理器

Debian/Ubuntu 可用 apt，Fedora/RHEL 用 dnf，Alpine 用 apk，具体仓库配置步骤见官方文档对应章节。

Alpine 等 musl 发行版的特殊依赖

Alpine 默认没有 bash 和 curl，直接跑安装脚本会报 not found。先装依赖：

apk add bash curl libgcc libstdc++ ripgrep

然后在 settings.json 里设置 "USE_BUILTIN_RIPGREP": "0"（ripgrep 在 community 仓库，找不到包时先把 community 源加进 /etc/apk/repositories）。

验证与诊断

claude --version   # 输出版本号即安装成功
claude doctor      # 只读诊断：安装健康度、配置文件校验、修复建议

登录（国内用户看这里）

运行 claude 后按提示登录。国内三条路线——官方订阅、官方 API Key、API 中转——的完整对比见通用安装教程。走中转路线的把这两行写进 ~/.zshrc（macOS 默认）或 ~/.bashrc（多数 Linux 默认）：

export ANTHROPIC_BASE_URL="https://你的中转地址"
export ANTHROPIC_AUTH_TOKEN="你的中转key"

中转额度在Claude 额度专区选购时认准「支持 Claude Code」；想直接订阅官方 Pro/Max 的看 Claude 成品号/代充专区。

常见坑

现象	解决
装完 claude: command not found	重开终端让 PATH 生效；仍不行检查安装脚本输出提示的 bin 目录是否在 PATH
macOS 提示无法验证开发者	用官方脚本或 Homebrew 安装一般不会遇到；遇到则检查是否从非官方渠道下载
Homebrew 版本太旧	brew upgrade claude-code，或换 claude-code@latest cask
搜索功能报错	ripgrep 缺失，见上文 Alpine 章节或官方 troubleshooting

下一步

Windows 用户看 Windows 专篇（原生 vs WSL）；想要图形界面看 Claude Desktop 桌面端教程；在 VS Code 里用看 VS Code AI 插件教程。选型犹豫先读客户端总览与选择指南。