这是啥
从零基础 Mac到”能跑 Claude Code”的最小路径。假设你啥也没装过——连 Terminal 都没打开过。
必装（按顺序）
1. Homebrew（包管理器）
官方 setup.md 隐含前提:你用 Homebrew 装其他工具。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"装完验证:
brew --version # 应看到 Homebrew 4.x2. Node.js 和 npm
Claude Code 用 npm 装。setup.md 里 node 要求:≥ 18。
brew install node
node --version # v20+ 或 v22+
npm --version3. Git（装 Xcode Command Line Tools 会自动带上）
xcode-select --install
git --version4. Claude Code 本体
来源:setup.md + quickstart.md:
npm install -g @anthropic-ai/claude-code装完验证:
claude --version5. 首次登录
claude
# 首次进入会让你:
# a) 用 claude.ai 账号登录（推荐，走 OAuth）
# b) 或输入 API key (ANTHROPIC_API_KEY)推荐（非必需但省心）
一个好用的 Terminal
Mac 自带的 Terminal.app 够用，但体验一般。社群常用替代:
- iTerm2（免费，成熟）:
brew install --cask iterm2 - Warp（AI 原生 terminal）:
brew install --cask warp - Ghostty（新，原生渲染快）:
brew install --cask ghostty
Boris 用 iTerm2（how-boris-uses-cc.md tip 1:他用 iTerm2 开 5 个 tab 跑 5 个 Claude）。
一个好看的字体
代码等宽字体:
brew install --cask font-jetbrains-mono font-fira-codeVS Code（或类似编辑器）
虽然 Claude Code 是终端工具，但你还是要个编辑器看文件:
brew install --cask visual-studio-code开始用之前的 CLAUDE.md 最小配置
来源:claude-code-docs/memory.md + 橙书 01 第 6 章（CLAUDE.md 完全解读 已详述）。
在任何你想用 Claude Code 的项目根目录，建一个最小 CLAUDE.md:
# 项目名
## 项目简介
（一段话讲这是啥）
## 核心命令
- （你常用的命令）
## 注意事项
- （Claude 容易犯的错，遇到了就加）见 CLAUDE.md 完全解读 的完整模板。
常见问题（来自素材的散点）
“权限被拒”
Claude Code 想用工具时会弹权限窗口。不想每次都点，见 Claude Code 进阶_hooks_settings_plugins 的 permissions 段。
“API key 在哪放”
见 API Key 的安全管理——简言之，~/.zshrc 或 .env，别写进代码。
“上下文爆了”
Windows / Linux 用户
本条目只覆盖 Mac。Windows 和 Linux 差异较大（尤其 WSL 的各种坑），需要单独条目——列在 P1 批次。
陈彬视角
“环境准备”不该花超过 2 小时。如果你第一天就陷在 homebrew 装不上、nvm 冲突、权限错误里——先暂停。问一个装好过的朋友，或者换个干净账号从头装。死磕环境是新手最浪费时间的事。
另一个建议:刚开始别用 Docker 跑 Claude Code——虽然理论上能行，但调试困难。老老实实本地装，跑熟了再想别的。