GitHub Action 允许 Claude 在 GitHub 仓库中自动执行代码审查、Issue 修复等操作,实现云端自动化开发流程。
环境要求:
- 需要安装 Github Cli 和完成 Github 信息认证。
- Claude 账户,账户需要使用国外手机号(接码平台亦可),用来登录官方平台。
- 最好有订阅制套餐,或者找有缓存 token 机制的平台,目前该功能 token 用量还是有点大。
环境配置
GitHub CLI 安装
根据不同操作系统安装 GitHub CLI:
macOS:
bash
brew install gh
Windows:
bash
winget install --id GitHub.cli
Linux :
参考官方安装文档:GitHub CLI 安装指南
GitHub 认证流程
1. 登录
执行 gh auth login 进入认证界面,在认证界面中选择认证方式(通常选择浏览器认证),记住一次性认证码:

在登录时输入认证码,认证完成后可以执行 gh auth status 确认当前登录状态:

2. 创建仓库(可选)
如果当前项目没有代码仓库的话,需要创建仓库后,执行一次项目提交,然后再进行后续步骤。
bash
# 初始化仓库(如果还没有)
git init
git add .
git commit -m "Initial commit"
# 创建 GitHub 仓库并推送
gh repo create
git push -u origin main
3. 配置插件
启动 Claude,执行 /install-github-app 指令,安装 Claude 的 GitHub 插件。

接下来就是关联仓库和插件选择,可以通过空格按需选择 Claude 插件,这里选择全部。

4. Workflow PR 合并流程
完成配置后,会添加代码审查和 PR 助手相关的 GitHub Workflow 文件到你的代码仓库里,这里需要手动处理 Claude 自动发起的一次 Pull Request 请求,之后配置就完成了。
Open API Key 配置
这个功能本身依赖 Claude 官方的 ANTHROPIC_API_KEY,在 console.anthropic.com 上获取,需要国外信用卡,所以这一步可能会卡住,其实解决方案和本地配置一样,通过环境变量去配置 Claude 调用。
在 Claude 生成的 Workflow 工作流配置文件中,新增和本地类似的环境配置。
下面是阿里云百炼平台的示例:
yaml
# claude-code-review.yml 和 claude.yml
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} # 密钥信息配置
ANTHROPIC_BASE_URL: "https://dashscope.aliyuncs.com/apps/anthropic" # 如果该工具支持自定义 URL
ANTHROPIC_MODEL: qwen3-coder-plus
之后在 Github 上对应仓库的 Settings -> Secrets and Variables -> New repository secret 配置密钥信息,避免 ANTHROPIC_API_KEY 暴露在 workflow 文件里。

使用示例
PR 自动审查流程
通过分支修改创建 PR 合并请求后,会自动触发 Claude 审查流程。


通过 Github Workflow 会自动调用 Claude 审查助手来帮我们完成审查流程。

**注意:**目前 AI 审查只能作为辅助流程,不能过度依赖,核心功能还是建议人工介入。
Issue 修复
通过 GitHub 完成代码修复和编写操作,这样就不用挂着电脑跑程序,直接在 GitHub Workflow 中完成修改操作。
Issue 修复流程:
- 在 GitHub 上创建 Issue 描述问题
@claude自动分析 Issue 内容或者执行修复- Claude 会分析代码并创建修复分支完成任务(格式:
claude/issue-{number}-{timestamp})

- 修复完成后,会在 ISSUE 中回复进程,我们可以再通过 PR 请求合并到开发分支。

注意:
- 提示词中要带上修复(fix)或者开发(add)类似的关键词, 否则可能只会协助分析代码质量问题。
- 如果使用过程出现调用异常(无法执行修复任务),可以尝试替换 API 平台(从硅基流动换到了阿里云百炼平台跑通了)。