読み込み中

GitHub ActionsとCode Review

レッスン 76 分
読み込み中

GitHub ActionsとCode Review

定型的な作業を任せるのに最適な場所はプルリクエストです。そこはレビューが行われ、変更が反映され、多くの雑務が存在する場所です。ここでClaudeに作業させる方法は2つあり、それぞれ異なる問題を解決します。1つは有効化するだけのマネージドサービス、もう1つは自分で設定するGitHub Actionです。両方を順に見ていき、どちらを使うべきかを整理しましょう。

マネージドな方法:Code Review

最もシンプルな選択肢はCode Reviewです。これはAnthropicがホストするサービスで、Claude GitHub appを通じてプルリクエストをレビューします。自分で構築したりホストしたりする必要はありません。有効化するだけで、該当する行にインラインコメントとして指摘を投稿し始めます。

Claude組織のOwnerが、Claude Codeの管理設定からこれを有効化します。「Code review」セクションに「Allow code review」というスイッチがあり、これがセットアップの開始点です。

そこからOwnerはClaude GitHub appをインストールし、どのリポジトリを監視するかを選び、実行タイミングを決めます。OwnerがGitHub組織のオーナーも兼ねていない場合は、まず誰かがアプリをインストールしてリンクする必要があります。タイミングにはいくつかの選択肢があります。

  • PRが開かれたときに1回
  • PRへのプッシュのたびに
  • 誰かが@claude reviewとコメントしたときのみ

有効化すると、すべてAnthropicのインフラ上で実行されます。複数のレビューエージェントが、変更行だけを切り離して見るのではなく、コードベース全体に対して差分を分析します。そして、重大度でタグ付けされたインラインコメントとして指摘を該当行に投稿し、チェックラン内にサマリーテーブルを表示します。

各指摘は、明確な説明と修正案とともに、該当行に直接Claudeからのコメントとして付きます。

良い点は、指摘を重複排除してランク付けしてくれることです。そのため、些細な指摘の山を読むのではなく、注目に値する数個の本当の問題だけを読めばよいのです。

Code Reviewがすること・しないこと

ここでの境界線について、いくつか押さえておくべき点があります。

  • PRを承認したりブロックしたりすることは一切ありません。判断は人間に委ねられます。Claudeは指摘するだけで、決めるのはあなたです。
  • 修正をプッシュすることはありません。このサービスは指摘を投稿するだけです。
  • Team PlanとEnterprise Planで利用できます。

このサービスは指摘を投稿するだけなので、それに対応するのはあなたの役目です。つまり、コードを修正してプッシュすることです。プッシュする前に修正内容を確認するには、自分のターミナルから/code-reviewを実行します。これはあなたの差分に対して独自のレビューを実行し、その--fixフラグはそのレビューの指摘を作業ツリーに適用します。

自分で構築する方法:GitHub Action

Code Reviewはレビューを処理します。作業がレビューを超える場合は、GitHub Actionの出番です。これはカスタムCI向けです。コメントからの変更実装、定期レポートの実行など、通常ならワークフローを書くような作業全般です。これはPRコメント、スケジュールされたジョブ、任意のGitHubイベントに対してエージェントを実行します。

セットアップはClaude Code内から始めます。/install-github-appコマンドを実行してください。これにはリポジトリのadmin権限が必要です。このスラッシュコマンドは、GitHub appのインストールと、リポジトリへのAnthropic APIキーシークレットの設定を順に案内してくれます。

アクション自体はanthropics/claude-code-action@v1です。実際に使う入力項目は次のとおりです。

  • anthropic_api_key — 実行がClaude APIを呼び出す場合に必要です。ただしclaude_code_oauth_token(Claudeサブスクリプションから取得)またはワークロード・アイデンティティ連携(Claude Consoleのサービスアカウントから設定するため、シークレットの保存は不要)で認証する場合は不要です。以下のクラウドプロバイダーを使う場合は使用されません。
  • github_token — オプションです。指定しなければ、アクションはセットアップ時にインストールしたClaude GitHub appとして認証されます。このトークンを渡すのは、それを上書きしたい場合のみです。
  • trigger_phrase — アクションがコメント内で待ち受ける文字列です。デフォルトは@claudeです。
  • use_bedrock / use_vertex / use_foundry — Claude APIの代わりにAmazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundryのいずれかを経由して実行を行い、APIキーではなくクラウドアカウントでサインインします。
  • prompt — 自動実行の指示です。これを設定すると、Claudeはメンションを待たずにそのイベントで実行されます。指定しなければ、アクションはトリガーフレーズを待ちます。
  • claude_args — Claude Codeにそのまま渡されるCLI引数の文字列です。

@claudeに反応するワークフロー

.github/workflows/claude.yamlにワークフローを配置すると、PRコメントとissueコメント上の@claudeを監視します。ファイル全体は次のとおりです。id-token: write権限により、アクションはClaude GitHub appとしてサインインできます。

yaml
name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          claude_args: "--max-turns 5 --model claude-sonnet-5"

これで、誰かがプルリクエストに@claude implement the spec in the linked Linear issueと書くと、アクションがそれを拾います。Claudeはコミットをプッシュし、自分が行ったことを説明するコメントを投稿します。

スケジュールで実行されるワークフロー

同じアクションは、日次のまとめレポートにも使えます。例えば9:00 UTCにcronトリガーが発火し、アクションがあなたのpromptを実行し、そのランのログでまとめを読むことができます。スケジュール実行では自動的にコメントは投稿されません。また、workflow_dispatchトリガーを追加すれば、Actionsタブから手動で起動することもできます。

yaml
name: Daily report
on:
  schedule:
    - cron: "0 9 * * *"
  workflow_dispatch:
jobs:
  report:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      issues: read
      id-token: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: "Generate a summary of yesterday's commits and open issues"
          claude_args: |
            --allowedTools "mcp__github__list_commits,mcp__github__list_issues"

アクションが実行されると、他のGitHubワークフローと同じように、Actionsタブでその進行状況を確認できます。

claude_argsで実行を調整する

claude_argsの行が、細かい調整を行う場所です。知っておく価値のあるいくつかのオプションを紹介します。

  • --max-turns 5は、エージェントループに上限を設け、無限に実行され続けないようにします。
  • 権限モード。無人実行のジョブでは、確認のために停止しないようにしたいはずです。なぜなら、答える人が誰もいないからです。
  • 許可するツール。ジョブには必要最小限のものだけを与えましょう。レポートの場合、それは読み取り専用を意味します。

どちらを使うべきか

要点をまとめると次のとおりです。

  • PRレビューには、マネージドな方法を選びましょう。Code Reviewを有効化し、GitHub appにインラインの指摘を投稿させ、その後コードを修正してプッシュします。
  • 作業がレビューを超える場合は、アクションを選びましょう。セットアップには/install-github-appを使い、@claudeメンション用に1つ、cron用に1つのワークフローを用意し、細かい調整はすべてclaude_argsで行います。

まずはマネージドサービスから始めましょう。Claudeに単にコメントさせるだけでなく、CI内で実際に何かを行わせる必要が出てきた時点で、アクションに移行してください。