1. 为什么要在 GitHub Actions 里跑 Claude Code如果你已经在本地终端用 Claude Code 写代码那/install-github-app这个命令值得花五分钟试一次。它的作用很直接把 Claude Code 从「你本地的一个 CLI 工具」变成「你仓库里一个随时待命的 AI 工程师」。装好之后你在 issue 或 PR 评论里写一句claude 帮我把这个 issue 转成 PR它就会自动拉分支、改代码、提 PR每次有人提 PR它也能自动跑一遍审查把性能、安全、边界条件的问题列出来。这套流程适合谁三类人最明显一是团队里 PR 审查经常排队、等人工 review 等到心累的二是想让 issue 自动转成代码改动的三是已经在用 GitHub Actions 做 CI想顺手把 AI 能力接进流水线的。核心检索词就三个Claude Code、GitHub Actions、认证与集成。/install-github-app是 Claude Code 内置的斜杠命令它帮你做三件事——引导安装 Claude GitHub App、自动把 API Key 写进仓库 Secret、在仓库里生成 workflow 文件。你连 YAML 都不用手写。我试过在几个小仓库上跑这套流程最直观的感受是配置门槛比想象中低但认证环节有几个坑踩过一次就记住了。下面按「前置准备 → 可复制配置 → 验证 → 排障」的顺序讲清楚。2. 前置准备TaoToken 与仓库权限在跑/install-github-app之前有两块东西要先备好一个是模型调用的凭证一个是 GitHub 仓库的管理权限。模型凭证这块我用的是 TaoToken 的 API Key。它的接入地址是https://taotoken.net/api兼容 Anthropic 的接口格式所以 Claude Code 里配置ANTHROPIC_BASE_URL指向它就能用。你需要在 TaoToken 控制台创建一个 API Key后面会把它填进 GitHub 仓库的 Secret 里命名成ANTHROPIC_API_KEY。注意这个 Key 只放在 GitHub Secrets绝对不要写进 YAML 文件或者提交到 Git。仓库权限这块/install-github-app需要你是仓库管理员admin因为安装 GitHub App 和写 Secret 都是管理员级操作。另外确认一下仓库的 Actions 是开着的Settings → Actions → General → Actions permissions 选 Allow all。Node.js 18 只在你想本地测试 workflow 时才需要纯 CI 跑不需要。注意/install-github-app目前只支持直接走 Anthropic 兼容 API 的用户。如果你用的是 AWS Bedrock、Google Vertex AI 这类企业方案得走手动配置路线命令帮不了你。3. 可复制配置settings.json 与 workflow 骨架3.1 本地 settings.json 指向 TaoTokenClaude Code 读取本地配置来知道往哪发请求。在项目根目录或用户目录下建.claude/settings.json写入下面内容。把sk-你的TaoToken密钥换成你在 TaoToken 控制台拿到的真实 Key。{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-5 } }ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_MODEL按你账号里可用的模型名填。配好之后本地claude命令就会走 TaoToken 的通道。这一步是本地验证用的CI 里用的是仓库 Secret两者分开。3.2 执行 /install-github-app进到项目目录启动 Claude Code敲命令cd your-project claude进入交互界面后输入/install-github-app终端会给你一个链接点开在浏览器里完成三件事选择要集成的仓库单个仓库或整个组织都行、确认授予anthropics/claude-code-action所需的权限、安装完成后回到终端。Claude Code 会自动把 API Key 写进仓库的 Actions Secrets并生成 workflow 文件。3.3 workflow 文件骨架/install-github-app会在.github/workflows/claude.yml生成工作流。如果你想手动建或改用下面这份骨架。它同时支持「PR 自动审查」和「claude 按需触发」两种模式。name: Claude Code on: issue_comment: types: [created] pull_request_review_comment: types: [created] issues: types: [opened, assigned] pull_request: types: [opened, synchronize] permissions: contents: write pull-requests: write issues: write jobs: claude: runs-on: ubuntu-latest timeout-minutes: 10 steps: - uses: actions/checkoutv4 with: fetch-depth: 0 - uses: anthropics/claude-code-actionv1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} prompt: | 审查这个 PR 的代码变更。重点关注 - 代码质量和规范是否与项目一致 - 是否存在性能退化问题 - 是否有潜在的安全风险 - 错误处理是否完整 claude_args: --max-turns 5几个参数值得单独说。timeout-minutes: 10防止任务无限跑--max-turns 5限制 Agent 的最大循环次数避免它陷入反复迭代烧额度prompt是给 Claude 的固定开场指令告诉它这次审查的重点。如果你不想用claude当触发词加一行trigger_phrase: ai-assistant就能换。3.4 企业方案的差异如果你的团队走 Bedrock 或 Vertexworkflow 里要换认证步骤。Bedrock 版本先配 AWS 凭证再调 action- uses: aws-actions/configure-aws-credentialsv4 with: role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }} aws-region: us-west-2 - uses: anthropics/claude-code-actionv1 with: use_bedrock: true claude_args: --model us.anthropic.claude-sonnet-4-5-20250929-v1:0Vertex 版本换成 Google 的认证 action加use_vertex: true。这两条路线不走/install-github-appSecret 也得手动配。4. 验证认证是否生效配置推上去之后怎么确认认证真的通了分两步。第一步本地验证 TaoToken 通道。在终端里直接发一个请求看返回是否正常curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-你的TaoToken密钥 \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-5, max_tokens: 64, messages: [{role: user, content: 回复 ok}] }返回里带content字段和正常文本说明 Key 和地址都对。如果返回 401是 Key 的问题返回 404多半是模型名写错了。第二步验证 GitHub 侧集成。在任意 issue 或 PR 评论里写claude 帮我分析一下这个 PR 的代码质量重点关注性能和安全性。正常情况下 30 到 60 秒内 Claude 会回复或在 PR 下发表审查评论。同时去仓库的 Actions 标签页能看到Claude Code这个 workflow 被触发并跑完。如果评论发出去了但没反应先看 Actions 里有没有运行记录——没有记录说明触发条件没匹配上有记录但失败就看日志里的报错。5. 本篇常见错排查5.1 claude 没被识别最常见的原因是评论格式。claude不能被代码块包裹否则 action 扫不到。建议写在评论第一行或单独成行这是最保险的写法。另外确认 workflow 的on里包含了issue_comment和pull_request_review_comment的created类型。5.2 Secret 里没有 ANTHROPIC_API_KEY去 Settings → Secrets and variables → Actions 看一眼。如果/install-github-app中途断了Secret 可能没写进去。手动补一个名为ANTHROPIC_API_KEY的仓库 Secret值填 TaoToken 的 Key。注意名字必须完全一致大小写敏感。5.3 workflow 文件不在正确目录文件必须在.github/workflows/下扩展名是.yml或.yaml。放在仓库根目录或者别的文件夹GitHub 不会识别。推上去之后在 Actions 页面左侧应该能看到 workflow 名字。5.4 权限不足导致写评论失败workflow 顶部的permissions块要给够contents: write、pull-requests: write、issues: write。少一个Claude 就没法在 PR 下留言或提交代码。如果仓库组织级策略限制了默认权限还得在组织设置里放开。5.5 额度消耗过快如果每次 PR 都自动审查额度掉得很快。两个办法一是改成只用claude手动触发把on里的pull_request去掉二是保留自动触发但把--max-turns调小比如--max-turns 3同时用concurrency控制并发避免多个 workflow 同时抢配额。concurrency: group: claude-${{ github.ref }} cancel-in-progress: true5.6 模型名不匹配报错ANTHROPIC_MODEL或claude_args里的模型名要和你 TaoToken 账号里可用的模型一致。写错了会返回模型不存在的错误。去 TaoToken 控制台确认一下可用模型列表再填进去。6. 把认证接进你的工作流认证打通只是起点。真正让这套东西产生价值的是把它和项目规范绑在一起——在仓库根目录放一个CLAUDE.md把团队的审查标准写进去Claude 每次在 CI 里运行都会读它## 代码审查标准 - 所有 API 端点必须有单元测试 - 禁止使用 var必须使用 const/let - 函数嵌套深度不超过 3 层 - 所有用户输入必须经过验证这样无论 PR 来自谁AI 审查的标准都一致。审查规则写一次所有 PR 自动生效。如果你还没拿到 TaoToken 的 Key先去控制台创建一个然后到 API Keys 页面管理你的凭证。想先验证模型对话是否正常可以直接在模型对话里试一句。打算长期把 Claude Code 接进编码流程和 Agent 任务的可以看下 Coding Plan 的额度方案。接入过程中遇到认证报错对照接入文档里的参数说明逐项核对多数问题出在 Base URL 或模型名上。