AI·系统·创造·人将如何自处

Mac 从零装好

10分钟阅读

Mac 从零装好

你没开过 Terminal 也没关系。这一页假设：你会用 Mac，会装 App，但从来没碰过”命令行”。读完并照做，你会在 1-2 小时内从零到”对 Claude 说第一句话”。

专业版在：开发环境准备_Mac（技术味重、命令稠密、适合已经上路的人）。这里是”第一次来的人”版本。

第 0 步 · 打开 Terminal（命令行窗口）

你要装的东西都不在 App Store 里，得在一个叫 Terminal（终端） 的黑框框里输命令。Mac 本来就自带。

三种方式任选一种：

  1. Spotlight（最快）：按 Command + 空格 调出搜索，输 “terminal”，回车。系统自带的黑底白字窗口就开了。
  2. iTerm2（装完更好用）：本页第 2 步装完 Homebrew 后 brew install --cask iterm2，之后每次用 iTerm2 代替系统 Terminal（颜色、分屏、历史都更顺手）。
  3. VSCode 内置终端：如果你装了 VSCode，菜单栏 Terminal → New Terminal，下方就出一个终端面板。好处：边看代码边敲命令，不用来回切窗口。

打开之后，窗口里会显示一行类似 chenbin@MacBook ~ % 的提示符。后面你敲的每一行命令，都从这里敲。敲完按回车执行，不用点按钮。

这一步卡住的可能：几乎没有。如果 Spotlight 搜不到 terminal，试试用 Finder 在 应用程序 → 实用工具 → 终端.app 里找。

第 1 步 · 装 Homebrew（Mac 的程序员 App Store）

brew 是啥 · 一句话：Homebrew 是 Mac 的包管理器——像 App Store 但给程序员。后面你要装的 Node、Git、iTerm2、字体、VSCode 全都走它装，一条命令搞定，比自己下 dmg 省心。

在 Terminal 里粘这一行，回车：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

装完验证：

brew --version

看到 Homebrew 4.x.x 就是好了。

装不上的 3 个常见原因

  1. 公司受控 Mac：如果你的 Mac 是公司发的、装过 MDM 管控（Jamf / Kandji / 企业证书），Homebrew 可能被策略拦。处理：问 IT 要一个不受控的开发者账号，或在个人 Mac 上装。别硬刚公司策略。
  2. sudo 密码被要但不让你输：Homebrew 装过程会弹一次系统密码窗，输你开机密码（不是 Apple ID 密码）。终端里输密码不会显示任何字符，不是没生效——输完直接回车。
  3. curl 卡住不动 / 很慢：国内访问 GitHub raw 有时慢到超时。处理：等 5 分钟再试；或者换家里的网络（办公室网络如果做了企业代理容易劫持）。本 wiki 不讨论网络绕行方案，如果多次失败去专门频道问。

救生圈：如果这一步失败了，后面全都做不了。先在这里死磕 30 分钟，超过 30 分钟没搞定就停下来问个装过的朋友，别一个人死磕一晚——这是新手最浪费时间的坑。

第 2 步 · 装 Node.js 和 npm（Claude Code 的运行环境）

Claude Code 是用 Node.js 运行的，版本要 ≥ 18。Homebrew 装好以后：

brew install node

装完验证：

node --version   # 应看到 v20.x 或 v22.x
npm --version    # 应看到 10.x 或以上

如果这步失败了看这里

  • node 装了但 node --version 找不到：关掉 Terminal 重开一个窗口（PATH 没刷新）。还不行就 brew doctor 看诊断。
  • 已经装过 nvm / n / fnm 管理器：那就用你那个管理器装 node 18+，别再用 brew 装一份，会冲突。
  • npm 也跟着装了吗：装 node 会自动带 npm，不用单独装。

第 3 步 · 装 Git（顺便把开发工具链装上）

Mac 不自带 Git。装 Xcode Command Line Tools 会顺手把 Git 装上：

xcode-select --install

会弹一个系统窗口，点”安装”，等 5-10 分钟。装完验证：

git --version   # 应看到 git version 2.x

如果这步失败了看这里

  • 弹窗没出来 / 已经装过：终端直接 git --version 看看，有就跳过这一步。
  • 下载很慢：Xcode Command Line Tools 文件不小，一两百兆。耐心等或换个网络环境再试。

第 4 步 · 装 Claude Code 本体

重头戏。用 npm 装：

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

npm 是啥 · 一句话：npm 是 Node.js 的包管理器——上一步装 node 顺手就有了。install -g 是”全局装”，装完系统任何地方都能敲 claude 命令。

@ 符号在开头是正常的（这是 npm 命名空间 · 不是打错）：@anthropic-ai/claude-code 意思是”Anthropic 组织下的 claude-code 包”。别以为自己粘错了漏了什么——@ 就应该在那里。

装完验证：

claude --version

如果这步失败了看这里

  • EACCES: permission denied（权限被拒）：别用 sudo npm install -g，会把权限搞坏更麻烦。正确做法是给 npm 全局目录改所有者，或者用 nvm / fnm 管理 node（它们自动规避这个问题）。具体看 npm 官方文档 fixing-npm-permissions。
  • command not found: npm：上一步 node 没真正装好，回第 2 步。
  • 下载卡在 90%：npm 源慢。可换 npm config set registry https://registry.npmmirror.com（淘宝镜像），然后重试。

第 5 步 · 第一次登录 Claude

在任何一个你想干活的文件夹（比如 cd ~/Desktop 进桌面），敲：

claude

第一次会让你选登录方式：

  • (a) 用 claude.ai 账号登录（推荐）：会弹浏览器，走 OAuth 授权，跟登录网站一样。适合已经订阅了 Claude Pro / Max 的人。
  • (b) 输入 API key：ANTHROPIC_API_KEY 环境变量，按 token 计费。适合做开发 / 批量调用。

新手建议：直接走 (a)。省事、不烧钱到意外、退出来重进不用重认。API key 那一路等你真的需要再说。

如果这步失败了看这里

  • 浏览器没弹出来：复制终端里显示的 URL 到浏览器手动打开。
  • “地区不可用” / 登录页转圈：看 账号对照表——账号类型和地区可用性有细分，先把账号这层整明白。
  • API key 不知道往哪放：先不急着用 API 方式；如果一定要用，见专业页 开发环境准备_Mac 的 “API Key 的安全管理” 段，千万别把 key 贴进代码提交到 GitHub。

推荐（非必需但省心）

装完上面 5 步已经能跑了。下面这些是”让日常更舒服”的可选件，跑熟了再回头加：

换个好用的 Terminal

brew install --cask iterm2

iTerm2 支持分屏、多 tab、配色主题——比系统自带 Terminal 顺手很多。Boris（Claude Code 创造者）就是 iTerm2 重度用户。

装 VSCode（看文件必备）

brew install --cask visual-studio-code

Claude Code 是终端工具，但你还是得有个编辑器看文件、改配置。VSCode 是社群最通用的选择。

装一套好看的等宽字体

brew install --cask font-jetbrains-mono font-fira-code

代码字体对眼睛友好很多。装完在 iTerm2 / VSCode 设置里选一下。

我装完了下一步看哪

装完 5 步 + 跑通第一次 claude 登录，你已经过了最陡的那一段坡。下一步：

→ 第一句话说什么（还在写 · 第一次对 Claude 开口的可抄示范） → 选哪个模型（Opus / Sonnet / Haiku 怎么选） → 3 · 你能让 AI 成为什么（看原型库，想象你能搭什么）

陈彬视角

“环境准备”不该花超过 2 小时。如果你第一天就陷在 Homebrew 装不上、Node 冲突、权限错误里——先暂停。问一个装好过的朋友，或者换个干净账号从头装。死磕环境是新手最浪费时间的事。

另一个建议：刚开始别用 Docker 跑 Claude Code——虽然理论上能行，但调试困难。老老实实本地装，跑熟了再想别的。

关联

AI 学者 2026-04-20 · Wave 2 扫盲扩写 · 源页：开发环境准备_Mac · 扩写增量约 70%

关系图谱

反向链接