結論: Claude CodeのGitHub連携は公式Action(anthropics/claude-code-action@v1)を使えば30分以内に設定でき、PRへの@claude メンションだけでコードレビュー・バグ修正・機能実装をAIが自動で行うようになります。
この記事の要点:
- 公式GitHub Action(2025年9月リリース)で、PR・Issueへの@claude メンションを起点に自動化が動く
- ターミナルから /install-github-app コマンド1つで基本設定が完了
- 月50本のPRなら API費用は$5未満。費用対効果が非常に高い
対象読者: GitHubを使っている開発者・テックリード・エンジニアリングマネージャー
読了後にできること: 今日中にClaude Code GitHub Actionを設定し、最初のPRレビューを自動化できる
「PRレビューの時間がなくて、レビューが積み重なっている……」
スタートアップや成長期のチームでよく聞く悩みです。先日、顧問先のCTOから「週20本以上PRが出るようになって、レビューが追いつかない。マージ待ちが平均3日になってしまった」と相談されました。
Claude Code GitHub連携を設定してから3週間後、レビューの平均待ち時間が3日から6時間に短縮されたそうです。Claudeが初期レビューを担当し、人間のレビュアーは「Claudeが指摘した点の確認」と「ビジネスロジックの判断」に集中できるようになったからです。
この記事では、設定手順から実際に使えるプロンプト5選まで、Claude Code×GitHub連携の全てを解説します。
まず試したい「5分セットアップ」— 最速インストール手順
難しいことを考える前に、まず動かしてみましょう。Claude Codeがインストール済みであれば5〜10分で完了します。
# Claude Codeのターミナルで実行するだけ
claude
# Claude Codeが起動したら
/install-github-appこのコマンドを実行すると、インタラクティブなガイドが起動します。
- GitHubアカウントの認証(ブラウザが開く)
- 対象リポジトリの選択
- GitHub Actions Secretsの自動設定(ANTHROPIC_API_KEY)
設定完了後、自動的に .github/workflows/claude.yml が生成されます。これで「PRに@claudeとコメントする」だけでClaude Codeが動く状態になります。
# 生成される .github/workflows/claude.yml の例
name: Claude Code Integration
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:
if: |
(github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
(github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude'))
runs-on: ubuntu-latest
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}Claude Code GitHub連携でできること全7選
連携後にできることを整理しました。「@claude」メンションを起点に全て動きます。
| 機能 | 使い方 | 効果 |
|---|---|---|
| PRコードレビュー | PRに@claudeとコメント | バグ・セキュリティリスク・改善点を自動指摘 |
| バグ自動修正 | 「@claude このバグを修正して」 | 修正コードをコミットしてPRに反映 |
| 機能実装 | IssueにAssign + @claude | 仕様を読んで実装してPRを作成 |
| テスト生成 | 「@claude テストコードを追加して」 | 該当関数のユニットテストを自動生成 |
| ドキュメント更新 | 「@claude READMEを更新して」 | コードの変更に合わせてドキュメントを自動更新 |
| コードベース質問 | 「@claude この関数の動作を説明して」 | コードを読んで日本語で説明 |
| リファクタリング | 「@claude この部分をリファクタして」 | コードを改善してコミット |
GitHub連携のより詳細な活用についてはAI導入戦略完全ガイドでも解説しています。
コピペ可能なプロンプト5選
プロンプト1:PRコードレビュー依頼
@claude このPRのコードレビューをお願いします。
以下の観点でレビューしてください:
1. バグや論理エラーの可能性
2. セキュリティリスク(SQLインジェクション・XSS・認証漏れ等)
3. パフォーマンス上の問題
4. コーディング規約(コメント日本語・変数名キャメルケース)の遵守
5. テストケースの網羅性
問題があれば、具体的なファイル名と行番号を示してください。
深刻度を「Critical / High / Medium / Low」で分類してください。プロンプト2:バグ修正依頼
@claude 以下のバグを修正してください。
【バグの内容】
Issue #123 で報告されたバグです。
ユーザーが大量のデータをアップロードすると、
タイムアウトエラーが発生します。
【再現手順】
1. /api/upload に100MB超のファイルをPOST
2. 30秒後にTimeoutExceptionが発生
【修正の方針】
- チャンク分割アップロードに変更する
- タイムアウト時間を120秒に延長する
- 進捗状況をレスポンスに含める
修正後、テストコードも追加してください。
仮定した点は必ず"仮定"と明記してください。プロンプト3:機能実装依頼(Issueから)
@claude このIssueの機能を実装してください。
【実装する機能】
ユーザーがメールアドレスを変更する際に、
確認メールを送信して本人確認を行う機能
【技術的な要件】
- Node.js + Express環境
- メール送信: nodemailerを使用(SMTP設定は .env から読む)
- 確認トークンの有効期限: 24時間
- トークンの保存先: Redisを使用
- 既存の認証フロー(src/auth/)と整合性を保つこと
【テスト要件】
- ユニットテスト(Jestで)のカバレッジ80%以上
- 異常系テスト(期限切れトークン・不正トークン)も含める
実装完了後、変更ファイルの一覧とテスト実行方法をコメントに追記してください。プロンプト4:テストコード自動生成
@claude src/services/payment.ts のテストコードを作成してください。
【テスト方針】
- テストフレームワーク: Jest + TypeScript
- モック: Stripe APIのモックを作成
- カバレッジ目標: 85%以上
【必ず含めるテストケース】
1. 正常系: 有効なカード情報で決済成功
2. 異常系: カード拒否・残高不足・有効期限切れ
3. 境界値: 最小金額(100円)・最大金額(999,999円)・0円
4. ネットワークエラー時の再試行ロジック
生成したテストが全て通ることを確認してからコミットしてください。プロンプト5:ドキュメント自動更新
@claude このPRの変更内容に合わせてドキュメントを更新してください。
【更新対象】
1. README.md の「API一覧」セクション
2. docs/api/reference.md の該当エンドポイントの説明
3. CHANGELOG.md に今回の変更を追記
【更新のルール】
- バージョンは package.json の version を参照
- 変更タイプ: feat(新機能)/fix(バグ修正)/breaking(破壊的変更)を明記
- 日本語で記述(コードブロックは英語可)
更新後、ドキュメントのdiffをコメントに貼ってください。GitHub Actionsとの高度な連携
CI/CDパイプラインにClaude Codeを組み込むことで、さらに高度な自動化が実現できます。
# テスト失敗時に自動でClaude Codeが修正を提案するワークフロー
name: Auto Fix on Test Failure
on:
push:
branches: [develop, feature/**]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run Tests
id: test
run: npm test
continue-on-error: true
- name: Ask Claude to Fix if Tests Failed
if: steps.test.outcome == 'failure'
uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: |
テストが失敗しました。エラーログを確認して、
失敗しているテストを修正してください。
修正後、全テストが通ることを確認してからコミットしてください。
仮定した点は必ず"仮定"と明記してください。【要注意】GitHub連携でよくある失敗パターン
失敗1:ANTHROPIC_API_KEYの設定を忘れる
❌ GitHub Actionsを設定したのに動かない → API Keyが設定されていない
⭕ GitHub Repository → Settings → Secrets and variables → Actions → ANTHROPIC_API_KEY を追加
失敗2:権限設定が不足している
❌ ClaudeがPRにコメントできない → workflowのpermissionsが不足
⭕ permissions に contents: write と pull-requests: write を必ず設定する
失敗3:プロンプトが曖昧すぎる
❌「@claude レビューして」→ 期待通りの粒度で指摘が来ない
⭕ レビュー観点・深刻度の分類・出力フォーマットを明示的に指定する
失敗4:本番リポジトリで試して重要な変更が加わる
❌ 本番ブランチでClaude Codeが自動コミットして意図しない変更が入る
⭕ まずテスト用のリポジトリや開発ブランチで試してから本番に展開する
Issue管理の効率化:Assignから実装まで全自動
GitHub連携の中でも特に強力なのが「Issueから実装まで」の自動化フローです。以下の流れで動きます。
- 開発者がIssueを作成・要件を記述
- Issueに @claude をAssignまたはメンション
- Claude Codeがコードベースを読んでIssueを理解
- 実装を行い、新しいブランチにコミット
- PRを自動作成し、Issueにリンク
この流れを使えば、簡単なバグ修正や小機能の追加は「Issueを書く→数分後にPRが上がる」という状態になります。研修先のあるスタートアップでは「ルーティン的な修正タスクをClaude Codeに任せることで、エンジニアがアーキテクチャ設計や難しい問題に集中できるようになった」と話していました。
# Issue作成時に使うテンプレート(.github/ISSUE_TEMPLATE/bug_report.md)
---
name: バグ報告
about: バグを報告して修正を依頼する
---
## バグの概要
## 再現手順
1.
2.
3.
## 期待される動作
## 実際の動作
## 技術的な補足
@claude このIssueを修正してください。
修正後はテストコードも追加し、全テストが通ることを確認してください。チームへの展開:レビュー文化の変え方
「Claude Codeがコードレビューするなんて、品質が心配」と言うレビュアーがいるチームも多いです。おすすめの展開ステップがあります。
フェーズ1(1週目): 観察モード
Claudeのレビューを「追加コメント」として活用。人間のレビュアーが最終判断を持つことを明確にする。「Claudeの指摘は参考情報、最終判断はレビュアー」というルールで不安を下げる。
フェーズ2(2〜3週目): 効率化モード
コーディング規約・セキュリティチェック・タイポ検出はClaude担当、ビジネスロジックの妥当性は人間担当と役割を分担。レビュアーの「精神的負荷」が大幅に下がる。
フェーズ3(1ヶ月後): 標準フロー化
全PRがClaudeの初期レビューを経た後に人間レビューするフローを標準化。SLAを設けてレビュー待ちを解消する。
料金の目安:月50本PRで$5未満
「APIを使うとコストが心配」という声をよく聞きますが、実際はそれほど高くありません。
事例区分: 公開情報ベースの試算
Anthropic公式および開発者コミュニティの情報をもとにした推計です。
月50本のPRレビュー(1PRあたり平均3,000トークン入力・2,000トークン出力)の場合、Claude Sonnet 4.6で月約$4〜5。Proプランの月額$20を合わせても月$25(約3,700円)程度です。レビュー工数の削減効果と比較すれば非常に低コストです。時給3,000円のエンジニアが週1時間のレビュー時間を削減するだけで、月約1.2万円のコスト削減になります。
大規模チームで月数百本のPRを扱う場合はAPI費用が増えますが、Batch APIとプロンプトキャッシュを活用することで50〜70%のコスト削減が可能です。実際の費用はAnthropicのコンソールで使用量をモニタリングしながら最適化していくことをおすすめします。
企業規模別の導入ロードマップ
GitHub連携は企業規模によって導入の優先度と進め方が変わります。
スタートアップ・小規模チーム(〜10名)
最も高い効果が出やすい規模です。PRレビューから始め、1週間で全員が使えるようにします。ルール設定はシンプルに「@claudeでレビュー依頼、マージは人間が判断」だけで十分です。
# 小規模チーム向けシンプル設定
# .claude/CLAUDE.md に以下を記載するだけでClaude Codeの挙動を統一できる
## コードレビューの方針
このリポジトリのコードをレビューする際は以下の観点で確認してください:
1. TypeScriptの型安全性(any型は禁止)
2. 非同期処理のエラーハンドリング(必ずtry-catch)
3. テストカバレッジ80%以上
4. セキュリティ: 入力値のバリデーション必須
指摘事項はGitHub形式で「Critical / Warning / Suggestion」に分類してください。中規模チーム(10〜50名)
チームごとのレビュー基準を統一することが課題になります。CLAUDE.mdでリポジトリのコーディング規約をClaude Codeに共有し、一貫したレビューを実現します。また、セキュリティチェック専用のClaude Codeワークフローを追加して、脆弱性の早期検出を標準化します。
大規模チーム・エンタープライズ(50名以上)
Enterprise TeamプランとAWS Bedrock/Vertex AI経由でのClaude Code利用を検討します。コンプライアンス要件への対応、SSO連携、利用状況の監査ログが必要になります。また、GitHub Enterprise連携では組織全体のポリシー設定が可能です。
GitHub Actions費用の最小化テクニック
Claude Code GitHub Actionsの費用は大きく「GitHub Actions実行時間」と「Claude API費用」の2種類です。コスト最適化のポイントをまとめます。
- トリガーを絞る: 全PRではなく「レビュー依頼が出たとき」か「@claudeメンションがあったとき」に限定する
- モデルを選ぶ: 大半のレビューはSonnet 4.6($3/MTok)で十分。Opus 4.6($5/MTok)は複雑な設計レビューのみ
- プロンプトキャッシュを使う: システムプロンプト(レビュー方針)を毎回送ると高い。キャッシュで入力コストを最大90%削減可能
- Batch APIを使う: 急がないドキュメント生成・テスト生成はBatch APIで50%オフ
まとめ:今日から始める3つのアクション
- 今日: Claude Codeのターミナルで /install-github-app を実行し、開発用リポジトリにGitHub Actionをセットアップする。設定後すぐに「@claude このPRのコードレビューをお願いします」とコメントして動作確認する
- 今週中: 今週出すPR 1本にClaude Codeのレビューを通してみる。「どんな指摘が来るか」を確認し、チームにとって有用かを評価する。最初は既存のレビュアーと並行して使うことで、Claudeの精度を検証できる
- 今月中: テスト自動生成(プロンプト4)・ドキュメント更新(プロンプト5)まで自動化を拡大し、チームの標準フローに組み込む。レビュー待ち時間の変化(Before/After)を記録して効果測定を行い、経営層・テックリードへの報告資料に使う
Claude CodeのGitHub連携を含む高度な活用についてはClaude Code個別研修・コーチングサービスでもご支援しています。
GitHub連携を含むClaude Code活用の詳細はClaude Code個別研修・コーチングサービスでもご相談ください。開発チーム向けのワークショップでは、実際のリポジトリを使ったハンズオンでGitHub連携の設定から運用まで習得できます。チームの開発フロー改善に課題を感じている場合は、お気軽にご相談ください。コードレビューの時間が取れない・品質に不安がある・新メンバーのオンボーディングに時間がかかるといった課題を持つ開発チームへの支援実績があります。
あわせて読みたい:
- Claude Code始め方完全ガイド — インストールから最初のタスクまで
- Claude Code Agent Teams完全ガイド — 複数Claudeを並列実行して開発を加速
- Claude Code Hooksガイド — 自動フォーマット・セキュリティゲートをCIに組み込む方法を解説
- Claude Code プロンプト集30選 — コピペ可能な業務別プロンプトをまとめて公開
関連メディア
参考・出典
- Claude Code GitHub Actions – Claude Code Docs — Anthropic公式(参照日: 2026-03-27)
- anthropics/claude-code-action · GitHub — Anthropic公式GitHub(参照日: 2026-03-27)
- Claude Code GitHub Actions: 5 Copy-Paste Workflow Recipes for CI/CD — systemprompt.io(参照日: 2026-03-27)
- Claude Code in GitHub Actions: A Complete Guide to Automated PR Fixes — Groundy(参照日: 2026-03-27)
著者: 佐藤傑(さとう・すぐる)
株式会社Uravation代表取締役。早稲田大学法学部在学中に生成AIの可能性に魅了され、X(旧Twitter)で活用法を発信(@SuguruKun_ai、フォロワー約10万人)。100社以上の企業向けAI研修・導入支援を展開。著書『AIエージェント仕事術』(SBクリエイティブ)。
ご質問・ご相談はお問い合わせフォームからお気軽にどうぞ。SoftBank IT連載7回執筆、NewsPicksで最大1,125ピックスを達成。


