GitHub Actions
コードを push したとき等に Claude が自動で動く仕組み
このページのまとめ
GitHub Actions は GitHub 上でコードの変更をきっかけに処理を自動実行する仕組みです。 Claude Code と組み合わせると、PR 作成時の自動コードレビュー・push 時のテスト自動実行・マージ後のデプロイまで自動化できます。.github/workflows/ フォルダに YAML ファイルを追加し、GitHub の Secrets に API キーを登録するだけで始められます。フックがローカル PC で動くのに対し、GitHub Actions はクラウドでチーム全員の変更に自動適用されます。
GitHub Actions の仕組み
コードをpush / PR作成
GitHub上で変更が起きたとき
Actionsが起動
.github/workflows/ のYAMLが実行される
Claudeが自動処理
レビュー・テスト・デプロイなど
クラウドで自動実行
ローカル不要。GitHubのサーバーがpush/PR/マージをトリガーに自動処理
チーム全員に適用
フックはローカルのみ。Actionsはチーム全員のコード変更に自動で適用される
YAML で簡単設定
.github/workflows/ にYAMLを追加 + Secretsに API キーを登録するだけ
| 比較項目 | フック | GitHub Actions |
|---|---|---|
| 実行場所 | 自分の PC（ローカル） | GitHub のクラウドサーバー |
| トリガー | Claude Code のイベント（保存・コミットなど） | Git の操作（push・PR・マージなど） |
| 対象 | 自分の作業のみ | チーム全員の変更に自動適用 |
| 主な用途 | Lint・フォーマット・危険コマンドのブロック | CI テスト・自動レビュー・デプロイ |
| ネットワーク不要 | オフラインでも動く | インターネット接続が必要 |
GitHub Actions で自動化できることの具体例
- PR を作成したとき→ Claude が自動でコードレビューのコメントを PR に投稿
- コードを push したとき→ テストを自動実行して結果を Slack や GitHub に通知
- マージが完了したとき→ 本番環境に自動デプロイ・リリースノートを自動生成
ワークフローファイルの記述例（Claude 自動レビュー）
PR 作成時に Claude が自動でコードレビューを行うワークフローの例です（.github/workflows/claude-review.yml）。
name: Claude Code Review
on:
pull_request: # ← PR 作成・更新時にトリガー
types: [opened, synchronize]
jobs:
review:
runs-on: ubuntu-latest # ← GitHub のクラウドサーバーで実行
steps:
- uses: actions/checkout@v4 # ← リポジトリのコードを取得
- name: Claude Code Review
uses: anthropics/claude-code-action@beta # ← Claude によるレビュー実行
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} # ← Secrets から安全に読み込むよく使われる設定パターン（レビュー・テスト・デプロイ）
PR自動レビュー
on: pull_request自動テスト実行
on: push自動デプロイ
on: push (main)GitHub Actions の導入手順（3ステップ）
YAMLを追加
.github/workflows/APIキーをSecretsに登録
ANTHROPIC_API_KEYpushして動作確認
Actionsタブでログを確認
よくある質問
GitHub Actions は無料ですか？
パブリックリポジトリは無料で利用できます。プライベートリポジトリは月ごとの無料枠を超えると課金されます（GitHub のプランによって枠は異なります）。
フックと GitHub Actions はどう使い分けますか？
フックはローカル PC 上で動き、自分の作業のみに適用されます。GitHub Actions はクラウド上で動き、チーム全員のコード変更に自動適用されます。ローカルの自動化にはフックを、リポジトリへの push・PR を起点にした処理には GitHub Actions を使い分けましょう。
API キーが漏れないよう安全に管理するには？
リポジトリの「Settings → Secrets and variables → Actions」に ANTHROPIC_API_KEY を登録し、ワークフローファイルでは ${{ secrets.ANTHROPIC_API_KEY }} 形式で参照します。コードに直接書くことは絶対に避けてください。
PR 以外にもトリガーを設定できますか？
はい。push・スケジュール実行（schedule）・Issue へのコメント（issue_comment）など様々なイベントをトリガーとして設定できます。
Actions タブでエラーが出た場合は？
Actions タブのログでエラー詳細を確認できます。よくある原因は API キーの設定漏れ・ワークフロー YAML の構文エラー・権限不足です。