新 Mac 的
开荒手册

整个开荒过程是一条严格有序的管线：网络层没搭好，后面每一步的下载都会失败或慢到怀疑人生。跟着流光走一遍，心里先有全图。

// 卡在任何一步：先跳到本页最后一章「坑位速查」对症状，九成问题在那里有现成解法。

国内网络直连不了 GitHub、Homebrew、Google 字体、Claude 的服务器。我们用 Shadowrocket（本是 iOS 应用，M 系列 Mac 可以直接跑）建一条系统级隧道：它接管整台电脑的流量，终端、浏览器、所有 App 自动走隧道，不需要再单独配任何代理变量。

// TUN 模式的含义：Shadowrocket 在系统里虚拟出一张网卡，所有进程的流量先进它、再按规则分流——国内站点直连、海外站点走隧道。所以终端不需要设 http_proxy，装完即全局生效。

隧道开了不等于真的通了。打开终端（Terminal，在启动台里搜），跑下面三条命令——这是全页唯一可信的网络验证方式，之后任何时候怀疑网络，都回到这三条。

// 上面是循环演示动画。出口 IP 应该是海外 IP（不是你家宽带的 IP）；三条全部有正常返回，网络层就算毕业。

# ① 出口 IP：应返回一个海外 IP
curl https://api.ipify.org

# ② Google 可达：应返回 HTTP/2 200
curl -I https://www.google.com

# ③ Claude 可达：应返回 HTTP/2 200 或 3xx
curl -I https://claude.ai

这五步是依赖链：Homebrew 需要 Xcode 命令行工具，Node 用 Homebrew 装的 fnm 管理，pnpm 跑在 Node 上。按顺序执行，每步末尾都有「验证」命令，跑通再进下一步。

xcode-select --install

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

# 安装完执行（写入 PATH，然后重开一个终端窗口）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

brew install git
git config --global user.name "你的名字"
git config --global user.email "你的邮箱@example.com"

brew install fnm
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc
fnm install --lts
fnm default lts-latest

npm install -g pnpm

# 可选：Python 工具链（需要跑 Python 项目时再装也行）
brew install uv

Claude Code 是跑在终端里的 AI 编码 Agent，也是团队的日常主力工具。官方推荐 native 安装器（一条命令，自带自动更新，和 npm 无关）。登录需要一个 Claude 订阅账号（Pro / Max / Team）——没有的话先找管理员。

# ① 安装（native 安装器，装到 ~/.local/bin/claude）
curl -fsSL https://claude.ai/install.sh | bash

# ② 重开一个终端窗口，启动
claude

开一个全新的终端窗口（保证 PATH 都已生效），从上到下逐行执行。任何一行不符合预期，就回到对应章节重来那一步。

这些坑我们全都真实踩过。按症状找到你的情况，照方子执行即可。