Codex、Claude Code 这类 AI 编程工具会让代码修改速度变快,也会让 Git 工作区更容易变乱。
这篇只讨论一个问题:使用 AI 编程工具时,如何让 Git 历史仍然清楚、可审查、可回滚。
不要让 AI 直接在主分支上探索。
推荐:
git switch main
git pull --rebase
git switch -c ai/refactor-order-validator
如果最终要合入,可以整理成正常业务分支名:
fix/order-timeout-validation
feat/github-governance-guide
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
工具命令会随版本变化,实际以你本机安装和官方文档为准。
永远先看:
git status
git diff --stat
git diff
重点检查:
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"
AI 可以帮你做第一轮风险扫描:
请审查当前 git diff。
只输出具体风险,按严重程度排序。
重点检查行为范围、测试有效性、安全风险、无关改动。
最终合入仍然由人类负责。
创建分支
-> 让 AI 修改
-> 人类审 diff
-> 拆 commit
-> 跑测试
-> AI 做第一轮 Review
-> 人类 Review
-> 开 PR
-> CI 通过后合入
提示词示例:
只修复订单超时校验问题。
不要修改接口签名,不要格式化无关文件。
完成后列出改动文件、行为变化、验证命令和风险。
Claude Code 官方文档提供了 worktree 并行会话说明,也提到可以把 Claude 作为命令行式工具接入验证流程。
建议:
.claude/ 或项目文档沉淀团队约定.env、本地配置保持谨慎,避免把敏感信息带进临时工作区清理:
git worktree list
git worktree remove ../repo-task-a
不同工具的 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 集成实践。
风险:互相覆盖文件,分支状态混乱。
建议:一个任务一个 worktree。
风险:无关文件、调试代码、配置变更混入。
建议:先 git diff --stat,再 git add -p。
风险:工具缺少团队发布、回滚、责任边界上下文。
建议:AI 可以给建议,合入决定由人负责。