Claude CodeのGitHub Actions連携でコードレビューを自動化する

はじめに

コードレビューは品質を担保する重要なプロセスですが、レビュアーの負担が大きく、ボトルネックになりがちです。Anthropicが公式に提供するclaude-code-actionを使えば、GitHub ActionsでClaude Codeを動作させ、Pull Requestの自動分析・レビュー・改善提案が可能になります。本記事では、セットアップから実践的な活用方法までを解説します。

claude-code-actionとは

Anthropicが公式に提供するGitHub Actionで、以下の機能を備えています。

PRの自動分析: 差分を読み取り、問題点や改善点を自動コメント
@claudeメンション対応: PR上で@claudeと呼びかけると応答
Issue対応: Issueへの自動対応・実装提案
カスタムプロンプト: チーム固有のレビュー基準を設定可能

セットアップ方法

方法1: ガイド付きセットアップ（推奨）

Claude Codeターミナルで以下を実行すると、対話式でセットアップが進みます。

/install-github-app

方法2: 手動セットアップ

ステップ1: APIキーの設定

リポジトリの Settings > Secrets に以下を追加します。

ANTHROPIC_API_KEY=sk-ant-xxxxx

ステップ2: ワークフローファイルの作成

.github/workflows/claude-review.ymlを作成します。

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
  issue_comment:
    types: [created]

jobs:
  review:
    runs-on: ubuntu-latest
    permissions:
      contents: read
      pull-requests: write
      issues: write
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          model: claude-sonnet-4-5-20250929

実践的な活用パターン

パターン1: セキュリティレビューの自動化

PRオープン時に、セキュリティ観点で自動レビューを実施します。

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    prompt: |
      このPRの差分をセキュリティ観点でレビューしてください。
      以下をチェックしてください:
      - SQLインジェクション
      - XSS
      - 認証・認可の不備
      - 機密情報の漏洩リスク
      問題があればコメントで指摘してください。

パターン2: コーディング規約チェック

prompt: |
  以下のコーディング規約に準拠しているかレビューしてください。
  - TypeScriptの厳密な型定義
  - エラーハンドリングの適切な実装
  - コメントは日本語で記述
  - 関数は50行以内

パターン3: @claudeメンションによる対話

PR上で質問やリクエストができます。

@claude このPRのパフォーマンスへの影響を分析してください
@claude テストが不足しているケースを指摘してください
@claude このアプローチの代替案を提案してください

認証方式の選択

claude-code-actionは複数の認証方式に対応しています。

方式	設定	適用場面
Anthropic API	`anthropic_api_key`	最もシンプル
Amazon Bedrock	`use_bedrock: true`	AWSインフラ利用時
Google Vertex AI	`use_vertex: true`	GCPインフラ利用時

コスト管理のポイント

モデル選択: 日常のレビューはSonnetで十分。複雑な分析時のみOpusを使用
トリガー制御: すべてのPRではなく、特定のラベルやパスに限定する
プロンプト最適化: 必要な観点のみを指定し、不要な分析を省く

on:
  pull_request:
    paths:
      - "src/**"
      - "lib/**"
    types: [opened]

GitHub Agent HQとの連携

GitHubのAgent HQプラットフォームでは、Issue割り当てやPRレビューでClaudeエージェントを直接選択できます。claude-code-actionとAgent HQを組み合わせることで、開発プロセス全体にAIを統合できます。

導入効果

当社でも社内プロジェクトにclaude-code-actionを導入し、以下の効果を実感しています。

レビュー待ち時間の大幅短縮（即座にフィードバック）
セキュリティ問題の早期発見
コーディング規約の一貫性向上
人間のレビュアーがロジックや設計に集中できる

まとめ

claude-code-actionにより、コードレビューの品質と速度を両立できます。AIによるレビューは人間のレビューを置き換えるものではなく、補完するものです。機械的なチェックをAIに任せ、人間はより高度な設計判断に集中する — この分担が、チーム全体の生産性を最大化します。