### [macOS和Linux安装Claude Code：终端配置指南](https://alyyhw.com/article/2011)

**Published:** 2026-07-13T04:28:49

**Author:** AI菜鸟网

**Excerpt:** macOS 和 Linux 安装 Claude Code 的核心在于终端环境是否干净、PATH 是否生效，以及你是用官方脚本还是 Homebrew、apt、dnf、apk 等方式维护版本。

相较于 Windows，macOS 和 Linux 安装 Claude Code 一般更直接，但真正影响体验的不是安装那一刻，而是之后命令是否在 PATH 里、更新方式是否清楚、以及你在多套 shell 配置之间有没有把环境搞乱。一次装对，后面省很多排障时间。

## 官方要求先看清

按照官方高级安装文档，macOS 需要 13.0 以上；Linux 方面至少支持 Ubuntu 20.04+、Debian 10+、Alpine 3.19+ 等主流发行版。硬件建议为 4GB 以上内存、x64 或 ARM64 处理器，并且必须能联网。Shell 支持 Bash、Zsh、PowerShell 或 CMD；在 macOS 和多数 Linux 环境里，重点就是 Bash 或 Zsh。

## 最推荐的安装方式

官方推荐原生命令安装。macOS、Linux 和 WSL 都可以直接运行：

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

这个方式的好处是简单，并且官方说明原生安装会自动在后台更新，适合想保持最新版的人。

## Homebrew 与系统包管理器怎么选

如果你习惯把开发工具都交给包管理器维护，可以使用 Homebrew：

```
brew install --cask claude-code
```

官方还提供 `claude-code@latest`，它跟最新发布通道走得更近；普通的 `claude-code` 更偏稳定。需要注意的是，Homebrew 安装不会自动更新，后续要手动执行升级。Linux 用户还可以根据发行版使用 apt、dnf 或 apk，这更适合团队统一镜像或脚本化装机。

## 安装完成后要做的终端检查

1.  重新打开终端。
2.  执行 `claude --version`。
3.  如果命令不存在，先检查 `~/.local/bin` 是否在 PATH 中。
4.  确认你平时使用的 shell 是 Bash 还是 Zsh，再改对应配置文件。

macOS 默认常见是 Zsh，Linux 常见是 Bash。官方排障页也给了思路：如果 PATH 没生效，就把 `$HOME/.local/bin` 加到对应 shell 配置中，再重新加载。

## 多终端环境的实用建议

如果你同时使用系统终端、iTerm2、tmux、VS Code 内置终端或远程 SSH，会遇到一个常见情况：某个地方能跑 `claude`，另一个地方却不行。原因通常是各终端启动 shell 的方式不同，导致读取的配置文件不一致。最稳妥的做法是只在主配置文件里维护 PATH，不要到处复制粘贴。

## Linux 服务器上的两个高频问题

第一是网络下载受限，尤其在企业服务器或海外镜像受限环境里，要先确认能访问官方下载域名。第二是内存不足，官方排障页专门提到低内存 Linux 服务器上安装过程可能被系统杀掉，这时需要释放内存或增加 swap，而不是无脑重试。

## 版本维护建议

很多团队忽略了“安装后怎么跟版本”这个问题。原生安装会自动后台更新，更适合个人日常使用；而 Homebrew 或系统包管理器更方便纳入团队脚本，但需要你自己规划升级节奏。一个常见的稳妥做法是：个人机器用原生安装保持新特性，服务器或受控开发镜像用包管理器固定版本。这样既能降低环境漂移，也不会因为某次自动更新打乱团队节奏。

如果你经常在本地、远程机和容器之间切换，还要记得把“当前版本从哪里来”这件事搞清楚。很多看似偶发的问题，最后都追到环境版本不一致；团队若会在 CI 镜像、开发容器和个人电脑之间共享脚本，更应该把安装来源和升级责任写进内部说明。

如果你的环境经常跨本地机、远程机和容器切换，建议在说明文档里固定记录安装来源、当前版本和升级节奏。这样当某台机器行为不一致时，你能更快判断是工具问题还是环境漂移。

## 什么时候该用 WSL 而不是原生 Linux 安装思路

如果你实际上是在 Windows 上开发 Linux 环境项目，那这篇文章里的终端配置思路仍然适用，但最好直接在 WSL 中安装并使用 Claude Code，而不要跨系统混用路径。WSL 被官方视为与 Linux 类似的安装目标，使用体验通常比“Windows 原生装好后再远程操作 Linux 仓库”更稳定。

## 避坑清单

-   安装后不重开终端，误判为命令不可用。
-   把 PATH 写进错误的配置文件，比如用 Zsh 却只改了 Bash 配置。
-   同时混用稳定版和 latest 版本，不知道当前到底跑的是谁。
-   服务器网络受限，却一直把问题归因到安装脚本。
-   远程环境和本地终端各改一套配置，最终无法复现。

## 总结

macOS 和 Linux 安装 Claude Code 的重点不是命令本身，而是终端配置和后续维护方式。装好之后，建议继续完成 [登录与访问配置](/claude-code-04)，再通过 [大型项目读取方法](/claude-code-07) 提前优化日常使用习惯。

**Tags:** Claude Code, Linux, macOS, 终端配置

**Categories:** AI编程, Claude Code教程

---