[Claude] GitHub のレビューを自動化するワークフローの導入方法（CLI）

開発者：プルリクエスト作成する
    ↓
Claude：GitHub Actionsからレビューを行う

開発者：「@claude レビューして」とPRにコメント
    ↓
Claude：👀 リアクションを即座に付ける（受信確認）
    ↓
Claude：差分を解析してレビューコメントを投稿

開発者：「@claude このバグの原因を教えて」とIssueにコメント
    ↓
Claude：👀 リアクションを即座に付ける（受信確認）
    ↓
Claude：Issue の内容を読んで回答を投稿

/install-github-app

│ Install GitHub App                                                                                                                                              │
│ Select GitHub repository                                                                                                                                        │
│                                                                                                                                                                 │
│ > Enter repository                                                                                                                                              │
│                                                                                                                                                                 │
│   Enter a repo as owner/repo or https://github.com/owner/repo…   

  Select GitHub workflows to install
  We'll create a workflow file in your repository for each one you select.

  More workflow examples (issue triage, CI fixes, etc.) at: https://github.com/anthropics/claude-code-action/blob/main/examples/

  ❯ @Claude Code - Tag @claude in issues and PR comments ✔
    Claude Code Review - Automated code review on new PRs ✔

  ↑↓ to navigate · Space to toggle · Enter to confirm · Esc to cancel

Install GitHub App
Choose API key

 > Create a long-lived token with your Claude subscription

   Enter a new API key

name: Claude Code

# -----------------------------------------------
# トリガー設定：@claude に反応するイベントの種類
# -----------------------------------------------
on:
  issue_comment:
    types: [created]           # PRやIssueのコメント欄への書き込み
  pull_request_review_comment:
    types: [created]           # PRのコード行へのインラインコメント
  issues:
    types: [opened, assigned]  # Issueの本文・タイトルに @claude が含まれて作成・アサイン
  pull_request_review:
    types: [submitted]         # レビュー送信時（Approve / Request changes）の本文

jobs:
  claude:
    runs-on: ubuntu-latest
    timeout-minutes: 10        # [追加] 暴走防止：デフォルト360分から短縮。長時間実行による課金・リソース消費を防ぐ

    # -----------------------------------------------
    # 実行条件：以下の2条件を両方満たす場合のみ実行
    # 条件①：各イベントの本文に @claude が含まれているか
    # 条件②：実行者がリポジトリの関係者であるか（外部ユーザーを除外）
    # [追加] デフォルトは条件①のみ。条件②を加えることで第三者からの悪用を防ぐ
    # 注意：if: | の中に # コメントは書けないため条件式のみ記載
    # -----------------------------------------------
    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 == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
        (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
      ) &&
      (
        github.event.comment.author_association == 'OWNER' ||
        github.event.comment.author_association == 'MEMBER' ||
        github.event.comment.author_association == 'COLLABORATOR' ||
        github.event.issue.author_association == 'OWNER' ||
        github.event.issue.author_association == 'MEMBER' ||
        github.event.issue.author_association == 'COLLABORATOR' ||
        github.event.review.author_association == 'OWNER' ||
        github.event.review.author_association == 'MEMBER' ||
        github.event.review.author_association == 'COLLABORATOR' ||
        github.event.sender.login == github.repository_owner
      )

    # -----------------------------------------------
    # 権限設定：Claude がリポジトリを操作するために必要な権限
    # -----------------------------------------------
    permissions:
      contents: read
      pull-requests: write  # [変更] デフォルトは read。コメント返信・PR操作に write が必要
      issues: write         # [変更] デフォルトは read。Issueへのコメント返信に write が必要
      id-token: write       # GitHub の OIDC 認証トークンを発行する
      actions: read

    steps:
      # -----------------------------------------------
      # ステップ①：リポジトリのコードをランナーに取得
      # fetch-depth: 1 で直近のコミットのみ取得（高速化）
      # -----------------------------------------------
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      # -----------------------------------------------
      # ステップ②：Claude を実行してコメントの指示に応答
      # prompt: を省略することでコメント本文がそのまま Claude への指示になる
      # -----------------------------------------------
      - name: Run Claude Code
        id: claude
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          track_progress: true  # [追加] 処理中に進捗コメントを投稿してユーザーに状況を通知する（v1 新機能）
          claude_args: >-
            --model claude-sonnet-4-6
            --max-turns 20
            --append-system-prompt
            "あなたはこのリポジトリの開発アシスタントです。
            作業を開始する前に必ず CLAUDE.md を確認し、プロジェクトの概要・ブランチ運用・作業の流れ・注意事項を把握した上で対応してください。
            実装の詳細は 00.document/requirements.md を、ロードマップは 00.document/roadmap.md を参照してください。"
            --allowedTools "Bash(gh issue comment:*),Bash(gh pr comment:*),Bash(gh pr view:*),Bash(gh issue view:*),Bash(gh pr diff:*)"
          # [追加] claude_args の各オプション説明：
          # --model: 使用モデルを明示。未指定時はデフォルトモデル（claude-sonnet-4-6）が使われるが、テンプレートとして明示する
          # --max-turns: エージェントの最大実行ターン数。コスト・暴走防止のため上限を設定
          # --append-system-prompt: デフォルトのシステムプロンプトを保持しつつプロジェクト固有の指示を追記
          #   ※ --system-prompt は全体を上書きするため組み込み機能が失われる。append を使うこと
          # --allowedTools: デフォルトでは Bash は全て禁止。gh コマンドに限定して許可することでコメント返信等を可能にする
          additional_permissions: |
            actions: read

name: Claude Code Review

on:
  pull_request:
    types: [opened, synchronize, ready_for_review, reopened]
    #branches:
    #  - develop  # [追加] develop へのPRのみレビュー対象にする場合はコメントアウトを解除してください

jobs:
  claude-review:
    runs-on: ubuntu-latest
    timeout-minutes: 10        # [追加] 暴走防止：デフォルト360分から短縮。長時間実行による課金・リソース消費を防ぐ
    permissions:
      contents: read
      pull-requests: write  # [変更] デフォルトは read。PRへのレビューコメント投稿に write が必要
      issues: read
      id-token: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 1

      - name: Run Claude Code Review
        id: claude-review
        uses: anthropics/claude-code-action@v1
        with:
          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
          # [変更] デフォルトは plugins + /code-review:code-review 方式（@beta 向け）だが、
          # @v1 では plugins 経由のレポートがPRに投稿されない問題があるため direct prompt 方式に変更。
          # prompt にレビュー指示を直接記述し、claude_args でコメント投稿権限を付与する。
          prompt: |
            REPO: ${{ github.repository }}
            PR NUMBER: ${{ github.event.pull_request.number }}

            レビューを開始する前に、以下のドキュメントを必ず確認してください。
            - CLAUDE.md：プロジェクト概要・ブランチ運用・作業の流れ・注意事項
            - 00.document/requirements.md：実装の詳細仕様

            上記を踏まえた上で、このPullRequestのコードをレビューしてください。
            以下の観点で確認し、問題があればコメントを投稿してください。
            - コード品質・ベストプラクティス
            - バグ・潜在的な問題
            - セキュリティ上の懸念
            - 要件定義書（requirements.md）の仕様との整合性
          claude_args: >-
            --model claude-sonnet-4-6
            --max-turns 20
            --allowedTools "Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),mcp__github_inline_comment__create_inline_comment"
          # [追加] claude_args の各オプション説明：
          # --model: 使用モデルを明示。未指定時はデフォルトモデル（claude-sonnet-4-6）が使われるが、テンプレートとして明示する
          # --max-turns: エージェントの最大実行ターン数。コスト・暴走防止のため上限を設定
          # --allowedTools: デフォルトでは Bash は全て禁止。gh コマンドに限定して許可することでPRへのコメント投稿を可能にする
          #   mcp__github_inline_comment__create_inline_comment: インラインコメント投稿用MCPツール

on:
  issue_comment:               # PRやIssueのコメント欄への書き込み
  pull_request_review_comment: # PRのコード行へのインラインコメント
  issues:                      # Issueのタイトル・本文に @claude が含まれて作成・アサイン
  pull_request_review:         # レビュー送信時（Approve / Request changes）の本文

if: |
  (
    イベントの種類ごとに @claude を含むか判定
  ) &&
  (
    author_association が OWNER / MEMBER / COLLABORATOR のいずれか
    または リポジトリオーナー本人
  )

jobs:
  claude:
    runs-on: ubuntu-latest
    environment: claude-review  # 追加
    if: ...