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

2026年3月13日

このトピックの全体像Claude Code 完全ガイド｜料金・使い方・法人導入の全体像はじめ方・学習の記事

公開日: 2026年3月13日最終更新: 2026年10月1日

公式ドキュメント・公式発表などの一次情報を確認したうえで、株式会社Nexaが執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。運営会社について

Claude Code ActionはGitHub ActionsにAIコードレビューを組み込める公式ツールで、PRレビュー工数を大幅に削減できます。

要点1: @claudeとメンションするだけでAIがPRを自動レビュー、初回レビューは約3〜4分で完了
要点2: ANTHROPIC_API_KEYとclaude.ymlを設定するだけで10分以内に導入可能
要点3: JetBrains Developer Ecosystem Survey 2026によると、Claude Codeの職場利用率は2026年半ばに39%まで上昇し、GitHub Copilot（21%）を上回った

対象: コードレビューの工数削減・品質向上を目指すテックリード・開発マネージャー

今日やること: ANTHROPIC_API_KEYをGitHubシークレットに登録し、claude.ymlをリポジトリに配置する

2026年10月1日時点の確認日: Claude Code GitHub Actionsの公式ドキュメントとGitHubリポジトリ（anthropics/claude-code-action）で内容を確認しています。

この記事の著者

株式会社Nexa 代表取締役川島陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社（旧株式会社クニエ）にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

詳しく見る AI顧問の無料相談

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年8月にv1.0をリリースし、いくつかの破壊的変更が加わりました。旧バージョン（@beta）からの移行時は、modeの入力を削除（自動検出に置き換え）、direct_promptをpromptに置き換え、max_turns・modelなどのCLIオプションをclaude_argsにまとめる対応が必要です。

項目	betaバージョン	v1.0（現在）
バージョン指定	`@beta`	`@v1`
mode設定	手動指定（review/implement等）	自動検出（不要）
認証方法	APIキーのみ	APIキー＋OAuth（MAX対応）
MAX Subscriptionサポート	非対応	対応（Pro/Max/Team/Enterprise。claude setup-tokenでOAuthトークンを発行）

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分です。

Claude Codeをローカルで使っている場合は、リポジトリ内で /install-github-app を実行するクイックセットアップが最短です。GitHub Appのインストール・シークレット登録・ワークフローファイルの配置までを対話形式で進められます（事前にgh auth loginでの認証が必要）。以下では、ローカルでClaude Codeを使っていない場合や、設定を細かく管理したい場合向けの手動セットアップを説明します。

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

Anthropic APIキーの取得

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

GitHubシークレットへの登録

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

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

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

Claude Pro・Max・Team・Enterpriseプランのユーザーは、ローカルで以下を実行して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
  id-token: write
  actions: read

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:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 1
      - name: Run Claude Code Action
        uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

id-token: write は、Claude Code ActionのデフォルトのGitHub App認証に必要な権限です。actions/checkoutを先に実行しないと、Claudeがリポジトリのファイルを参照できません。

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

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

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

STEP2のワークフローファイルのように permissions: をジョブ単位で明示している場合、この設定はデフォルトのGITHUB_TOKENの権限にのみ影響し、明示した権限のほうが優先されます。

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

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

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

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

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

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

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

AI導入に関するお困りごとは、株式会社NexaのAI顧問がサポートします。「何から始めればいいか分からない」という段階からご相談いただけます。

[AI顧問の無料相談はこちら →](https://nexa-corp.jp/ai-consultation/)

GitHub Copilot・Cursorとの違い

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

3ツールの機能比較表

比較項目	Claude Code Action	GitHub Copilot	Cursor
動作環境	GitHub Actions（CI/CD）	IDE拡張	フルIDE
主なユースケース	PR自動レビュー・自動化	リアルタイム補完	複雑なリファクタリング
トリガー	GitHub イベント	コード入力時	手動操作
CI/CD統合	ネイティブ対応	部分対応	非対応
非同期処理	対応（バックグラウンド）	非対応	非対応
組織ルール適用	CLAUDE.mdで柔軟に設定	設定ファイル対応	限定的
職場での利用率（2026年5〜7月）	39%	21%	12%
料金体系	Anthropic API従量課金	GitHub有料プラン	月額サブスク

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

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

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

段階的な導入を推奨

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

フェーズ1: コメントトリガー型のみ有効化（@claudeで手動起動）
フェーズ2: CLAUDE.mdを整備してレビュー精度を向上
フェーズ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 }}
    prompt: "src/以下のTypeScriptファイルのみレビューしてください"

Amazon Bedrock版での企業利用

社内データのセキュリティポリシー上、Anthropicに直接APIリクエストを送れない企業では、Amazon Bedrock経由でClaude Code Actionを利用する選択肢があります。use_bedrock: "true"を指定し、AWS認証はGitHub OIDC（OpenID Connect）でIAMロールを引き受ける方式が公式に案内されています。

- name: Configure AWS Credentials (OIDC)
  uses: aws-actions/configure-aws-credentials@v4
  with:
    role-to-assume: ${{ secrets.AWS_ROLE_TO_ASSUME }}
    aws-region: ap-northeast-1

- uses: anthropics/claude-code-action@v1
  with:
    use_bedrock: "true"
    claude_args: |
      --model anthropic.claude-4-0-sonnet-20250805-v1:0
  permissions:
    id-token: write

この方式では、AWSの静的なアクセスキーをリポジトリに保存する必要がありません。IAMロールとGitHubのOIDCトークンだけで認証でき、セキュリティポリシーへの準拠も容易になります。モデル名はBedrock固有の形式（anthropic.claude-4-0-sonnet-20250805-v1:0など）をclaude_argsの--modelで指定します。

＼ AI活用の「次の一手」を一緒に考えませんか／

AI顧問の無料相談はこちら

よくある質問（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-actions/configure-aws-credentialsアクションでIAMロールをOIDC経由で引き受けます。AWS側ではBedrockのAnthropicモデルへのアクセス許可と、GitHubのOIDCプロバイダー（IDプロバイダー）の登録が必要です。静的なAWSアクセスキーをリポジトリに保存する必要はありません。