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

Mac 从零装好

13分钟阅读

Mac 从零装好

一句澄清：你不是在学命令行 · 你是在学”打开 VSCode · 右下角和 AI 聊天”。命令行只在前期装东西时用一会儿，真跑起来之后 95% 的时间你都在 VSCode 窗口里——和平时写 Word 差不多。

本页的真实场景：装好 VSCode + Claude Code 组合。这是陈彬和好朋友实际用的组合，不是教你当黑客。

专业版（裸 Terminal 路线 · 命令稠密）在：开发环境准备_Mac。

你装完之后的样子（先看懂目标再动手）

打开 VSCode → 左边是文件列表 → 中间是文本 → 底部一个黑框框（叫”集成终端”）就是和 Claude 对话的地方。你敲 claude 进对话，敲问题，它答，顺便帮你改文件——全在同一个窗口里。

就这样。不用背命令，不用切来切去。

第 0 步 · 认一下你的 Mac 芯片

装 VSCode 要选对版本。按 Command + 空格 → 搜 “关于本机” → 看”芯片”那一行：

  • 写着 Apple M1 / M2 / M3 / M4 → 你是 Apple Silicon（ARM）
  • 写着 Intel Core i5 / i7 / i9 → 你是 Intel

记住这个。下一步用。

第 1 步 · 装 VSCode（主战场）

去 code.visualstudio.com，首页有个大下载按钮，自动识别 Mac。

  • Apple Silicon 选 “Mac Universal” 或 “Apple silicon”
  • Intel 选 “Intel chip”
  • 实在不确定 → 选 Universal（通吃，文件稍大）

下完一个 .zip，双击解压出来的 Visual Studio Code.app 拖进应用程序文件夹。第一次打开会弹”来自互联网的应用”警告——点”打开”即可。

卡住了：下载速度慢很正常，官网在国外。耐心等，或者泡杯茶。本 wiki 不讨论网络绕行方案。

第 2 步 · 在 VSCode 里打开集成终端（之后都用它）

VSCode 打开之后，敲 Ctrl + `（Control 加反引号键 · 反引号在 Tab 键上方 · ~ 那个键不按 Shift）。窗口下方会弹出一条黑色的面板——这就是集成终端。

看到类似 chenbin@MacBook ~ % 的提示符，就对了。之后你敲的命令，都在这里敲。敲完按回车执行。

关掉了想再开：菜单栏 Terminal → New Terminal 也行。或者再按一次 Ctrl + `。

为什么不用系统 Terminal？ 可以用，但折腾——VSCode 集成终端和文件视图、Claude Code 输出在同一个窗口，来回看着方便。新手强烈建议直接在 VSCode 里用。

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

在刚才打开的终端里粘这一行，回车：

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

这是装 Homebrew——Mac 的”程序员 App Store”。过程中会让你输一次开机密码（终端里输密码不会显示字符，不是没生效，输完直接回车）。

装完 Homebrew，继续敲：

brew install node

等一两分钟，Node.js 装好。验证：

node --version    # 看到 v20.x 或更高就是对的
npm --version     # 跟着一起装好的

brew / npm 一句话：brew 装给 Mac 用的东西（App / 工具 / 字体），npm 装给 Node.js 用的东西（JS 生态里的工具）。Claude Code 是 Node 生态的，走 npm。

装不上的常见原因：

  1. 公司管控 Mac：Homebrew 会被策略拦。用个人 Mac，或者问 IT。
  2. curl 卡住：GitHub 下载有时慢，等 5 分钟重试。别死磕超过 30 分钟——超时就换个时间或问朋友。

第 4 步 · 装 Claude Code

在集成终端里敲：

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

@ 符号在开头是正常的（不是你粘错了）。@anthropic-ai/claude-code 是 npm 的命名空间写法——意思是”Anthropic 组织下的 claude-code 包”。npm 里很多包都长这样。

装完验证：

claude --version

看到版本号就成了。

装不上的常见原因：

  • EACCES: permission denied：别用 sudo，会更麻烦。最省心的办法是换 nvm / fnm 管理 Node（它们自动规避权限问题）。
  • 下载卡在 90%：换淘宝镜像：npm config set registry https://registry.npmmirror.com，然后重试。

也可以走 VSCode 插件路线（非必需）

打开 VSCode 左边栏的 Extensions 图标（四个方块那个）→ 搜 “Claude Code” → 找 Anthropic 官方的 → 装。装完 VSCode 右侧会多一个 Claude 面板，可以不敲 claude 直接用图形界面。

两种方式选一个就行。本 wiki 默认走命令行方式（claude 命令），因为新手看教程、好朋友互相 debug 时大家说的都是命令行。

第 5 步 · 第一次打开 Claude

新建一个文件夹当练习场——桌面右键”新建文件夹”，起名比如 my-first-claude。然后在 VSCode 里 File → Open Folder 打开这个文件夹。

打开 VSCode 集成终端（Ctrl + `），敲：

claude

第一次会问你登录方式：

  • (a) 用 claude.ai 账号登录（推荐）：弹浏览器走 OAuth。订阅了 Pro / Max 的直接用订阅额度。
  • (b) 输入 API key：按 token 计费，适合开发用。

新手直接走 (a)。API key 那条路等你真用到再说。

登录成功后你会看到一个 > 提示符。敲你的第一句话：

帮我在这个文件夹新建一个 hello.md · 写一首 4 行诗

回车。它会答，也会真的在文件夹里建出 hello.md。这一刻你就跑通了——从此 VSCode 里的这个黑框框就是你的 AI 工作台。

如果这步失败了看这里

  • 浏览器没弹出来：复制终端里显示的 URL 到浏览器手动打开。
  • “地区不可用” / 登录页转圈：账号层的问题，见 账号对照表 先把账号整明白。
  • command not found: claude：第 4 步 npm install 没真正成功。回去看。

推荐（装熟了再加）

装完能跑了，下面是让日常更舒服的可选件：

brew install --cask iterm2                          # 更好用的独立终端（可选）
brew install --cask font-jetbrains-mono             # 代码字体

iTerm2 是独立终端 App，有人喜欢用它代替 VSCode 集成终端。新手阶段不用纠结，集成终端够用。

我装完了下一步看哪

装完 5 步 + 跑通第一次对话，你过了最陡的那段坡。接下来常见的问题：

→ 这些 AI 创作平台我该选哪个（Claude Code · Codex · Antigravity · Hermes · OpenClaw 的区别 · 为啥本 wiki 推 Claude Code） → 第一句话说什么（还在写 · 第一次开口的示范） → 选哪个模型（Opus / Sonnet / Haiku 怎么选） → 3 · 你能让 AI 成为什么（看原型库）

陈彬视角

“环境准备”不该花超过 2 小时。陷在 Homebrew 装不上、Node 冲突、权限报错里——暂停，问一个装好过的朋友。死磕环境是新手最浪费时间的事。

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

关于 VSCode vs 其他编辑器：有人喜欢 Cursor / Zed / 纯 Terminal——都行。但好朋友群里互相帮忙 debug 时，VSCode 是最大公约数。新手阶段跟着社群走不吃亏。

关联

AI 学者 2026-04-21 · Wave 3 VSCode 主线重写 · 上一版走裸 Terminal，方向错了

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 候选 · 待合并入扫盲版末尾

关系图谱

反向链接