很多团队开始用 Claude Code 辅助写代码,但真正进入协作流程时,问题往往不在“代码能不能生成”,而在“生成后怎样规范地提交并发起 PR”。本文按实战顺序说明:从本地改动、分支管理、提交信息到创建 Pull Request,并给出适合 Claude Code 工作流的检查清单。
先让 Claude Code 完成可验证的改动
在终端进入项目目录后,启动 Claude Code,并用具体任务描述让它修改代码。不要只说“帮我加功能”,而要给出目标文件、接口约束、边界情况和验收标准。比如:“在用户注册接口增加手机号格式校验,保持现有错误响应结构不变,并补充单元测试。”这样生成的 diff 更容易审查,也更容易判断改动是否真的服务于当前需求。
如果项目较大,可以要求 Claude Code 先阅读相关文件,再给出修改方案,最后再落盘。对敏感目录、配置文件、密钥文件和部署脚本,建议明确限制修改范围。生成或修改文件后,先运行项目已有检查:格式化、lint、单元测试、类型检查、构建命令。若项目没有测试,至少手动跑关键路径。只有本地验证通过,才适合进入提交流程。
用 Git 分支隔离本次 PR
建议不要直接在 main 或 master 上提交。先基于最新主干创建功能分支:
git checkout -b feature/phone-validation然后查看 Claude Code 带来的改动:
git status
git diff如果改动过多,可按文件逐个检查。删除调试输出、临时脚本、无关格式化。若某些文件只是 IDE 自动产生,确认是否应纳入版本库。提交前用 git add 只添加本次任务相关文件,避免把密钥、token、本地配置提交进去。提交信息应说明“为什么改”和“怎么验证”,不要只写“update code”。例如:
feat(user): add phone validation in register API
- validate E.164-like format before service call
- keep existing 400 error response shape
- add unit tests for valid and invalid numbers然后推送到远程:
git push -u origin feature/phone-validation如果主干已经变化,可以先拉取最新代码并处理冲突,再推送分支。冲突不要交给工具盲目覆盖,尤其是涉及业务逻辑、数据库迁移、权限判断和接口契约时,必须人工确认。
如何发起 PR:CLI 或网页两种方式
如果使用 GitHub,并且安装了 gh CLI,可以直接创建 PR:
gh pr create --base main --title "Add phone validation in register API" --body "..."如果不想用命令行,也可以打开代码托管平台,选择源分支 feature/phone-validation,目标分支 main,点击 Create pull request 或 Merge request。无论哪种方式,PR 标题应与提交主题一致,描述至少包含:改动背景、主要修改点、测试方式、影响范围、回滚方案。
针对 Claude Code 生成的代码,PR 描述中建议额外写一句“由 Claude Code 辅助生成,已人工审查并运行测试”。这不是免责,而是提醒审查者关注 AI 生成代码常见问题:幻觉接口、过度依赖未声明依赖、错误边界处理、重复逻辑、测试覆盖不足。若项目使用 issue 跟踪,可以在 PR 中关联对应任务,方便后续追溯需求来源。
PR 审查和合并前检查清单
审查者可以先看 diff 是否只围绕一个目标。Claude Code 有时会顺手重构不相关文件,最好拆成多个 PR。然后检查新增依赖是否必要,锁文件是否同步,权限和配置文件是否被误改。最后确认 CI 通过,再选择 squash、merge commit 或 rebase 等合并方式。不同团队规范不同,但核心原则是保持主干历史清晰。
常见检查清单:
- 分支是否基于最新主干,是否存在冲突。
- PR 是否只包含一个功能或修复。
- 测试是否覆盖关键分支和异常输入。
- 日志、错误码、接口契约是否保持一致。
- 是否包含敏感信息或本地环境配置。
- 是否说明如何回滚,尤其是涉及数据库迁移时。
如果审查者要求修改,不要重新让 Claude Code 盲目重写全部文件。可以把具体评论转给它:“按 review 意见只修改 src/user/validate.ts 的异常分支,保持函数签名不变”。这样能减少 diff 扩大,也更容易再次审查。修改完成后继续运行测试,追加提交,再推送更新 PR。
总结:Claude Code 能加快代码生成,但发起 PR 的关键仍是标准 Git 工作流:小步提交、本地验证、清晰分支、完整描述和人工审查。把 AI 当作生成草稿的助手,把 PR 当作质量闸门,团队才能既提速又可控。
本文链接:https://ai-claudecode.cn/jiaochen/claude-code-scdmhrhfq-pr-dmsct-pr/