Claude Code Media
122,711中級

Claude Code × GitHub 完全ガイド|PRレビュー・CI/CDを自動化する手順

Claude Code と GitHub を連携してPRレビュー・Issue対応・CI/CDを自動化する方法を解説。GitHub App / Actions / MCP の3つの統合パターンを実装サンプル付きで紹介します。

By claude-code-media 編集部

Claude Code と GitHub を連携すると、PR の自動レビュー・Issue から PR ドラフト生成・CI/CD でのコード品質チェック を非エンジニアでも実装できます。本記事では3つの統合パターン(GitHub App / Actions / MCP)の使い分けと、実機検証済みのセットアップ手順を解説します。

「人手のコードレビューが追いつかない」「Issue が溜まり続ける」問題を、Claude Code が24時間体制で1次対応できる状態を目指せます。

週1ニュースレター(無料)に登録すると、GitHub連携の新パターンと運用Tipsが毎週木曜に届きます。

Claude Code × GitHub の統合パターンは3つ

Claude Code を GitHub と統合する方法は GitHub App / GitHub Actions / MCP の3パターンに分かれ、それぞれ向き不向きが明確です。

統合方式向いている用途セットアップ難易度
GitHub App(公式)PR の自動レビュー / Issue 対応★(10分)
GitHub ActionsCI/CD での品質チェック / セキュリティスキャン★★(30分)
MCP(Model Context Protocol)ローカルから GitHub を操作 / 私的リポジトリの分析★★(30分)

詳細は順に解説します。

GitHub App — PR レビューを自動化する最短ルート

公式 Claude GitHub App をインストールするだけで、PR コメントに @claude でメンションするとレビューが返ってきます。

セットアップ手順

  1. https://github.com/apps/claude にアクセス
  2. 「Install」をクリック → 対象リポジトリを選択
  3. PR コメントで @claude このPRをレビューして と書く

これだけで Claude が変更点を分析し、潜在的なバグ・改善案・テスト不足等を指摘します。

よくある活用パターン

  • 自動レビュー要請: PRオープン時に Webhook で自動的に @claude をメンション
  • 特定ファイルだけレビュー: @claude src/auth.ts だけ重点的に のように範囲指定
  • 改善案の提示: @claude このPRの改善案を3つ で建設的フィードバック

Claude Code Hooks と組み合わせると、ローカル開発と GitHub レビューを統一したフローに乗せられます。

GitHub Actions — CI/CD で品質ゲートに組み込む

GitHub Actions のワークフローから Claude Code CLI を呼び出すパターン。コミット時に自動的に Claude が動きます。

.github/workflows/claude-review.yml

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code
      - name: Review PR
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p "diff の品質をレビューしてマークダウンで出力" \
            < <(git diff origin/main...HEAD) \
            > /tmp/review.md
      - name: Comment on PR
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const body = fs.readFileSync('/tmp/review.md', 'utf-8');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body
            });

GitHub Secret に ANTHROPIC_API_KEY を登録するだけで稼働します。

週1ニュースレター(無料)で、Actions パターンの最新事例を継続的にキャッチアップできます。

MCP — ローカルから GitHub を操作

MCP(Model Context Protocol)mcp-server-github を使うと、ローカルの Claude Code から GitHub を直接操作できます。

セットアップ

# Claude Code 内で
/mcp add github npx @modelcontextprotocol/server-github

GitHub Personal Access Token を環境変数 GITHUB_PERSONAL_ACCESS_TOKEN に設定すれば完了です。

できること

  • リポジトリのファイル読み込み
  • Issue の作成・更新
  • PR の作成・コメント・マージ
  • GitHub Actions のステータス確認
  • リリースの作成

GitHub App と異なり、プライベートリポジトリの分析も可能なため、社内向け業務には MCP が向きます。

3パターンの使い分けまとめ

やりたいこと推奨統合方式
PR を自動レビューしたいGitHub App
CI/CD に品質ゲートを入れたいGitHub Actions
プライベートリポジトリを Claude で分析したいMCP
既存ワークフローを変えたくないGitHub App
トークン消費を最小化したいMCP(ローカル実行)

最初の1案件は GitHub App(10分でセットアップ)から始めるのが圧倒的に効率的です。

トラブルシューティング

症状原因対処
@claude メンションが反応しないApp がインストール対象外のリポジトリリポジトリ毎にインストール確認
Actions で 401ANTHROPIC_API_KEY 未設定Secrets に追加
MCP で permission deniedToken のスコープ不足repo, read:org を付与

まとめ

Claude Code と GitHub の統合は、GitHub App(PR レビュー)+ GitHub Actions(CI/CD)+ MCP(ローカル分析) の3パターンで、それぞれ用途が明確に分かれます。

  • ★ まず始めるなら GitHub App(10分)
  • ★ CI/CD強化なら GitHub Actions
  • ★ プライベート分析なら MCP

各統合の最新パターンや実装事例は 週1ニュースレター(無料)で毎週木曜に配信中です。導入後の落とし穴も先回りでカバーしています。

Claude Code × GitHub に関するよくある質問

Claude Code × GitHub に関する質問は以下の4つです。

  • 月額料金はかかりますか?
  • 大規模リポジトリでも使えますか?
  • プライベートコードを Claude に送って大丈夫ですか?
  • レビュー精度はどれくらいですか?

それぞれの回答を確認して、導入判断の参考にしてください。

Q: 月額料金はかかりますか?

A: GitHub App / Actions / MCP いずれも GitHub 側は無料です。Claude Code 側で Pro $20 / 月 または API 従量課金が必要です。詳細は 料金プラン を参照してください。

Q: 大規模リポジトリでも使えますか?

A: 使えますが、1PRあたりの差分が5,000行を超えるとトークン消費が膨らみます。Claude のコンテキストウィンドウ(200K)を意識し、@claude src/auth/ だけ のように範囲限定すると効率的です。

Q: プライベートコードを Claude に送って大丈夫ですか?

A: Anthropic のデータポリシーでは API経由のデータは学習に使われません。ただし社内規定や顧客契約で外部送信NGの場合は、MCP のローカル実行 + 機密ファイルの .claude/skip.json での除外設定を推奨します。

Q: レビュー精度はどれくらいですか?

A: シニアエンジニアの「ざっと見」レビュー相当の精度です。ロジック・型エラー・命名規則は高精度で指摘しますが、ビジネスロジック整合性は人間レビュー必須。人間の前段フィルタとして使う位置付けが妥当です。

Newsletter

この記事が役立ったら、続報を週1で

新着記事・実装事例・ツール情報を毎週木曜にお届け。いつでも配信停止可能。

ニュースレターを購読 →
Byclaude-code-media 編集部

Related

続けて読む

すべての記事 →