Claude Code Action完全ガイド｜GitHub Actionsで自動コードレビューを10分で導入

PRレビューに費やす時間を、AIで短縮できる

開発チームのPRレビューには、1件あたり平均30〜60分かかると言われています。レビュアーが不在の場合、レビュー待ちでマージが遅れ、開発速度が落ちる——そうした課題を抱えるチームは少なくありません。

Claude Code Actionは、GitHub ActionsにAnthropicのAI「Claude」を組み込み、PRレビューを自動化するOSS（オープンソース）のGitHub Actionです。 PR作成時やコメントで@claudeとメンションするだけで、AIがコードを分析し、具体的な改善提案をコメントします。

設定は最短10分。本記事では、Claude Code Actionの基本概念から導入手順、実践的な活用方法まで体系的に解説します。AI活用ノウハウの最新記事はこちらからもご覧いただけます。

この記事で学べること– Claude Code Actionの仕組みと主要機能- 10分でできる導入手順（ANTHROPIC_API_KEY設定〜claude.yml配置）- レビュー精度を上げるCLAUDE.mdの書き方- GitHub Copilotとの違いと使い分け方

Claude Code Actionとは何か

Claude Code Actionは、Anthropicが公式に提供するGitHub Action（anthropics/claude-code-action）です。GitHub Actionsのワークフローに組み込むことで、PRやIssueに対してClaudeがAIとして参加し、コードレビュー・機能実装・バグ修正などのタスクを自動実行します。

2025年のリリース以降、多くの開発チームに採用され、2026年現在は@v1が安定版として使われています。

GitHub Actionsと連携するAIコードレビューの仕組み

仕組みはシンプルです。GitHubのイベント（PRオープン、コメント投稿など）をトリガーに、ワークフローが起動してAnthropicのAPIを呼び出します。ClaudeはPRの差分・コードベース・プロジェクトの設定ファイル（CLAUDE.md）を読み込み、レビューコメントを返します。

開発者がPRを作成
    ↓
GitHub Actionsがトリガー
    ↓
anthropics/claude-code-action@v1 が起動
    ↓
ClaudeがPR差分・CLAUDE.mdを分析
    ↓
レビューコメントをPRに投稿（約3〜4分）

従来の自動コードレビューツール（ESLint、SonarQubeなど）は事前定義のルールに従うのみでした。Claude Code Actionは、文脈を理解した上でコーディング規約の逸脱・バグの可能性・リファクタリング提案を自然言語で返します。

v1.0での主な変更点

Claude Code Actionは2025年末にv1.0をリリースし、いくつかの破壊的変更が加わりました。旧バージョン（@beta）からの移行時は注意が必要です。

Claude Code Actionでできること

Claude Code Actionには大きく3つのモードがあります。

コメントトリガー型レビュー（@claudeメンション）

PRまたはIssueのコメント欄で@claudeと入力すると、Claudeが起動して指示を実行します。

# PRコメント例
@claude このPRのセキュリティリスクを確認してください
@claude テストカバレッジが不十分な部分を指摘してください
@claude 依存する外部APIの呼び出し部分のエラーハンドリングをレビューしてください

活用シーン: レビュアーがClaudeに特定の観点でのチェックを依頼する場合。人間のレビュアーとAIが協調して品質を担保します。

自動レビュー型（PRオープン時に自動起動）

PR作成時に自動でClaudeがレビューを開始するよう設定できます。claude.ymlのon.pull_requestにトリガーを追加するだけです。CLAUDE.mdでレビュー方針を明確に定義することで、ノイズを減らした高品質なレビューが実現します。

on:
  pull_request:
    types: [opened, synchronize]

活用シーン: 人間のレビュー前に基本的な品質チェックを自動実施。レビュアーの工数を減らし、本質的な議論に集中できます。

Issue → PR自動生成

IssueにタスクやバグレポートをまとめてAssignし、@claudeとメンションするだけで、Claudeが必要なコード変更を含むPRを自動作成します。

# Issueコメント例
@claude このIssueの要件に従って実装してください。
既存のAPIエンドポイントのパターンに合わせること。

活用シーン: 定型的な実装タスク（CRUD処理の追加、ユニットテストの生成など）を自動化し、開発者はより創造的な業務に集中できます。

導入手順（ステップバイステップ）

実際の設定手順を説明します。所要時間は約10分です。

STEP1: APIキーの取得とシークレット設定

Anthropic APIキーの取得

1. Anthropic Consoleにアクセス
2. 「API Keys」から新しいAPIキーを発行
3. キーをメモ帳などに一時保存（再表示不可）

GitHubシークレットへの登録

1. GitHubリポジトリの「Settings」→「Secrets and variables」→「Actions」に移動
2. 「New repository secret」をクリック
3. Name: ANTHROPIC_API_KEY、Secret: 取得したAPIキーを入力して保存

注意: APIキーをコードに直接埋め込まないでください。常に${{ secrets.ANTHROPIC_API_KEY }}で参照します。

MAXサブスクリプション利用の場合（OAuth認証）

Claude MAXプランのユーザーは、ローカルで以下を実行してOAuthトークンを取得できます。

claude setup-token

取得したトークンをCLAUDE_CODE_OAUTH_TOKENとしてシークレットに登録します。APIキーの従量課金を避けたいチームに適した選択肢です。

STEP2: claude.ymlの配置

リポジトリの.github/workflows/ディレクトリにclaude.ymlを作成します。

name: Claude Code Review
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

permissions:
  contents: write
  pull-requests: write
  issues: write

jobs:
  claude:
    runs-on: ubuntu-latest
    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')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude')) ||
      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude'))
    steps:
      - name: Run Claude Code Action
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

STEP3: ワークフロー権限の設定

GitHubリポジトリの「Settings」→「Actions」→「General」で、「Workflow permissions」を「Read and write permissions」に変更します。

この設定がないと、ClaudeがPRにコメントを投稿できません。企業のGitHub Organizationでは、Organization管理者への確認が必要な場合があります。

STEP4: CLAUDE.mdでレビュールールをカスタマイズ

リポジトリのルートにCLAUDE.mdを配置することで、Claudeにプロジェクト固有のコンテキストを伝えられます。

# プロジェクトコーディング規約

## レビュー方針
- TypeScriptの型定義は必須。anyの使用は禁止
- エラーハンドリングはtry-catchではなくResult型を使用
- コメントは日本語で記述

## セキュリティチェック項目
- SQLインジェクションのリスクを確認
- 環境変数への直接アクセスは環境設定モジュールを経由すること

## 除外対象
- node_modules/以下は対象外
- *.test.tsファイルのスタイルは緩やか

CLAUDE.mdを整備することで、プロジェクト固有のルールに沿ったレビューが可能になり、汎用的なコメントによるノイズを大幅に減らせます。

GitHub Copilot・Cursorとの違い

Claude Code Actionの導入を検討する際、既存のAIコーディングツールとの違いを理解しておくことが重要です。

3ツールの機能比較表

結論: Claude Code Actionは「CI/CDパイプラインへのAI統合」に特化したツールです。IDEでのリアルタイム補完はGitHub Copilot、大規模リファクタリングはCursorという使い分けが現実的です。多くのチームでは、これらを組み合わせて使っています。

Claude Code Actionの活用事例と実践ポイント

チーム開発での効果的な運用方法

段階的な導入を推奨

いきなり全PRに自動レビューを適用するのではなく、まずコメントトリガー型から始めることをお勧めします。チームがClaude Code Actionの出力に慣れてから、自動レビューへ移行するのが安全です。

1. フェーズ1: コメントトリガー型のみ有効化（@claudeで手動起動）
2. フェーズ2: CLAUDE.mdを整備してレビュー精度を向上
3. フェーズ3: 自動レビュー型を有効化（小規模PRから適用）

CLAUDE.mdのベストプラクティス

• チームのコーディング規約を箇条書きで明記
• よく出る誤検知パターンを「除外対象」として記載
• レビューの粒度（厳格/標準/緩やか）を明示
• セキュリティチェックの優先項目を定義

コスト管理のポイント

Anthropic APIは従量課金制です。大規模なPR（差分が1,000行以上）は処理トークン数が多くなるため、コストが増加します。CLAUDE.mdで「レビュー対象ファイルをglobで限定する」設定を追加することで、不要なトークン消費を抑えられます。

# claude.ymlの追加設定例（特定ディレクトリのみレビュー）
- uses: anthropics/claude-code-action@v1
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    direct_prompt: "src/以下のTypeScriptファイルのみレビューしてください"

Amazon Bedrock版での企業利用

社内データのセキュリティポリシー上、Anthropicに直接APIリクエストを送れない企業では、Amazon Bedrock経由でClaude Code Actionを利用する選択肢があります。

- uses: anthropics/claude-code-action@v1
  with:
    use_bedrock: "true"
  env:
    AWS_REGION: ap-northeast-1
    AWS_ROLE_TO_ASSUME: ${{ secrets.AWS_ROLE_ARN }}

AWS IAMロールとGitHub OIDCを組み合わせることで、シークレット管理が不要になり、セキュリティポリシーへの準拠も容易になります。DevelopersIOの事例では、Organization全体に適用して複数リポジトリを一元管理することに成功しています。

よくある質問（FAQ）

Q. Claude Code Actionの費用はいくらかかりますか？

Anthropic APIの従量課金が発生します。1回のレビューあたり、処理するトークン数によって異なりますが、標準的なPR（200〜500行の差分）では数円〜十数円程度が目安です。MAXサブスクリプションのOAuthトークンを使う場合は、月額サブスクの範囲内で利用できます。

Q. GitHub Free/Teamプランでも使えますか？

はい。GitHub ActionsはFreeプランでも月2,000分の無料枠があります。ただし、claude.ymlのワークフロー実行時間はこの枠を消費します。Anthropic APIのコストは別途発生します。

Q. 既存のGitHub Actionsワークフローに追加できますか？

できます。anthropics/claude-code-action@v1は独立したActionとして動作するため、既存のci.ymlとは別ファイル（claude.yml）として追加するだけです。既存ワークフローへの影響はありません。

Q. レビューの精度を上げるにはどうすればよいですか？

CLAUDE.mdの整備が最も効果的です。コーディング規約・チームルール・除外対象を具体的に記載することで、汎用的なコメントが減り、プロジェクト固有の品質基準に沿ったレビューになります。また、最初の数週間は自動レビューの結果を確認しながらCLAUDE.mdを継続的に改善することをお勧めします。

Q. Amazon Bedrockを使う場合はどう設定しますか？

claude.ymlにuse_bedrock: "true"を追加し、環境変数にAWSリージョンとIAMロールのARNを設定します。AWS側ではBedrockのAnthropicモデルへのアクセス許可と、GitHubのOIDCプロバイダー設定が必要です。詳細はDevelopersIOのAmazon Bedrock版導入記事が参考になります。

まとめ

Claude Code Actionは、GitHub ActionsにAIコードレビューを組み込むためのAnthropicの公式ツールです。主なポイントをまとめます。

• @claudeのメンションで即時にAIがコードレビューを実行（約3〜4分で完了）
• ANTHROPIC_API_KEYの設定とclaude.ymlの配置だけで最短10分で導入可能
• CLAUDE.mdでプロジェクト固有のレビュールールを定義でき、精度を向上
• GitHub Copilot・Cursorとは用途が異なり、CI/CDへのAI統合に特化
• Amazon Bedrock版で企業のセキュリティポリシーにも対応可能

PRレビューの工数削減・品質均質化を目指すチームにとって、Claude Code Actionは今すぐ導入できる実用的な選択肢です。まずはコメントトリガー型から試してみることをお勧めします。