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

> macOS 和 Linux 上安装 Claude Code 的所有官方方式：curl 一键脚本、Homebrew cask、Ubuntu/Debian 包管理器、Alpine 特殊依赖，以及 PATH、自动更新、claude doctor 诊断等实用细节。
> 更新于 2026-08-04 · 难度 初级 · 来源 https://aicdks.com/guides/claude-code-macos-linux-install

macOS 和 Linux 是 Claude Code 支持最顺滑的平台，但安装方式有好几种，各有取舍。本文命令均核实自 [Claude Code 官方安装文档](https://code.claude.com/docs/en/install)，以官方文档为准。登录与中转配置见[通用安装教程](/guides/install-claude-code-china)，这里专注平台细节。

## 系统要求

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

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

macOS 和 Linux 命令相同：

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

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

## 方式二：Homebrew（macOS / Linux）

```bash
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，具体仓库配置步骤见[官方文档对应章节](https://code.claude.com/docs/en/setup#install-with-linux-package-managers)。

### Alpine 等 musl 发行版的特殊依赖

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

```bash
apk add bash curl libgcc libstdc++ ripgrep
```

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

## 验证与诊断

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

## 登录（国内用户看这里）

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

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

中转额度在[Claude 额度专区](/category/api-中转与额度-claude-额度)选购时认准「支持 Claude Code」；想直接订阅官方 Pro/Max 的看 [Claude 成品号/代充专区](/category/ai-账号与服务-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）](/guides/claude-code-windows-install)；想要图形界面看 [Claude Desktop 桌面端教程](/guides/claude-desktop-guide)；在 VS Code 里用看 [VS Code AI 插件教程](/guides/vscode-ai-extensions)。选型犹豫先读[客户端总览与选择指南](/guides/ai-coding-clients-overview)。