← Retour aux guides

从零搭建 Claude Code 自动提交与 PR 工作流：59API 实战指南

目标与准备

将 Claude Code 接入 Git 工作流后，可以把“分析改动、生成提交说明、创建 Pull Request、补充测试说明”变成一套可重复执行的流程。本文以 GitHub 仓库为例：开发者完成代码修改后，由 Claude Code 审阅当前 diff，建议或执行 git commit，再通过 GitHub CLI 创建 PR。开始前安装 Git、Claude Code 和 GitHub CLI，并执行 gh auth login 完成 GitHub 授权；仓库应已配置 origin 远程地址。

API 成本是自动化能否长期使用的关键。59API 提供 Claude Opus、Sonnet、Haiku、Fable 及 GPT 模型的按量付费访问，接口兼容 Claude Code、Codex 和 OpenAI SDK，基础地址为 https://api.59api.com。它使用官方质量模型而非降级版本，适合把日常提交说明、PR 摘要等高频任务交给较经济的模型处理。

配置 Claude Code 使用 59API

先在 59API 创建 API Key，并将密钥保存在系统环境变量，避免写入仓库或 shell 历史。例如在 macOS 或 Linux 的终端配置 ANTHROPIC_API_KEY 为你的密钥，同时将 ANTHROPIC_BASE_URL 设置为 https://api.59api.com。重新打开终端后，在项目根目录运行 Claude Code，并让它读取当前仓库状态。

建议日常自动化优先选择 Sonnet 或 Haiku：Haiku 适合根据 diff 拟定简短提交信息，Sonnet 更适合跨文件改动、测试影响分析和 PR 描述。涉及架构重构、迁移脚本或安全敏感代码时，再显式切换 Opus，并保留人工审核。这样能让模型能力与成本匹配，而不是每次都使用最高规格。

建立可审核的提交流程

不要让 AI 直接对所有改动执行提交。先运行 git status 和 git diff --cached，确认暂存区只包含本次任务文件；再要求 Claude Code依据 Conventional Commits 生成候选信息，例如 feat(auth): add token refresh retry。提交前让它输出变更摘要、潜在风险和需要补充的测试。确认无误后，执行 git commit -m 加上生成的标题。

可以把下面规则写进项目的 Claude 指令文件：只读取当前分支和工作区；不得执行 git push、git reset、git clean 或删除文件；提交前必须展示 git diff --cached；提交信息使用 type(scope): subject 格式；测试失败时不得提交。这些约束比单纯提示“谨慎操作”更可靠，也能让团队成员得到一致结果。

自动创建高质量 PR

提交完成后，先创建语义明确的分支，例如 feat/token-refresh-retry，并推送 git push -u origin 当前分支。让 Claude Code根据与主分支的差异生成 PR 标题和正文，正文至少应含背景、主要改动、测试方式、风险与回滚方案。然后使用 gh pr create 创建 PR；传入 title、body、base main 和 head 当前分支即可。若团队使用模板，应让 Claude Code读取 .github/pull_request_template.md 并按既有栏目填充，而不是另起格式。

PR 创建后仍应运行项目既有检查，例如 npm test、npm run lint 或 CI 工作流。可以让 Claude Code解释失败日志并提出最小修复方案，但不要授权它绕过测试、关闭分支保护或自行合并 PR。对于数据库变更、权限逻辑和依赖升级，要求至少一名人工 reviewer，并在 PR 中明确迁移和回滚步骤。

生产化建议

• 将 API Key 放在本地环境变量或 CI Secret，禁止提交到 .env.example、日志和 PR 正文。
• 在 CI 中只让 AI生成摘要或评论，不授予默认写入权限；需要创建 PR 时使用范围最小的 GitHub Token。
• 为自动化设置预算和模型分级：小 diff 用 Haiku，复杂审阅用 Sonnet，关键决策才使用 Opus。
• 记录每次自动生成的提交和 PR 内容，定期检查是否出现空泛描述、遗漏测试或不准确的变更声明。

完成这套流程后，开发者仍掌握提交与合并的最终决定权，但重复性的文案、差异归纳和 PR 整理会明显加快。需要以较低成本稳定接入 Claude Code 的团队，可以注册 59API 领取按量付费额度；其推荐返利机制也适合在团队或开发者社群中长期使用。

Tarifs · Docs