macOS 环境准备
安装 Claude Code、Codex 等命令行工具之前，需要先准备好命令行工具、Git 和 Node.js。
只用 Cherry Studio？
Cherry Studio 是桌面客户端，不需要命令行环境。直接去 Cherry Studio 接入。
第 1 步：打开终端
按 Cmd + Space 打开聚焦搜索，输入 终端 或 Terminal，按回车。
你会看到一个白色（或黑色）的窗口，光标在等你输入命令。后面所有命令都在这里执行。
第 2 步：安装命令行工具和 Git
macOS 不自带完整的开发工具。执行以下命令安装 Xcode 命令行工具（包含 Git）：
bash
xcode-select --install系统会弹出一个安装窗口，点击 安装，等待完成（可能需要几分钟）。
安装完成后验证：
bash
git --version应该输出 git version 2.xx.x。如果提示需要安装 Xcode，说明上一步没完成，重新执行。
第 3 步：安装 Homebrew（推荐）
Homebrew 是 macOS 最常用的包管理工具，后面安装 Node.js 时会用到。
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装过程中会提示输入密码（就是你的 Mac 登录密码），密码不会显示任何字符，直接输完后按回车。
安装完成后，按照终端输出的提示把 Homebrew 加入 PATH。Apple 芯片通常需要执行：
bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc验证：
bash
brew --version应该输出版本号（如 Homebrew 4.x.x）。如果提示 command not found: brew，说明 PATH 没有配对，重新执行上面的 echo 和 source 命令。
第 4 步：安装 Node.js
不确定要不要装？
如果你用 Claude Code 的官方脚本安装（curl -fsSL https://claude.ai/install.sh | bash）或 Homebrew 安装（brew install --cask claude-code），可以跳过 Node.js。但如果后面还想用 Codex、Gemini CLI 或其他 npm 工具，建议现在就装好。
Homebrew 安装（推荐）：
bash
brew install node手动下载安装：
从 Node.js 中文站 下载 .pkg 安装包。Apple 芯片（M1/M2/M3/M4）选 ARM64，Intel 选 x64。
安装完成后验证：
bash
node -v
npm -v应该分别显示版本号。
第 5 步：设置 npm 国内镜像（推荐）
bash
npm config set registry https://registry.npmmirror.com验证：
bash
npm config get registry应该输出 https://registry.npmmirror.com/。
最终检查
bash
git --version
node -v
npm -v三条都有版本号输出，环境就准备好了。接下来选一个工具开始配置：
常见问题
Homebrew 安装完但 brew 命令不存在？
Apple 芯片的 Homebrew 装在 /opt/homebrew/bin/，需要手动加 PATH：
bash
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrcsudo 密码输不进去？
macOS 终端输密码时不会显示任何字符（连星号都没有）。直接输完按回车即可。
npm 安装全局包时报权限错误？
用 Homebrew 安装的 Node.js 通常不会有这个问题。如果从官网下载安装的，可能需要 sudo：
bash
sudo npm install -g 包名