GitHub Actions で Claude コードを使う方法

Claude Code と GitHub Actions でワークフローを強化する準備はできていますか？プルリクエストのレビュー、バグの修正、さらには GitHub リポジトリ内での新機能の記述まで行う AI チームメイトがいることを想像してみてください。まるで魔法のようですよね？ Anthropic の Claude Code は、GitHub Actions とシームレスに統合し、@claude という簡単なメンションでタスクを自動化することで、これを現実のものにします。Anthropic のドキュメントと GitHub リポジトリでこの素晴らしい機能を見つけましたが、これは開発者にとって画期的なものです。このチュートリアルでは、GitHub Actions で Claude Code をセットアップし、PR をレビューするワークフローを作成し、その機能を探索する方法を順を追って説明します。さあ、始めてリポジトリをよりスマートにしましょう！

💡

API の操作やプロジェクトのドキュメント作成を行っていますか？ APIdog をダウンロードして、API ドキュメントの設計、テスト、共有を効率化しましょう。Claude Code プロジェクトに最適です！

ボタン

なぜ Claude Code と GitHub Actions は素晴らしいのか？

Claude Code は、Anthropic のエージェント型コーディングツールで、ターミナルや IDE で動作し、プロのようにコードベースを理解します。GitHub Actions と組み合わせると、リポジトリ内でコードレビューを自動化し、機能を実装し、問題をトリアージする仮想的なチームメイトになります。（2025年5月現在）ベータ版ですが、すでに次のようなタスクでその能力を発揮しています。

コードレビュー: バグ、スタイル、標準について PR を分析します。
機能実装: イシューの説明を動作するコードに変換します。
バグ修正: エラーを発見して修正し、マージ可能な PR を作成します。

GitHub リポジトリ anthropics/claude-code-action では、@claude コメントでトリガーできる機能が強調されており、インタラクティブで開発者に優しいものとなっています。セットアップしましょう！

GitHub Actions 用 Claude Code のセットアップ

リポジトリを自動化する前に、環境を準備しましょう。これは初心者向けで、手早く進めます！

1. 要件の確認:

GitHub リポジトリ: シークレットとアプリを追加するには管理者アクセスが必要です。
Anthropic API キー: console.anthropic.com から取得してください。無料アカウントでも動作しますが、有料プラン (Pro/Max) ではより多くの使用量を利用できます。
システム: Git とターミナルを備えた任意の OS (macOS、Linux、WSL2 を使用した Windows)。
Claude Code CLI (セットアップにはオプション): npm install -g @anthropic-ai/claude-code でインストールします。

2. Claude GitHub アプリのインストール:

ターミナルを開いて実行します。

claude
/install-github-app

これにより、Claude GitHub アプリ (github.com/apps/claude) をリポジトリにインストールする手順が案内されます。プロンプトに従ってリポジトリを選択し、権限を承認してください。
404 エラーが発生した場合は、gh トークンを更新してください: gh auth refresh -h github.com -s workflow と実行し、再試行してください。
注意: このクイックスタートは Anthropic API ユーザー向けです。AWS Bedrock または Google Vertex AI の場合は、Anthropic のドキュメントで手動セットアップを参照してください。

3. API キーの追加:

インストール後、CLI はワークフローファイル (.github/workflows/claude.yml) を含む PR を作成します。マージする前に、Anthropic API キーを GitHub シークレットとして追加してください。
リポジトリの Settings > Secrets and variables > Actions に移動します。
Anthropic のコンソールから取得したキーを使用して、ANTHROPIC_API_KEY という名前のシークレットを追加します。
PR をマージしてワークフローをアクティブ化します。

これをテストリポジトリで10分でセットアップしました。非常にスムーズでした。

注意: API キーには常に GitHub Secrets を使用してください！

GitHub Actions で Claude Code ワークフローを作成する

次に、Claude Code が PR を自動的にレビューするように、GitHub Actions ワークフローを作成しましょう。GitHub リポジトリの anthropics/claude-code-action を使用します。

1. ワークフローファイルの作成:

/install-github-app が作成しなかった場合は、リポジトリに .github/workflows/claude.yml を手動で追加します。

name: Claude Code Review
on:
  pull_request:
    types: [opened, synchronize]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - name: Run Claude Code Review
        uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          direct_prompt: |
            Review the PR changes. Focus on code quality, potential bugs, and adherence to project standards. Suggest improvements and provide a detailed explanation.

これにより、新規または更新された PR で Claude Code がトリガーされ、コードの品質とバグをレビューします。

2. ワークフローのテスト:

ブランチに変更をプッシュして PR を開きます。Claude Code が実行され、レビューを含むコメントを投稿します（例：「main.py に潜在的なヌルポインタが見つかりました。チェックを追加することを検討してください…」）。
これを Python リポジトリでテストしたところ、Claude が型ヒントの欠落を見つけました。的確でした！

3. トリガーのカスタマイズ:

手動で制御したいですか？コメントでトリガーするようにワークフローを変更します。

on:
  issue_comment:
    types: [created]
jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

これで、@claude review this PR とコメントするとトリガーされます。

高度なタスクに Claude Code を使用する

GitHub Actions の Claude Code はレビューだけではありません。機能を実装したりバグを修正したりできます。レベルアップする方法は次のとおりです。

1. 機能の実装:

イシューを作成します：「ログインエンドポイントにユーザー認証を追加する。」
コメントします: @claude implement this feature based on the issue description.
Claude がイシューを分析し、コードを記述して PR を作成します。これを REST API で試したところ、基本的な JWT 認証設定が追加されました。素晴らしいです

2. バグの修正:

イシューでバグを説明します：「dashboard.js の TypeError。」
コメントします: @claude fix the TypeError in the user dashboard component.
Claude がイシューを見つけ、修正をプッシュして PR を開きます。

3. プロジェクト標準の追加:

リポジトリのルートに CLAUDE.md ファイルを作成してコーディング標準を定義します（例：「Python には PEP 8 を使用する」）。Claude はレビューや実装中にこれらのガイドラインを尊重します。

実装例:

1. まず、ユーザーが @Claude をタグ付けしてコメントを残し、フィードバックに対応するよう求めます。これにより、GitHub Actions を介した Claude の自動応答がトリガーされます。

2. 次に、Claude はコメントに自動的に応答し、要求されたアクション（例：API エラー処理、重複排除）を実行し、完了したタスクのチェックリストを提供します。

3. 最後に、レビュー担当者（例：フロントエンドエンジニア）が Claude による変更を承認し、プルリクエストが正常にマージされてクローズされます。これは、Claude の変更がレビューを通過したことを示します。

Claude Code の GitHub Actions 機能を探る

Claude Code をさらに活用したいですか？いくつかの便利なテクニックを紹介します。

画像分析: コメントにスクリーンショットをアップロードすると（例：@claude fix this UI bug [screenshot]）、Claude がそれを分析して修正案を提案します。視覚的なバグに最適です。
カスタムツール: Bash(git:*)、GlobTool、または MCP (Model Control Protocol) サーバーのようなツールを有効にして、高度なタスク（例：データの取得）を実行します。例については GitHub リポジトリを参照してください。
高速ランナー: Depot ランナー (runs-on: depot-ubuntu-latest) を使用すると、GitHub のデフォルトランナーと比較して、より高速で安価な実行が可能です。
SDK 統合: GitHub Actions を超えるタスクには、Claude Code SDK を使用してカスタムワークフローを構築します。

CSS のバグに対して画像分析を試したところ、Claude は修正を見事にこなしました。驚くべきことです！

まとめ: GitHub Actions で Claude Code をマスターする

よくできました！これで、GitHub Actions で Claude Code をアンロックし、コードレビューの自動化、機能の実装、バグの駆逐ができるようになりました！GitHub アプリのインストールからワークフローの作成まで、リポジトリを生産性の高い拠点にする準備が整いました。MCP ツールを追加したり、CLAUDE.md を調整したり、APIdog で API をドキュメント化したりしてみてください。X や Reddit で Claude Code の成果を共有してください。あなたの PR が輝くのを見るのが楽しみです！ハッピーコーディング！

ボタン