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

Mac 装 Claude Code · CCBP 官方最简版对照

4分钟阅读

Mac 装 Claude Code · CCBP 官方最简版对照

这是什么

AIBuilder 现有的 Mac 装机页（Mac-从零装好.md）是扫盲版——每一步都解释”为什么要这么做”，适合第一次摸终端的好朋友。

这里是 Claude Code Best Practices（CCBP） 官方维护的最简版——只说怎么做，不解释，默认你已经知道终端是什么。

两个版本对照读，好处是：你既能快速上手，又能在遇到问题时找到对应的”为什么”。

CCBP 官方最简 4 步（原文照录）

以下是 CCBP tutorial/day0/mac.md 原文，一字未改：

Terminal

  • Open Terminal (press Cmd + Space, type “Terminal”, hit Enter)

Homebrew

  • Check if Homebrew is already installed: 
    brew --version
  • If you get “command not found”, install Homebrew first: 
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Claude Code

  • brew install --cask claude-code

Verify

  • claude --version

Now head back to README.md for authentication setup.

和扫盲版的差异点

对比维度CCBP 最简版AIBuilder 扫盲版
安装路线brew install --cask claude-code（Homebrew Cask，直接装 App）npm install -g @anthropic-ai/claude-code（npm 全局包）
Node.js不需要单独装（Cask 自带运行时）需要先装 Node.js（brew install node），再走 npm
编辑器不提 VSCode，用系统 Terminal 即可以 VSCode + 集成终端为主战场，解释为何不用系统 Terminal
步骤数4 步（Terminal → Homebrew → Claude Code → Verify）6 步（芯片识别 → VSCode → 集成终端 → Node → Claude Code → 第一次对话）
出错提示无，留给读者自查每步附常见报错和排障思路（EACCES、command not found 等）

关键差异说明：两条路都能装好 Claude Code，但走向不同——

  • brew install --cask 装的是独立 App（类似从 App Store 装软件），运行时打包在里面，不需要你装 Node。
  • npm install -g 装的是 Node.js 生态下的命令行工具，需要先有 Node 环境，但后续升级更灵活（npm update -g @anthropic-ai/claude-code）。

如果你已经装好 Node，扫盲版路线没有问题。如果你只想最快跑通、不关心 Node 环境，CCBP 最简版的 brew cask 路线更省事。

遇到问题时回到扫盲版查哪一段

问题回扫盲版查
Homebrew 装不上（公司 Mac / 网络超时）第 3 步”装不上的常见原因”
claude 装完跑不了 / 权限报错第 4 步”EACCES permission denied”
第一次 claude 登录弹不出浏览器第 5 步”如果这步失败了看这里”
不知道该用 Terminal 还是 VSCode 集成终端第 2 步”为什么不用系统 Terminal”

建议

  • 第一次装：用扫盲版（Mac-从零装好.md）——每步有解释，遇坑有排障，出了问题知道往哪查。
  • 以后重装，或给朋友演示装机：用 CCBP 最简版——4 行命令，3 分钟搞定，不废话。

关联

  • 扫盲版（正本）：2-今晚跑通第一次/Mac-从零装好.md
  • 来源：CCBP tutorial/day0/mac.md（本地镜像 /Users/chenbin/Documents/Personal Kingdom/知识库/素材_AI使用/项目样本/claude-code-best-practice/github-mirror/claude-code-best-practice/tutorial/day0/mac.md）

AI 学者 2026-04-21 · B5 候选 · 待合并入扫盲版末尾

关系图谱