Claude Code × GitHub 完全ガイド|PRレビュー・CI/CDを自動化する手順
Claude Code と GitHub を連携してPRレビュー・Issue対応・CI/CDを自動化する方法を解説。GitHub App / Actions / MCP の3つの統合パターンを実装サンプル付きで紹介します。
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 Actions | CI/CD での品質チェック / セキュリティスキャン | ★★(30分) |
| MCP(Model Context Protocol) | ローカルから GitHub を操作 / 私的リポジトリの分析 | ★★(30分) |
詳細は順に解説します。
GitHub App — PR レビューを自動化する最短ルート
公式 Claude GitHub App をインストールするだけで、PR コメントに @claude でメンションするとレビューが返ってきます。
セットアップ手順
- https://github.com/apps/claude にアクセス
- 「Install」をクリック → 対象リポジトリを選択
- 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 で 401 | ANTHROPIC_API_KEY 未設定 | Secrets に追加 |
| MCP で permission denied | Token のスコープ不足 | 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: シニアエンジニアの「ざっと見」レビュー相当の精度です。ロジック・型エラー・命名規則は高精度で指摘しますが、ビジネスロジック整合性は人間レビュー必須。人間の前段フィルタとして使う位置付けが妥当です。
Related
続けて読む
- ·10分
Claude Code 使い方 完全ガイド|非エンジニアが30分で始める手順
Claude Codeの使い方を非エンジニア向けに解説。インストール・初期設定・最初の自動化までを30分で完了するステップを実機検証付きで紹介します。
- ·11分
Claude Code Hooks 完全ガイド|自動化と品質ゲートを仕込む方法
Claude Code Hooks(PreToolUse / PostToolUse / Stop)の使い方を解説。コスト管理・品質チェック・自動フォーマットを仕込んで運用品質を担保する実装パターンを紹介します。
- ·8分
Claude Code × VSCode 統合ガイド:ターミナル不要で AI 開発を加速
Claude Code を VSCode から直接操作する方法を完全解説。公式拡張のインストール・キーバインド・MCP 連携・Cursor との比較・チーム運用ノウハウまで実装レベルで紹介します。
