New Mac AI Dev 安装清单

01

必装 App

先安装这些桌面软件，是后续所有工作的基础

Claude App

日常 AI 对话和写作

Codex App

AI coding 助手

VS Code

本地代码编辑器

Linear

项目管理 & issue tracking

Notion

文档、SOP、会议记录

Google Drive

团队文件、PDF、素材、合同

02

安装 Xcode Command Line Tools

提供 Git 等基础开发工具，Mac 开发环境的必备前提

Terminal

xcode-select --install

安装完成后验证：

验证

git --version # 看到版本号即成功

03

安装 Homebrew

Mac 上最常用的软件安装工具，后续大部分工具都靠它

Terminal

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

验证

brew --version

04

安装 Git 和 GitHub CLI

代码版本管理和 GitHub 操作，协作开发必备

安装

brew install git gh

配置 Git 用户信息：

配置

git config --global user.name "Your Name" git config --global user.email "your-email@example.com"

登录 GitHub：

GitHub 登录

gh auth login

验证

git --version gh auth status

05

安装 Node / npm / npx

前端开发和 AI 工具的运行环境，Claude Code 也依赖它

安装

brew install node

验证

node --version npm --version npx --version

推荐再安装 pnpm（更快的包管理器）：

pnpm

npm install -g pnpm

06

安装 Python

脚本、数据处理、AI/ML 项目的运行环境

安装

brew install python

验证

python3 --version pip3 --version

推荐安装 uv — 比 pip 快 10–100x 的 Python 包管理器：

uv

brew install uv

07

安装 VS Code 插件

配置代码编辑器，提升开发效率

基础插件

PythonPylanceESLint PrettierTailwind CSS IntelliSense GitLensGitHub Pull RequestsMarkdown All in One

AI 插件

Claude Code

用命令一键安装全部插件：

批量安装

code --install-extension ms-python.python code --install-extension ms-python.vscode-pylance code --install-extension dbaeumer.vscode-eslint code --install-extension esbenp.prettier-vscode code --install-extension bradlc.vscode-tailwindcss code --install-extension eamodio.gitlens code --install-extension GitHub.vscode-pull-request-github code --install-extension yzhang.markdown-all-in-one code --install-extension Anthropic.claude-code

如果 code 命令不可用：在 VS Code 中按 Cmd+Shift+P，搜索 Shell Command: Install 'code' command in PATH

08

安装 Claude Code

在终端里直接用 Claude 写代码的 AI coding 工具

安装

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

验证 & 启动

claude --version claude # 第一次使用，完成初始化

09

安装 Codex CLI

OpenAI Codex 命令行工具，另一个本地 AI coding 选项

安装

curl -fsSL https://chatgpt.com/codex/install.sh | sh

验证 & 启动

codex --version codex # 第一次使用，完成初始化

10

安装常用开发工具可选

做 Supabase / Cloudflare / Vercel 项目时需要

安装

brew install supabase/tap/supabase npm install -g wrangler npm install -g vercel

验证

supabase --version wrangler --version vercel --version

11

创建开发目录

统一把代码放在 ~/dev，保持整洁

创建目录

mkdir -p ~/dev/playground ~/dev/projects ~/dev/ai-skills

~/dev/ ├── playground/ # 临时测试，随时可删 ├── projects/ # 正式项目 └── ai-skills/ # AI skills & plugins

12

测试开发环境

创建一个 Vite 项目，验证整个工具链正常运行

创建测试项目

cd ~/dev/playground npm create vite@latest ai-dev-test cd ai-dev-test npm install npm run dev

用 VS Code 打开并测试 AI 工具：

测试 AI 工具

code . # 用 VS Code 打开 claude # 测试 Claude Code codex # 测试 Codex CLI

13

最终检查清单

点击逐一核对，确认所有工具都可以运行

14

最简单安装顺序

按这个顺序来，不会踩坑

15

工具分工

每个工具负责什么，一目了然