macOS 安装指引
一行命令、两分钟。附带两种安装方式的差别——它决定了以后是自动更新还是要你手动升。
先确认前置条件已经对过：macOS 13.0 或更高、内存 4 GB 以上、Pro 及以上订阅。
标准做法
第一步：打开终端（Command + 空格，输入 Terminal，回车）。
第二步：复制下面这行，粘贴进去（Command + V），按回车。
curl -fsSL https://claude.ai/install.sh | bash
会看到一片文字滚动。结束时出现 Claude Code successfully installed! 就是成功了。
第三步：验证。
claude --version
正常会打印一个版本号，形如 2.1.211 (Claude Code)。
装完了。 下一步是登录授权与验证。
如果这一步报
command not found: claude：安装本身多半是成功的，只是系统还不知道去哪找它。先关掉终端窗口，重新开一个再试——这一步能解决大部分情况。仍然不行看安装故障排查。
另一种：Homebrew
如果你已经在用 Homebrew，也可以：
brew install --cask claude-code
但这两种方式有一个持续性的差别，值得先知道。
两种方式的差别只有一条：谁负责更新
| 官方安装脚本 | Homebrew | |
|---|---|---|
| 自动更新 | 有，后台静默完成 | 没有，要你自己升 |
| 手动升级 | claude update |
brew upgrade claude-code |
| 选发布通道 | 装的时候选 | 靠装哪个 cask 决定 |
推荐官方安装脚本，理由就是自动更新。
Claude Code 的迭代很快，功能几周就换一批。用 Homebrew 装的人经常在几个月后发现自己少了一堆功能——不是没有，是没升级。
Homebrew 提供两个 cask：
claude-code—— 跟随稳定通道，大约落后一周，会跳过有明显问题的版本claude-code@latest—— 跟随最新通道，一发布就有
发布通道的完整说明见版本更新、发布通道与卸载。
指定版本
一般不需要。只有一种情况用得上：某个新版本出了问题，你要退回去。
装稳定通道：
curl -fsSL https://claude.ai/install.sh | bash -s stable
装某个确定的版本：
curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89
你在安装时选的通道，会成为以后自动更新的默认通道。
更彻底的检查
claude --version 只告诉你「能跑」。想看得更细：
claude doctor
它不会启动会话，只打印一份体检报告：安装是否健康、配置文件有没有写错、有哪些警告和对应建议。
装完跑一次，以后出问题也先跑它。
不想用终端的话
Claude Code 有 macOS 桌面应用，图形界面，不需要终端。
引擎和终端版是同一套，配置也共享——同一份规则文件、同一批技能、同一套钩子。差别只在能力略少一些和界面形式。
但仍然建议先把终端版装上。 两者不冲突，而终端版是能力最完整的那个。理由见六个使用入口与三套系统提示词引擎。
本节事实查证日期：2026-08-05。 依据：官方 Advanced setup。