Claude Codeは、対話型のAIエージェントとして単体でも強力ですが、GitHub Actionsと連携させた瞬間に”開発チーム運用のレイヤー”まで押し上がる——これが2026年の現場感覚です。
具体的には、PRを投げた瞬間にClaude Codeが自動でコードレビューを書き込む、CIが落ちたら自動で修正してPRコメントで報告する、デプロイ後の挙動を自動検証する——こういった”人間の待ち時間”を削る運用が、YAMLファイル1〜2本で現実になります。
この記事では、実際にWorkTypesLabのブログ運営と複数リポジトリで使い込んでいるワークフローの中から、汎用性が高くコピペで導入できる3つのパターンを具体的なYAMLサンプル付きで解説します。
なぜClaude Code × GitHub Actionsなのか
GitHub ActionsはAIエージェントと相性抜群
GitHub Actionsは、リポジトリに発生するイベント（PR作成、push、issue、schedule）をトリガーにして任意のコマンドを走らせるCI/CD基盤です。Claude Codeはターミナルで動く実行型AIなので、Actionsランナー上で起動してファイルを読み書き・コマンド実行・レポート生成までひと続きで完了できる。つまり、AIエージェントとイベントドリブンは本質的に噛み合うわけです。
人間が待つ時間を削るのが最大の価値
ソロ開発でもチーム開発でも、開発のボトルネックは「自分が手を動かしていない時間」です。PR投げて誰かがレビューするまで、CIが回るまで、デプロイ後の検証まで——これらが全部Claude Codeに任せられると、体感で1日あたり2〜3時間の余裕が生まれます。
必要な準備
- GitHubリポジトリ（Public / Privateどちらでも可）
- Anthropic APIキー（Claude Code／Claude API両対応）
- GitHub Actionsの基本的な読み書き（YAML文法が読める程度）
- （任意）Opus 4.6 or Sonnet 4.6のプラン加入（用途で選ぶ）
APIキーはGitHubリポジトリのSettings → Secrets and variables → Actions からANTHROPIC_API_KEYとして登録しておきます。ワークフロー側からは${{ secrets.ANTHROPIC_API_KEY }}で呼び出せます。
ワークフロー1：PR自動レビュー
概要
PRが開かれたタイミングで、Claude Codeが差分を読み込み、バグの可能性・セキュリティ懸念・可読性の観点からレビューコメントをPRに自動投稿する仕組みです。
YAMLサンプル
name: Claude Code PR Review
on:
pull_request:
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest
permissions:
pull-requests: write
contents: read
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Setup Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Run Claude Code review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
PR_NUMBER: ${{ github.event.pull_request.number }}
BASE_SHA: ${{ github.event.pull_request.base.sha }}
HEAD_SHA: ${{ github.event.pull_request.head.sha }}
run: |
claude-code --non-interactive \
--prompt "git diff $BASE_SHA $HEAD_SHA を読み、バグ・セキュリティ・可読性の観点で最も重要な3点をPR #$PR_NUMBER にコメント投稿してください。GitHub CLI (gh) は利用可能です。"
使い勝手のコツ
- 3点に絞る：Claude Codeは際限なく指摘できてしまうので、「最重要3点」と明示しておくとノイズが減る
- 差分のみ読ませる：リポジトリ全体を読ませるとコストが上がるので
git diffで範囲限定 - Sonnet 4.6を指定：このレベルのレビューはSonnetで十分。Opus はコストの割に差が出にくい
ワークフロー2：CI失敗時の自動修正
概要
テストやLintが失敗したら、Claude Codeが失敗ログを読んで修正案をコミット → PRコメントで「修正しておきました」と報告する仕組みです。毎回の軽微な修正（import漏れ、型エラー、ESLintエラー等）がゼロ工数になります。
YAMLサンプル
name: Claude Code Auto-Fix
on:
workflow_run:
workflows: ["CI"]
types: [completed]
jobs:
autofix:
if: ${{ github.event.workflow_run.conclusion == 'failure' }}
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- uses: actions/checkout@v4
with:
ref: ${{ github.event.workflow_run.head_branch }}
- name: Download failure logs
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: gh run view ${{ github.event.workflow_run.id }} --log-failed > failure.log
- name: Setup Claude Code
run: npm install -g @anthropic-ai/claude-code
- name: Auto-fix with Claude Code
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude-code --non-interactive \
--prompt "failure.log を読み、原因となっているコードを特定して最小修正を加え、git commit で反映してください。修正内容は PR コメントに投稿してください。"
- name: Push changes
run: |
git config user.name "claude-code-bot"
git config user.email "claude@anthropic.com"
git push
使い勝手のコツ
- 自動修正の範囲を限定：「最小修正」と明示しないと大規模リファクタしてしまうことがある
- 検証は人間が：自動修正後のdiffは必ず人間がレビューしてからマージする運用が安全
- 失敗ループ防止：修正後に再びCIが失敗しても自動修正を呼ばない制限をつける（例：最大3回まで）
ワークフロー3：デプロイ後の挙動自動検証
概要
デプロイ完了後にClaude Codeが本番URLにアクセスし、画面の主要な動作（ログイン・主要リンク・API応答）を確認して問題があれば通知する仕組みです。PlaywrightやcURLと組み合わせて使います。
YAMLサンプル
name: Post-Deploy Smoke Test
on:
deployment_status:
jobs:
smoke:
if: ${{ github.event.deployment_status.state == 'success' }}
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Claude Code + Playwright
run: |
npm install -g @anthropic-ai/claude-code
npm install playwright
npx playwright install chromium
- name: Smoke test with Claude Code
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
DEPLOY_URL: ${{ github.event.deployment_status.target_url }}
SLACK_WEBHOOK: ${{ secrets.SLACK_WEBHOOK }}
run: |
claude-code --non-interactive \
--prompt "Playwright で $DEPLOY_URL にアクセスし、トップページが200を返すか、主要リンク3つが機能しているかを確認。問題があれば Slack Webhook ($SLACK_WEBHOOK) に通知してください。"
コスト管理のコツ
Opus 4.6とSonnet 4.6の使い分け
| 用途 | 推奨モデル | 理由 |
|---|---|---|
| PR自動レビュー | Sonnet 4.6 | 差分読解はSonnetで十分・コスト1/5 |
| CI失敗の自動修正 | Sonnet 4.6 + 難しければOpus | 簡単な修正はSonnet。フレームワーク横断ならOpus |
| デプロイ後スモークテスト | Sonnet 4.6 | 判断系タスクなのでSonnetで十分 |
| 大規模リファクタ | Opus 4.6 | 複数ファイル横断の判断が必要 |
月額予算の目安
PRレビュー10回／日＋CI修正5回／日＋スモークテスト5回／日のペースだと、Sonnet 4.6中心の運用で月額$20〜50程度で収まります。Opus混在でも$50〜100以内。人間のエンジニアの時給を考えると、ROIは圧倒的です。
よくあるハマりどころと対処
1. 権限不足でコメント投稿できない
GitHub Actionsは既定でGITHUB_TOKENの権限が絞られています。permissions:ブロックでpull-requests: writeを明示しないとレビューコメントが投稿できません。
2. 長時間ジョブでタイムアウト
Claude Codeは複雑なタスクで5〜10分かかることがあります。Actionsのデフォルトタイムアウトは6時間ですが、ジョブのtimeout-minutesで個別に15分程度に設定しておくと暴走を防げます。
3. APIキー漏洩リスク
外部PRから触れるワークフローでは、Forkからのビルドにはsecretsが渡らない設計をする。pull_request_targetではなくpull_requestを使うのが基本です。
よくある質問（FAQ）
- GitHub Actionsの料金は？
-
Publicリポジトリは無料、Privateも月2,000分まで無料枠があります。一般的な個人開発〜中小チームなら無料枠内で収まることが多いです。
- Claude CodeはどのモデルをActionsで使うのがベスト？
-
日常のPRレビュー・CI修正・スモークテストはSonnet 4.6で十分。大規模リファクタや複雑なバグ調査が必要なときだけOpus 4.6を選ぶハイブリッドが最もコスパが良いです。
- 自動修正で誤ったコードがマージされるリスクは？
-
自動マージは絶対に避け、Claude Codeは「修正PRのコミットまで」にしておき、マージは人間が判断します。加えて「最小修正」を明示することで暴走を防げます。
- GitHub以外のCIでも使える？
-
はい。GitLab CI・CircleCI・Jenkinsでも同じアプローチが可能です。Claude Codeはnpmでインストールしてターミナルで起動するだけなので、どのランナー環境でも動きます。
まとめ｜2026年の開発現場は”AI常駐チーム”が前提になる
Claude Code × GitHub Actionsの組み合わせは、個人開発から中規模チームまで幅広く効く”常駐AIレビュワー”の実装パターンです。
この記事のポイント
- PRを投げた瞬間に3点レビューが自動投稿される
- CI失敗時に最小修正＋PRコメント報告まで自動化できる
- デプロイ後の主要ページ挙動までスモークテストで確認
- Sonnet 4.6中心で月$20〜50の予算範囲に収まる
- 権限設定・タイムアウト・APIキー管理の3点に注意
まずはPRレビューの1本だけ導入して、手応えを掴んでから残り2つに広げるのが実践的な導入パスです。
コメント