Claude Code Actionの組み込み

サンプルリポジトリとOIDC連携が整ったので、Claude Code ActionをGitHub Actionsに組み込み、プルリクエストに対してAIレビューが動く状態を作ります。

1. Claude Code Action GitHub Appのインストール

これから作る AI レビューワークフローは、GitHub Actions 上で anthropics/claude-code-action@v1 を呼び出します。これはAnthropicが公式に提供している Claude Code Action の実体で、ソースコードは Claude Code Action 公式リポジトリ で公開されています。

ただし、この Action をワークフローから呼び出すだけでは動きません。対応する Claude GitHub App も対象リポジトリにインストールしておく必要があります。理由と手順を順に見ていきます。

1.1 GitHub App が必要な理由

疎通確認で置いた anthropic-wif-test.yml では GitHub App は不要でした。あのワークフローは Anthropic API を呼び出してトークン交換のレスポンスをログに出すだけで、GitHub リポジトリ側への書き込みは一切していなかったためです。

一方、これから作る AI レビューワークフローは、Claude が生成したレビューコメントを プルリクエストに書き戻す 必要があります。プルリクエストへのコメント投稿・レビューコメントの行紐付け・@claude メンションへの反応など、Claude が GitHub 上で操作するには、そのための GitHub 上のアイデンティティ(=Claude GitHub App)が必要です。App を入れておくことで、Claude Code Action は投稿を「Claude」という明確なボットとして行い、権限も PR・Issue 操作に必要な範囲に絞られた状態で動きます。

1.2 インストール手順

ブラウザで Claude GitHub App のインストール画面 を開きます。画面右上のボタンは、アカウントの状態によって表示が変わります。まだClaude Appをインストールしていない場合は「Install」ボタンが表示されます。すでに別のリポジトリでClaude Appを使っている場合は「Configure」ボタンが表示されるので、そこから対象アカウントの設定画面に入り、「Repository access」に ai-review-handson を追加する形で進めます。

ボタンをクリックしてご自身のGitHubアカウントを選択すると、インストール設定画面に進みます。以下の設定を行います。

設定項目 値 設定の基準
Repository access Only select repositories 意図しないリポジトリで Action が動かないよう、対象を絞る
Select repositories ai-review-handson 本章専用のリポジトリのみを指定する

権限一覧を確認して、画面下部の「Install & Authorize」(既にインストール済みで設定を変更する場合は「Save」)をクリックします。これでGitHub App のインストールは完了です。以降、ai-review-handson リポジトリのプルリクエストに対して Claude Code Action からコメント投稿ができるようになります。

初回インストール時は、続けて claude.ai 側のGitHub連携画面に自動的に遷移します。

📝 claude.ai 側の GitHub 連携について
この画面は、claude.ai のチャットから GitHub リポジトリを直接扱えるようにするための OAuth 連携です。本章のハンズオン(GitHub Actions から Claude Code Action を動かす)には必須ではありません。ただし連携しておくと、claude.ai の対話画面から自分のGitHubリポジトリを参照しながら会話できるようになるので、進めておくと後々便利です。連携しない場合は、このタブを閉じても GitHub App のインストール自体は完了しています。

1.3 インストールの確認

Claude App が正しくインストールされたかは、ai-review-handson リポジトリの Settings → Integrations → GitHub Apps から確認できます。「Installed GitHub Apps」の一覧に「Claude」が「Configure」ボタン付きで表示されていれば、このリポジトリに対して App がインストールされている状態です。

📝 READMEのQuickstartとの違い
公式リポジトリのREADMEには「Claude Code CLI から /install-github-app を実行」する Quickstart 手順もあります。こちらは GitHub App のインストールと ANTHROPIC_API_KEY の Secrets 登録をまとめて自動化する手順で、Anthropic API を直接使う方式向けです。本章では OIDC で認証するため、Secrets は登録せず、GitHub App の設置だけを Web UI から手動で行います。

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

Claude Code Actionをプルリクエストのタイミングで動かすワークフローを作成します。認証は先ほど設定したOIDC連携を使い、実行時に短命なアクセストークンを取得してClaude Code Actionに渡す構成にします。

前節の疎通確認で test/oidc ブランチに切り替えたままになっているので、まず main ブランチに戻ります。

git switch main

Visual Studio Codeのエクスプローラーで ai-review-handson/.github/workflows/ を右クリックし、「新しいファイル」から ai-review.yml を作成します。

ai-review-handson
├── app.py
└── .github/
    └── workflows/
        └── ai-review.yml  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。<federation_rule_id> / <organization_id> / <service_account_id> / <workspace_id> は、Anthropic Consoleの接続テストで確認したご自身の値に置き換えてください。

name: AI Review

on:
  pull_request:
    types: [opened, synchronize]

permissions:
  id-token: write
  contents: read
  pull-requests: write
  issues: write

jobs:
  ai-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 1
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_federation_rule_id: <federation_rule_id>
          anthropic_organization_id: <organization_id>
          anthropic_service_account_id: <service_account_id>
          anthropic_workspace_id: <workspace_id>
          prompt: |
            REPO: ${{ github.repository }}
            PR NUMBER: ${{ github.event.pull_request.number }}

            あなたはシステム開発の経験が豊富な開発者です。
            今回のプルリクエストの変更差分を、一般的なコード品質の観点でレビューしてください。

            変更差分は、すでにカレントディレクトリにチェックアウト済みです。

            全体的な所感は `gh pr comment` を使って投稿してください。
            該当行に紐付けたレビューコメントは `mcp__github_inline_comment__create_inline_comment` を使って投稿してください。
            レビュー内容はメッセージ返答ではなく、必ず GitHub コメントとして投稿してください。

          claude_args: |
            --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"
⚠️ 4つの識別子を必ずご自身の値に置き換える
<federation_rule_id> / <organization_id> / <service_account_id> / <workspace_id> の4箇所は、プレースホルダのままだと Anthropic 側の認証で必ず失敗します。ワークフロー実行時に「識別子のフォーマットが不正」のエラーが出るため、動作確認前に置換漏れがないか必ず見直してください。

ワークフローを解説します。

on:
  pull_request:
    types: [opened, synchronize]

プルリクエストの作成時(opened)と、既存のプルリクエストに新しいコミットがPushされた時(synchronize)にワークフローが動きます。Draftから通常に切り替えたときなど、他のイベントは対象外です。

permissions:
  id-token: write
  contents: read
  pull-requests: write
  issues: write

id-token: write はOIDCトークンの取得のために、それ以外はClaude Code Actionがプルリクエストにレビューコメントを投稿するために必要な権限です。最小権限の原則 に従い、書き込みが必要な範囲だけに絞ります。

- uses: anthropics/claude-code-action@v1
  with:
    anthropic_federation_rule_id: <federation_rule_id>
    anthropic_organization_id: <organization_id>
    anthropic_service_account_id: <service_account_id>
    anthropic_workspace_id: <workspace_id>
    prompt: |
      REPO: ${{ github.repository }}
      PR NUMBER: ${{ github.event.pull_request.number }}
      ...

Claude Code Actionは、4つの識別子を渡すだけで Action の内部で OIDC トークン交換を実行 します。疎通確認で書いた curl によるトークン交換ステップを別途書く必要はなく、Action がそれ相当の処理を自動で行ってくれます。anthropic_api_key は指定しません(指定すると静的APIキーが優先され、OIDC 連携が使われなくなります)。

prompt にはClaudeに与える指示を書きます。ここでは、対象リポジトリとプルリクエスト番号を明示するために REPO と PR NUMBER を先頭に置き、「経験が豊富な開発者」として振る舞わせることでコード品質だけでなく設計判断やビジネスロジックの妥当性まで広く見てもらう指示にしています。加えて、レビュー対象がカレントディレクトリにチェックアウト済みの変更差分であることを伝え、投稿手段として総評は gh pr comment を、行単位の指摘は mcp__github_inline_comment__create_inline_comment を使うよう明示的に指定しています。最後に「メッセージ返答ではなくGitHubコメントとして投稿」と念押しし、投稿が確実に行われるようにしています。

観点の詳細は次のセクションで coding-standards Skill として切り出し、規約に沿った指摘に絞り込んでいきます。

claude_args: |
  --allowedTools "mcp__github_inline_comment__create_inline_comment,Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*)"

claude_args は、Claude Code Action の内部で起動する Claude Code SDK にそのまま渡す引数です。--allowedTools で プロンプトで使うよう指示したツールを明示的に許可 します。ここで許可していないツールは、Claude が使おうとしても権限拒否で弾かれ、レビューが動いてもコメント投稿までたどり着けません。今回は以下の4つを許可しています。

  • mcp__github_inline_comment__create_inline_comment: 該当行に紐付いたレビューコメントを投稿する MCP ツール
  • Bash(gh pr comment:*): プルリクエストへの総評コメントを gh CLI で投稿するためのBash実行
  • Bash(gh pr diff:*) / Bash(gh pr view:*): プルリクエストの差分・情報を確認するためのBash実行
📝 4つの識別子は機密情報ではない
federation_rule_id / organization_id / service_account_id / workspace_id は 識別子 であり、単体で悪用可能な認証情報ではありません。実際の認証は GitHub Actions が発行するOIDCトークンと突き合わせて行われるため、ワークフローファイルに直接記述しても実害はありません。ただし、他リポジトリからの署名リクエストに紛れ込むと監査ログのノイズになるので、必要以上に公開する必要もありません。Secrets 化するほどの緊張感は不要、程度で扱ってください。

3. ワークフローのコミットとPush

ワークフローファイルをリポジトリに反映します。

git add .github/workflows/ai-review.yml
git commit -m "Add Claude Code Action for PR review"
git push origin main

GitHubのリポジトリページを開き、.github/workflows/ フォルダを確認します。ai-review.yml が最新のコミットメッセージ「Add Claude Code Action for PR review」と一緒に並んでいれば、ワークフローがリポジトリに反映された状態です。

4. プルリクエストでの動作確認

意図的にレビューされるべき変更を含むブランチを作成し、プルリクエストを出してAIレビューが動くことを確認します。

git switch -c intentional-issues

Visual Studio Codeで app.py を以下の内容に書き換えます。

import os

API_KEY = "sk-1234567890abcdef"


def calculate_total(items: list[dict]) -> int:
    """商品リストの合計金額を計算する"""
    total = 0
    for item in items:
        total += item["price"] * item["quantity"]
    return total


def do_thing(data):
    return eval(data)

このコードには以下の問題が意図的に含まれています。これらがAIレビューで指摘されるかを、この後のプルリクエストで確認していきます。

問題 内容
APIキーのハードコード sk-1234567890abcdef がソースコードに直書きされている
意味のない関数名 do_thing は動詞として機能を表していない
危険な関数の使用 eval はユーザ入力を任意コードとして実行する脆弱性を持つ
型ヒントの欠如 do_thing の引数と戻り値に型がついていない

変更をコミットしてPushします。

git add app.py
git commit -m "Add eval and hardcoded key (for review demo)"
git push -u origin intentional-issues

GitHubのリポジトリページで intentional-issues ブランチから main に対するプルリクエストを作成します。タイトルはコミットメッセージがそのまま使われるので、そのまま「Create pull request」で作成します。

プルリクエストを作成すると、AI Review / ai-review チェックが Started として動き出します。前節で作った anthropic-wif-test / call-claude も同じイベントで動いていますが、こちらは疎通確認のワークフローなので独立して走ります。

数十秒〜1分程度で AI Review が完了し、claude[bot] からプルリクエスト全体への総評コメントと、変更行に紐付けたインラインコメントが投稿されます。

💡 ポイント
AIの出力は毎回同じにはならないため、実際にご自身の環境で得られる指摘の内容・表現・数は、以下のスクリーンショットとは異なります。指摘対象は概ね近くなりますが、粒度・優先度の付き方・言い回しに差が出るのは自然な挙動なので、完全一致を目指す必要はありません。AIレビューが動き、変更差分に対して指摘が投稿されている状態が確認できれば、次の手順に進んで問題ありません。

インラインコメント(該当行に紐付いたレビュー)

APIキーのハードコードに対する指摘。修正提案(Suggested change)で環境変数取得への置き換え案まで提示してくれます。

eval による任意コード実行の脆弱性への指摘。安全な代替関数(ast.literal_eval / json.loads)まで提案されます。

calculate_total の入力値検証・型の整合性への指摘。前節で「あとで指摘対象になる」と伝えていたポイントもAIが自力で拾ってきています。

総評コメント(プルリクエスト全体へのサマリ)

必須対応と改善提案を分けたサマリが gh pr comment 経由で投稿されます。個別行の指摘とセットで見ることで、レビュアーは「まず何を直すべきか」を短時間で把握できます。

指摘の答え合わせ

前節で「これらがAIレビューで指摘されるかを確認する」と挙げた4点は、いずれも AI が拾えていました。

意図した問題 AI の指摘
APIキーのハードコード ✅ 「[重大] APIキーがソースコードにハードコードされています」と指摘し、環境変数取得の Suggested change を提示
危険な関数(eval)の使用 ✅ 「[重大] eval() による任意コード実行の脆弱性」と指摘し、代替関数を提案
意味のない関数名 do_thing ✅ 「命名では関数の目的が分かりません。用途が分かる名前と型ヒント・docstring の追加を」と指摘
型ヒントの欠如 ✅ 「型ヒントを追加してください」と指摘

これでAIレビューが「動くだけ」の状態ができました。ただしこの状態のままだと、レビューコメントの粒度がプロジェクトごとの規約に合わず、ノイズも多いという問題が残ります。次のセクションで観点を Skillsとして管理し、精度を上げていきます。

4.1 トラブルシューティング

初回のAIレビュー起動時によく踏むポイントを、症状と対処のセットでまとめておきます。

⚠️ ワークフロー実行時に「識別子のフォーマットが不正」で失敗する場合
ai-review.yml の <federation_rule_id> / <organization_id> / <service_account_id> / <workspace_id> がプレースホルダのままになっていることが原因です。Anthropic Consoleで確認したご自身の値に置き換えて、再度mainにpushしてください。
⚠️ ジョブは動いたのにPRにコメントが投稿されない場合
ログに permission_denials_count が大きい値で出ていたり、Actionのステップ末尾で No buffered inline comments になっていたりする場合は、claude_args の --allowedTools が抜けている可能性が高いです。Claudeは「投稿しよう」としてはいるのに、投稿ツールが許可されておらず動けていない状態です。教材通りの --allowedTools を設定して再push してください。
⚠️ Actionが Workflow validation failed でスキップされる場合
ログに「The workflow file must exist and have identical content to the version on the repository's default branch」と出るのは、Claude Code Action のセキュリティ検証で、PRブランチ側の ai-review.yml と main 側の ai-review.yml に差分があるためです。PRブランチ側で git fetch origin main && git merge origin/main --no-edit && git push を実行して、PR側にmainの最新を取り込むと解消します。ワークフローファイルを後から書き換えた場合に発生しやすいので覚えておいてください。