Mac Vibe Coding 02：安装并管理 Codex、Claude Code、Copilot CLI
这篇的重点是 AI 编码代理。
以前 Mac 效率教程会花很多篇幅讲 Alfred、BetterTouchTool、窗口快捷键。现在这些仍然可以用，但已经不是主战场。真正影响开发效率的是：你如何把 Codex、Claude Code、GitHub Copilot CLI 这类 agent 放进一个安全、可验证、能回滚的工作流。
本文不做营销比较，只给实战配置。
先说工具定位
截至 2026-05-17，我会这样理解三类工具：
| 工具 | 适合场景 | 我的用法 |
|---|---|---|
| Codex CLI / App | 多文件修改、仓库级任务、测试驱动修改 | 主力编码代理 |
| Claude Code | 长上下文阅读、方案讨论、重构建议 | 辅助分析和复杂解释 |
| GitHub Copilot CLI | GitHub 生态、云端 agent、issue/PR 流程 | GitHub 项目协作 |
不要一上来三个都开。先选一个主力，再把其它作为补充。
1. 安装 Node 基础
这些 CLI 通常依赖 Node 或 shell 安装脚本。先确认：
node -v
npm -v
pnpm -v
如果没有：
brew install node pnpm
2. 安装 Codex CLI
OpenAI Codex CLI 官方帮助文档给出的常见安装方式是：
npm i -g @openai/codex
验证：
codex --version
登录方式以当前 CLI 提示为准。常见流程是浏览器登录 ChatGPT / OpenAI 账号。
建议先在测试目录里启动：
cd ~/Projects/labs/mac-vibe-check
codex
第一次不要直接给它复杂任务。先让它做只读检查：
请先只读这个项目，告诉我项目结构、可运行命令和潜在风险，不要修改文件。
这一步是为了确认它能正确读取项目，而不是一上来就改。
3. 安装 Claude Code
Claude Code 官方页面提供 shell 安装脚本：
curl -fsSL https://claude.ai/install.sh | bash
安装后验证：
claude --version
如果命令不存在，检查 shell 配置是否加载了安装路径：
echo $PATH
which claude
第一次使用同样建议只读：
cd ~/Projects/labs/mac-vibe-check
claude
提示：
先阅读项目，不要修改文件。请列出你认为应该补充的 README、测试和脚本。
4. 安装 GitHub Copilot CLI
GitHub 官方文档给出的安装方式是：
npm install -g @github/copilot
验证：
copilot --version
如果你已经使用 GitHub CLI，也可以先确认：
gh auth status
Copilot CLI 更适合 GitHub issue、PR、仓库上下文相关任务。不要把它只当普通聊天工具。
5. 给 AI 代理准备项目说明
在每个长期项目里，我建议放一个简短的 AGENTS.md。
示例：
# Mac Vibe Coding 02：安装并管理 Codex、Claude Code、Copilot CLI
## Project rules
- Read existing code before editing.
- Do not overwrite user changes.
- Keep changes small and scoped.
- Run tests or build before reporting completion.
- Use `rg` for search.
- Use project scripts instead of inventing new commands.
## Verification
- Frontend: run build and inspect key pages.
- Backend: run tests or health checks.
- Blog: run Hugo build before commit.
这类文件的作用不是“控制模型”，而是减少每次重复说明。
6. 每次使用前先看 Git 状态
这是硬规则。
git status --short
如果有不属于本次任务的改动，先记下来。不要让 AI 回滚它们。
我给 AI 的提示通常会包含：
当前工作区可能有我已有的改动。不要 revert、reset 或覆盖未授权文件。只修改本任务相关文件。
这比事后找回文件重要得多。
7. 一个标准 Vibe Coding 任务怎么下
不要这样说：
帮我优化一下项目。
这太模糊。
改成：
目标：把博客首页 Archive 区域的重复自动文章压缩展示。
约束：
- 不删除历史文章源文件。
- 首页可见列表要去重。
- 搜索和归档仍可找到内容。
- 修改后运行构建。
验证：
- Hugo build 通过。
- 首页里同标题重复只显示一次。
- 提交前给出变更文件列表。
AI 代理越强，越需要清楚边界。边界不清楚，它会把“优化”理解成任意重构。
8. 让 AI 先计划，再执行
对于复杂任务，我会先让它输出计划：
先不要改文件。请阅读代码并给出 3-5 步实现计划，标明要修改的文件和验证命令。
确认后再说：
按计划执行。每次只做必要修改，完成后运行验证。
这样能减少大范围误改。
9. 验证命令要具体
不要让 AI 自己猜怎么验证。你可以给它固定命令：
pnpm build
pnpm test
python -m py_compile api/server.py
bash scripts/build_blog.sh
curl -m 5 http://127.0.0.1:8081/health
前端页面还要截图或浏览器检查。构建成功不等于页面可用。
10. 提交前必须看 diff
无论 AI 说得多自信，都要看：
git diff --stat
git diff
git status --short
提交只 stage 相关文件：
git add path/to/file1 path/to/file2
git commit -m "Clear commit message"
不要无脑：
git add .
自动生成文件很多的项目尤其危险。
11. 常见坑
坑一：AI 修改了不该改的文件
预防：
- 任务开头说明文件范围。
- 提交前看
git diff --stat。 - 只 stage 指定文件。
坑二：AI 生成代码但没跑
预防：
- 提示里写明验证命令。
- 要求它报告验证结果。
- 对前端要求截图或浏览器检查。
坑三：AI 把旧工具当主线
预防：
- 明确当前技术栈。
- 明确 2026 主线是 agentic coding、CLI、IDE、浏览器验证。
- 旧工具只作为可选项。
坑四：多个 AI 工具同时改一个目录
预防：
- 同一任务只让一个代理写。
- 多代理时必须拆文件范围。
- 每个代理完成后先 commit 或至少保存 diff。
我的当前建议
如果你刚开始搭 Mac Vibe Coding 工作站：
- 先装 Codex CLI，作为主力。
- Claude Code 用来读长文档、分析架构和对比方案。
- Copilot CLI 等你 GitHub issue/PR 流程成熟后再引入。
- 每次任务必须有 Git、验证命令、明确范围。
AI 编码代理不是替代工程纪律，而是放大工程纪律。纪律越清楚，Vibe Coding 越像生产力；纪律越弱，它越像随机生成器。