my-git

Codex / Claude Code Git 实践

Codex、Claude Code 这类 AI 编程工具会让代码修改速度变快,也会让 Git 工作区更容易变乱。

这篇只讨论一个问题:使用 AI 编程工具时,如何让 Git 历史仍然清楚、可审查、可回滚。

核心原则

1. 每个任务一个分支

不要让 AI 直接在主分支上探索。

推荐:

git switch main
git pull --rebase
git switch -c ai/refactor-order-validator

如果最终要合入,可以整理成正常业务分支名:

fix/order-timeout-validation
feat/github-governance-guide

2. 多 Agent 并行用 worktree

OpenAI Codex 官方页面提到 Codex app 面向 multi-agent workflows,并支持 built-in worktrees 和 cloud environments。

Claude Code 官方文档也明确建议用 Git worktrees 隔离并行 Claude Code sessions,避免不同会话互相影响。

本地手工创建:

git worktree add ../repo-task-a -b ai/task-a
git worktree add ../repo-task-b -b ai/task-b

每个目录单独启动对应工具:

cd ../repo-task-a
codex

cd ../repo-task-b
claude

工具命令会随版本变化,实际以你本机安装和官方文档为准。

3. AI 改完先审 diff

永远先看:

git status
git diff --stat
git diff

重点检查:

4. 大 diff 先拆 commit

AI 一次改很多文件很常见,但人类不应该按大杂烩合入。

推荐拆成:

test(order): cover timeout validation
fix(order): reject expired timeout config
docs(order): explain timeout behavior

命令:

git add -p
git commit -m "test(order): cover timeout validation"
git add -p
git commit -m "fix(order): reject expired timeout config"

5. AI Review 只能做辅助

AI 可以帮你做第一轮风险扫描:

请审查当前 git diff。
只输出具体风险,按严重程度排序。
重点检查行为范围、测试有效性、安全风险、无关改动。

最终合入仍然由人类负责。

推荐工作流

创建分支
-> 让 AI 修改
-> 人类审 diff
-> 拆 commit
-> 跑测试
-> AI 做第一轮 Review
-> 人类 Review
-> 开 PR
-> CI 通过后合入

Codex 使用建议

提示词示例:

只修复订单超时校验问题。
不要修改接口签名,不要格式化无关文件。
完成后列出改动文件、行为变化、验证命令和风险。

Claude Code 使用建议

Claude Code 官方文档提供了 worktree 并行会话说明,也提到可以把 Claude 作为命令行式工具接入验证流程。

建议:

清理:

git worktree list
git worktree remove ../repo-task-a

其他 AI 工具

不同工具的 Git 集成重点不同:

工具 Git 工作流关注点
Codex sandbox、远程环境、GitHub 协作、任务日志
Claude Code worktree 隔离、并行 session、subagent 工作区
GitHub Copilot Cloud Agent Issue 到分支、提交、PR 的异步流程
Aider 自动提交、/diff/undo、本地 git-first 工作流
Cursor 多 Agent 并行、聚合 diff、人工拆分提交

详细整理见 AI 编程工具的 Git 集成实践

常见反模式

1. 同一个目录里跑多个 AI 工具

风险:互相覆盖文件,分支状态混乱。

建议:一个任务一个 worktree。

2. AI 改完直接 commit

风险:无关文件、调试代码、配置变更混入。

建议:先 git diff --stat,再 git add -p

3. 让 AI 自行决定合入

风险:工具缺少团队发布、回滚、责任边界上下文。

建议:AI 可以给建议,合入决定由人负责。

延伸阅读