Claude Code GitHub Actions 使用教程

Claude Code GitHub Actions 使用教程

Claude Code 是 Anthropic 推出的一款 Agentic Coding 工具,也被称为世界最强编程 Agent 之一。Claude Code GitHub Actions 可以将 AI 编程能力集成到你的 GitHub 工作流中,只需在 PR 或 Issue 中 @claude,即可让 Claude 自动分析代码、创建 PR、实现功能、修复 Bug。

本文档主要介绍如何通过 AceData Cloud 的代理服务,配置和使用 Claude Code GitHub Actions。

要使用 Claude Code,首先可以到 Claude Messages 服务页面 点击「Acquire」按钮,获取请求所需要的凭证:

claude code 教程
Claude Code GitHub Actions 使用教程

如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送,可以免费体验 Claude Code 服务。

  • 即时创建 PR:描述需求,Claude 自动创建完整的 Pull Request
  • 自动实现代码:在 Issue 中 @claude,将 Issue 转化为可运行代码
  • 遵循项目规范:自动读取 CLAUDE.md,遵循你的代码风格和项目规范
  • 安全可靠:代码运行在 GitHub 的 Runner 上,数据安全有保障

前往 github.com/apps/claude 将 Claude GitHub App 安装到你的仓库。

Claude Code GitHub Actions 使用教程

该 App 需要以下仓库权限:

权限 级别 说明
Contents Read & Write 修改仓库文件
Issues Read & Write 响应 Issue
Pull requests Read & Write 创建 PR 和推送变更

将 AceData Cloud 的 API 密钥添加为仓库 Secret:

  1. 进入仓库 SettingsSecrets and variablesActions
  2. 点击 New repository secret
  3. Name 填写 ANTHROPIC_API_KEY,Value 填入你在 AceData Cloud 获取的 API 令牌
  4. 点击 Add secret 保存

提示:API 令牌可在 AceData Cloud 控制台 中查看。

在仓库中创建 .github/workflows/claude.yml 文件:

name: Claude Code on: issue_comment: types: [created] pull_request_review_comment: types: [created] issues: types: [opened, assigned] pull_request: types: [opened, synchronize] jobs: claude: runs-on: ubuntu-latest steps: - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

如果需要使用 AceData Cloud 的代理 API 端点,还需要在 Workflow 中设置环境变量:

name: Claude Code on: issue_comment: types: [created] pull_request_review_comment: types: [created] jobs: claude: runs-on: ubuntu-latest steps: - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} env: ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

配置完成后,在任何 Issue 或 PR 的评论中 @claude,Claude 就会自动响应:

@claude 根据这个 Issue 的描述实现功能 @claude 审查这个 PR 的代码安全性 @claude 修复 user dashboard 组件中的 TypeError @claude 这个端点的用户认证应该怎么实现?

创建一个在 PR 打开时自动执行代码审查的 Workflow:

name: Code Review on: pull_request: types: [opened, synchronize] jobs: review: runs-on: ubuntu-latest steps: - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: "/review" claude_args: "--max-turns 5" env: ANTHROPIC_BASE_URL: "https://api.acedata.cloud"

创建定时执行的自动化任务:

name: Daily Report on: schedule: - cron: "0 9 * * *" jobs: report: runs-on: ubuntu-latest steps: - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: "生成昨天的提交摘要和未关闭 Issue 的报告" env: ANTHROPIC_BASE_URL: "https://api.acedata.cloud"
参数 说明 必填
anthropic_api_key API 密钥
prompt 给 Claude 的指令(文本或 Skill 如 /review)
claude_args 传递给 Claude Code CLI 的参数
github_token GitHub Token
trigger_phrase 自定义触发短语(默认 @claude)
claude_args: "--max-turns 5 --model claude-sonnet-4-5-"
参数 说明
–max-turns 最大对话轮次(默认 10)
–model 使用的模型
–mcp-config MCP 配置文件路径
–allowed-tools 允许的工具(逗号分隔)
–debug 启用调试输出

在仓库根目录创建 CLAUDE.md 文件,定义代码风格指南、审查标准和项目规范,Claude 会自动遵循这些规则。

  • 永远不要 将 API 密钥直接写在 Workflow 文件中
  • 始终使用 GitHub Secrets(如 ${{ secrets.ANTHROPIC_API_KEY }}
  • 限制 Action 权限为最小必要范围
  • 在合并前人工审查 Claude 的建议
  • 使用明确的 @claude 指令减少不必要的 API 调用
  • 配置合理的 --max-turns 限制对话轮次
  • 设置 Workflow 级别的超时时间
  • 使用 GitHub 的并发控制限制并行运行数
  1. 确认 Claude GitHub App 已正确安装
  2. 检查 Workflow 是否启用
  3. 确认 API 密钥已设置为仓库 Secret
  4. 确保评论中使用的是 @claude(非 /claude
  1. 确认 API 密钥有效且有足够权限
  2. 检查 Secret 名称是否正确(ANTHROPIC_API_KEY
  3. 如果使用了 ANTHROPIC_BASE_URL,确认 URL 正确

登录 AceData Cloud 控制台,即可查看当前账户的剩余额度和使用情况。

  • 📖 Claude Code GitHub Actions 官方文档
  • 📂 claude-code-action 仓库
  • 📋 Workflow 示例
  • 🔧 AceData Cloud Claude Code 服务
  • 💬 如有任何问题,欢迎通过平台客服联系我们
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/236397.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月16日 下午12:40
下一篇 2026年3月16日 下午12:40


相关推荐

关注全栈程序员社区公众号