用途:把出厂全新或刚升级的 Mac 准备到可安装包管理器与开发工具的状态,是 Mac 开发环境搭建的第一步。Homebrew 无法在过旧 SDK 上构建,且依赖 Xcode Command Line Tools(CLT),因此需先完成本步骤。
主要能力:识别机器(sw_vers、uname -m,必要时用 sysctl -n sysctl.proc_translated 判断是否运行在 Rosetta 下);检查并更新 macOS(softwareupdate --list,或经同意执行 sudo softwareupdate --install --recommended);检查并按需安装 CLT(xcode-select -p 与 xcode-select --install),验证 git --version、clang --version;Apple Silicon 上可选安装 Rosetta 2;创建非云同步的源码目录(如 mkdir -p ~/Developer);最后运行脚本 sh "${CLAUDE_SKILL_DIR}/scripts/check.sh" 验证。
使用方式与顺序:先更新系统,再装 CLT,之后才可进入 homebrew-setup;不要并行运行 CLT 安装器与 Homebrew 安装器,否则会因竞争导致静默失败。所有检测命令可重复执行。
限制与注意:不负责安全加固(FileVault、防火墙、Touch ID sudo)、Finder/Dock/键盘偏好、安装 Homebrew 或软件包、完整 Xcode 与 iOS 模拟器,也不适用于 MDM 托管设备。softwareupdate --install 可能触发重启,须先警告并取得明确同意,不可无人值守加 --restart。Rosetta 与 CLT 安装属 Apple 签名的系统更改,需用户同意。macOS 大版本升级常使 CLT 失效,出现 invalid active developer path 时应先诊断再处理。仅支持 macOS Sonoma 14 或更新版本,以 Apple Silicon 为主,Intel 有内联说明。资料未提供具体收费与价格信息。