mac-dev-software

macOS AI Coding Agent 及开发工具安装指南

在 macOS 上安装常用的 AI coding agent 和开发环境工具，安装前自动检测已有软件并跳过。

安装软件清单

安装流程

一键安装

运行 skill 自带的安装脚本：

bash scripts/install.sh

脚本会自动完成以下所有步骤。每个步骤前会检测是否已安装，已安装则跳过。

手动安装步骤

步骤 1：安装 Homebrew

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

步骤 2：安装 iTerm2 及 AI 插件

brew install --cask iterm2

下载并安装 AI 插件：

curl -fsSL -o /tmp/iTermAI.zip \
  "https://github.com/gnachman/iterm2-website/raw/refs/heads/master/downloads/ai-plugin/iTermAI-1.1.zip"
unzip -q /tmp/iTermAI.zip -d /tmp
mv /tmp/iTermAI.app /Applications/

步骤 3：安装 Node.js 及 NVM

brew install node
brew install nvm

安装 NVM 后需按照 brew 输出的提示配置环境变量。

步骤 4：安装 Maven 和 OpenJDK 21

brew install mvn
brew install openjdk@21

将 Java 命令加入 PATH：

echo 'export PATH="/usr/local/opt/openjdk@21/bin:$PATH"' >> ~/.zshrc

注意：Apple Silicon Mac 上路径为 /opt/homebrew/opt/openjdk@21/bin，脚本会自动适配。

步骤 5：安装 OpenCode

curl -fsSL https://opencode.ai/install | bash

步骤 6：安装 Codex CLI

npm i -g @openai/codex

步骤 7：安装 Claude Code

curl -fsSL https://claude.ai/install.sh | bash

注意事项

• 脚本使用 set -euo pipefail 严格模式，遇到任何错误会立即停止
• Apple Silicon（M1/M2/M3）和 Intel Mac 的 Homebrew 安装路径不同，脚本会自动检测并适配
• 安装 Codex CLI 需要先安装 Node.js 和 npm