在现代化的软件开发流程中，Pull Request（简称 PR，即拉取请求）是代码合并前的关键审查环节。对于使用 Claude Code 这类基于 AI 的开发者工具的用户来说，理解如何在本地工作区高效、规范地发起 PR，不仅能提升团队协作效率，还能确保代码质量。本文将针对“如何发起 PR”这一核心需求，结合 Claude Code 的工作流特点，详细拆解从代码提交到最终发起 PR 的完整步骤。
准备工作：确保代码状态整洁
在发起 PR 之前，首要任务是确保你的本地工作区处于一个干净且可追踪的状态。Claude Code 虽然能辅助生成代码，但最终的提交记录需要清晰反映变更内容。首先，你需要检查当前分支的状态。通常，建议从一个新的功能分支（Feature Branch）或修复分支（Fix Branch）进行开发，而不是直接在主分支（如 main 或 master）上修改。这有助于保持主干的稳定。
你可以使用 Git 命令查看未提交的更改。如果使用了 Claude Code 进行代码重构或功能添加，务必确认所有生成的文件都已正确保存。接着，运行 git status 来识别哪些文件被修改、新增或删除。此时，你可以根据变更的重要性，将相关文件添加到暂存区。例如，如果你只希望提交特定的功能模块，可以使用 git add filename 精确选择；若希望提交所有当前工作区的更改，则可使用 git add .。这一步骤至关重要，因为它决定了 PR 中将包含哪些具体的代码变更，避免无关文件污染提交历史。
提交代码：编写清晰的 Commit Message
代码暂存后，下一步是创建提交（Commit）。在发起 PR 之前，一个结构良好、描述清晰的 Commit Message 是专业性的体现。它帮助团队成员和未来的自己快速理解这次变更的目的。避免使用“update”、“fix”等模糊的描述，而应采用“动词+具体对象”的格式，例如“添加用户登录验证逻辑”或“修复导航栏样式错位问题”。
Claude Code 的强大之处在于它能协助你优化这些描述。你可以让 AI 分析当前的代码差异，并生成符合 Conventional Commits 规范的提交信息。在终端中输入 git commit -m "你的提交信息" 即可完成本地提交。值得注意的是，如果涉及多个不相关的逻辑变更，建议拆分为多次提交，这样每个 PR 都能聚焦于单一任务，降低代码审查的难度和风险。
推送与发起：连接远程仓库并创建 PR
当本地提交完成后，需要将代码推送到远程仓库（如 GitHub、GitLab 或 Bitbucket）。使用 git push origin <branch-name> 命令将新分支及其提交上传至服务器。如果这是你首次在该远程仓库上推送该分支，Git 可能会提示你设置上游跟踪关系，只需按照提示执行即可。
代码推送成功后，真正的“发起 PR”动作通常在网页端或通过 CLI 工具完成。以 GitHub 为例，进入你的仓库页面，系统通常会检测到刚推送的新分支，并提供一个 “Compare & pull request” 的按钮。点击后，填写 PR 标题和详细描述。标题应简洁明了，正文中应说明变更的背景、实现的方法以及测试情况。如果你使用的是支持 CLI 发起 PR 的工具链（如 GitHub CLI），也可以直接在终端输入 gh pr create --title "标题" --body "描述" 来自动化这一过程。至此，你的 PR 便正式进入代码审查流程，等待队友的反馈与合并。
本文链接：https://bf-jianli.com.cn/DeepSeek/rhfqpr-claude-codegzq/
