Claude Code GitHub Actionsを使いこなせ！

tl:dr

• Claude Code ActionはGitHubでPull RequestやIssue向けに、Claude Codeに質問への回答やコード変更の実装を行わせるアクション
• MAX Subscriptionは使えず、AnthropicダイレクトAPI(従量課金)に対応
• MAX Subscriptionが使えるようになりました！
• セットアップ手順が記載されているので参考にして使いこなそう(私含めて)

2025年7月13日更新:
これまでAPIの従量課金のみでしたが、MAX Subscriptionが使えるようになりました！これに合わせて記事の内容を更新しました。

はじめに

日本時間2025年5月23日に開催されたAnthropic社のCode w/ Claude。その中で、Mastering Claude Code in 30 minutesというセッションがありました。
https://youtu.be/6eBSHbLKuN0

• Claude Codeを使いこなせ！
• Claude Code SDKを使いこなせ！

に上記セッションの内容を解説しています。
Claude Code SDKの活用例としてClaude Code GitHub Actionsがあげられています。
この記事では、Claude Code GitHub Actionsにフォーカスを当てて見ていこうと思います。
ご覧いただくことで、みなさんのGitHub RepositoryでClaude Code GitHub Actionsが使えるようになります。

なお、GitHubにclaude-code-action ( Claude Code Action ) としてソースコードが公開されています。
https://github.com/anthropics/claude-code-action

Claude Code Actionってなに？

GitHubのPull RequestやIssue向けの汎用Claude Codeアクションです。質問への回答やコード変更の実装が可能です。このアクションは、コメント内のトリガーフレーズを検知すると起動し、そのリクエストに応じてClaudeが動作します。AnthropicダイレクトAPI(従量課金)の認証方式に対応しています。Amazon Bedrock、Google Vertex AIにも対応しています。ただし、MAXプランのSubscriptionには対応していません。 MAX Subscriptionに対応しています！

アクションは、一般的にGitHub Actionsと呼ばれています。ソフトウェア開発のワークフローを自動化するためのプラットフォームです。GitHubリポジトリ内で、コードのビルド、テスト、デプロイといった一連の作業を、あらかじめ定義したルールに基づいて自動的に実行させることができます。

• ワークフローの自動化:
  • CI/CD 自動化: 例えば、Push や PR でテスト → 成功なら自動デプロイ
  • 定型タスク自動化: 例えば、手動ラベル付けやリリースノート生成を自動的に
• イベント駆動: 例えば週次バックアップ
• ワークフロー定義:
  • YAML: .github/workflows/*.yml に順序記述
• 再利用: JS/Docker 製の再利用ユニット。uses: actions/setup-node@v4 で Node 20 環境即用意
• 実行環境: 自身で用意したサーバを登録して、ワークフローを実行可能
• GitHub統合: PR・Issue とシームレス連携

図解すると下記になります。Claude Codeとの違いがわかるように図解しています。紫色で囲われている部分が、Claude Code Actionに関連するコンポーネントになります。

Claude Code Actionの全体像

特徴

• @claudeメンションでPRやIssueから直接呼び出し
• 自動PR作成 - Issueから実装を生成
• コードレビュー - PRの自動レビュー
• バグ修正 - 問題を検出して修正PRを作成

実際、下記のようにIssueに対して@claudeメンションを使ってClaudeに解決方法を考えてコメントしてもらうことができます。

セットアップ方法

GitHubのClaude Code Action によると、端末のターミナルで動くClaude Codeの/install-github-appを実行することでセットアップできるとあります。しかしながら、私の端末ではうまくセットアップができませんでした。ここではGitHub上で手動セットアップする手順を記載します。

前提事項

• リポジトリ管理者（Admin）権限があること
• Anthropic の API キー（Claude 用）を取得済み

Claude GitHub App をインストール

1. ブラウザでhttps://github.com/apps/claudeにアクセスする
2. Install → Only select repositories を選び、対象リポジトリにチェック
3. 完了後、リポジトリの Settings → Integrationsセクション → GitHub Apps → Claude が Installed になっていることを確認

下記のように表示されます。

リポジトリにシークレットを追加

1. リポジトリの Settings → Securityセクション → Secrets and variables → Actions
2. 「New repository secret」ボタンを押下する
3. NameにANTHROPIC_API_KEY、SecretにAnthropicのAPIキーを貼り付ける
4. 「Add Secret」ボタンを押下する

下記のように追加します。

リポジトリ設定でワークフロー権限変更

1. リポジトリのSettings → Code and automationセクション → Actions → General → Workflow permissions
2. Read and write permissions を選択
3. Allow GitHub Actions to create and approve pull requestsをOnにするとPull Requestができるようになりますが、いったんOFFでもOK
4. 「Save」ボタンを押下

下記のような設定画面です。

ワークフロー ファイルを配置

1. リポジトリをgit cloneした配下に.github/workflows/claude.ymlを追加する
2. 下記記載して、リポジトリにMergeする

claude.yml

name: Claude Assistant

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]
  pull_request_review:
    types: [submitted]

jobs:
  claude-response:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      pull-requests: write

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Set up Bun
        uses: oven-sh/setup-bun@v2
        with:
          bun-version: "1.2.11"

      - name: Run Claude Code Action
        uses: anthropics/claude-code-action@beta
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          github_token: ${{ secrets.GITHUB_TOKEN }}
          trigger_phrase: "@claude"

claude.yml詳細解説

claude.ymlを探求する

ワークフロー基本設定

name: Claude Assistant

ワークフローの名前を定義しています。この名前はGitHubのActionsタブで表示され、ワークフローを識別するために使用されます。

トリガーイベント（on:）

issue_comment:

Issueやプルリクエストにコメントが投稿されたときに発動します。

• types: [created]: 新しいコメントが作成されたときのみ反応（編集や削除では発動しない）

pull_request_review_comment:

プルリクエストの差分に対するレビューコメントが投稿されたときに発動します。

• types: [created]: 新しいレビューコメントが作成されたときのみ

issues:

Issueに対する操作で発動します。

• types: [opened, assigned]:
  • opened: 新しいIssueが作成されたとき
  • assigned: Issueが誰かにアサインされたとき

pull_request_review:

プルリクエストのレビューが送信されたときに発動します。

• types: [submitted]: レビューが完了し、送信されたとき

ジョブ定義（jobs:）

claude-response:

ジョブの名前です。複数のジョブがある場合は、それぞれを識別するために使用されます。

runs-on: ubuntu-latest

このジョブを実行する環境（ランナー）を指定しています。ubuntu-latestは最新版のUbuntu環境を使用します。

permissions:

このジョブに必要な権限を明示的に定義しています：

• contents: write: リポジトリのコンテンツ（ファイル）への書き込み権限
• issues: write: Issueへの書き込み権限（コメントの投稿など）
• pull-requests: write: プルリクエストへの書き込み権限

ステップ定義（steps:）

1. Checkout repository

- name: Checkout repository 
  uses: actions/checkout@v4

リポジトリのコードをランナーにクローンします。Claudeがコードを読み取り、変更を加えるために必要です。

2. Set up Bun

- name: Set up Bun 
  uses: oven-sh/setup-bun@v2
  with:
    bun-version: "1.2.11"

Bunランタイムをインストールします。Claude Code Actionの内部処理で使用される可能性があります。

3. Run Claude Code Action

- name: Run Claude Code Action 
  uses: anthropics/claude-code-action@beta
  with:
    anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
    github_token: ${{ secrets.GITHUB_TOKEN }}
    trigger_phrase: "@claude"

メインのClaude Code Actionを実行します：

• anthropic_api_key: Anthropic APIキー（リポジトリのシークレットに保存）
• github_token: GitHubの認証トークン（自動的に提供される）
• trigger_phrase: Claudeを呼び出すトリガーフレーズ（デフォルトは@claude）

実際の動作フロー

1. IssueやPRに「@claude」を含むコメントを投稿
2. GitHub Actionsがこのワークフローを起動
3. Ubuntuランナー上でリポジトリをチェックアウト
4. Claude Code Actionが起動し、コメントの内容を解析
5. Claudeが適切な応答（コード変更、質問への回答など）を実行

GitHub Actionsを探求する

1. actions/checkout@v4

概要

GitHubが公式に提供するアクションで、リポジトリのコードをランナー環境の$GITHUB_WORKSPACEにクローンする機能を提供します。

主な特徴

• 時間節約: 複数のワークフローで同じステップを書き直す必要がなくなります
• マルチリポジトリ対応: 複数のリポジトリをクローン可能
• 組み込み認証: プライベートリポジトリへのアクセスも簡単

最新の機能（v4）

• 特定のブランチ、タグ、コミットの指定が可能（refパラメータ）
• スパースチェックアウト機能で特定のファイル/ディレクトリのみを取得可能
• プライベートリポジトリのクローンサポート
• Node.js 20をベースに動作（以前のバージョンより高速）

使用例

# 別のブランチをチェックアウト
- uses: actions/checkout@v4
  with:
    ref: feature-branch-name

# 複数リポジトリの使用
- uses: actions/checkout@v4
  with:
    repository: my-org/my-other-repo
    path: secondary-repo

2. oven-sh/setup-bun@v2

概要

Bunランタイムを GitHub Actionsにインストール・セットアップするためのアクションです。

Bunとは

JavaScriptとTypeScriptアプリのためのオールインワンツールキットで、Node.jsのドロップイン代替として設計された高速JavaScriptランタイムです。

主な特徴

• バージョン指定が可能（latest、特定バージョン、canaryなど）
• バージョンファイル（.bun-version）からの読み込みサポート
• プライベートレジストリのサポート（registry-urlとscopeオプション）
• キャッシュ機能でインストール時間を短縮

v2での改善点

• bun-download-url入力のサポート（ダウンロードURLのカスタマイズ）
• より安定したバージョン管理
• 最新のBunバージョンとの互換性向上

使用例

# 最新版をインストール
- uses: oven-sh/setup-bun@v2
  with:
    bun-version: latest

# 特定バージョンをインストール
- uses: oven-sh/setup-bun@v2
  with:
    bun-version: "1.2.14"

3. anthropics/claude-code-action@beta

概要

GitHubのPRやIssueでClaudeを活用できるアクションで、質問への回答やコード変更の実装を行います。

主な機能

• インタラクティブなコードアシスタント: コードについての質問や改善提案
• コードレビュー: PR変更の分析と改善提案
• コード実装: 簡単な修正から新機能の実装まで対応
• 進捗追跡: チェックボックスによる視覚的な進捗表示
• ブランチ管理: 人間のPRには新しいPRを作成、ClaudeのPRには直接プッシュ

最新の特徴（beta版）

• Claude Opus 4とClaude Sonnet 4をサポート
• Amazon BedrockとGoogle Vertex AIによる認証をサポート
• カスタムツールの許可/禁止設定
• 自動化ワークフローのためのdirect_promptオプション

セキュリティ

• リポジトリへの書き込み権限を持つユーザーのみが使用可能
• GitHubアプリは短期間のトークンのみを受け取る
• APIキーは必ずGitHub Secretsに保存

使用例

# カスタムツールを許可
- uses: anthropics/claude-code-action@beta
  with:
    allowed_tools: "Bash(npm install),Bash(npm test)"
    disallowed_tools: "TaskOutput,KillTask"

重要な注意点

別の見方をすると、これらのアクションの組み合わせにより：

1. 環境の準備（checkout）
2. 必要なツールのインストール（setup-bun）
3. AIによる自動化（claude-code-action）

という完全な開発支援ワークフローが構築できるようになっています。なお、Action「anthropics/claude-code-action@beta」をYAMLに定義は制約なくできますが、GitHub Apps「Anthropic Claude」のインストールをしないとClaude Codeがリポジトリへのプルリクエスト、Issues、コンテンツへの読み書き権限が付与されず利用できません。

GitHub ActionsとGitHub Appsの違い

• GitHub Apps = 「権限を与えるための門番」
• GitHub Actions = 「実際に作業を行うツール」

GitHub Actionsは、公開されているものであれば誰でもuses:で指定して使えるのが大きな特徴です。ただし、Claude Code Actionのように、動作するために別途GitHub Appのインストールが必要なケースもある。

使ってみる

下記のようにIssueに@claudeとコメントして投稿します。

すると数分後に下記のようにClaude Codeから返信ありました！これで成功です！

2025年7月13日追記 MAXプランで使う方法

Claude Code経由でトークンを発行

claude setup-token をターミナル上で実行します。

認証コードを発行するためのURLが表示されます。

URLをブラウザで開くとこんな画面になります。内容を確認したうえで「承認する」ボタンをクリックしてください。

認証コードがされました。コピーします。

ターミナルに貼り付けて、Enterキーを打鍵します。すると、トークン(sk始まりの文字列)が発行されます。

GitHubの環境変数の設定を変更

GitHubにアクセスします。
設定対象のリポジトリにアクセスします。
タブ「Settings」をクリックします。
「Secrets anb variables」の「Actions」をクリックします。
「New repository secret」ボタンをクリックします。

※この例の場合、「PERSONAL_ACCESS_TOKEN」の設定は不要です
さきほど有効化したトークン(sk始まりの文字列)を貼り付けます。変数名は CLAUDE_CODE_OAUTH_TOKEN とします。「Add secret」ボタンをクリックします。

YAMLファイルを変更

この記事の claude.yml を変更します。

claude.yml

- anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+ claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}

この変更をリポジトリにpushします。
これでActionsをMAXプランで利用できるようになりました。

おわりに

いかがでしたか。Claude Code Actionを使っていきたい方の参考に少しでもなれると幸いです！
公式ドキュメントは下記となります。この記事でキャッチアップできている状態で読むと理解度が違うと思いますので、ぜひ目を通してみてください！

公式Claude Code Actionドキュメント(英語)
公式Claude Code Actionドキュメント(日本語)