Claude Code Actionの初期設定

Claude Code ActionはAnthropicのAPIを呼び出してClaudeを動かします。GitHub Actionsに組み込む前に、Anthropicのアカウントを作成し、クレジットをチャージし、GitHub Actionsから安全にAnthropic APIを呼び出せる状態にしておきます。

Anthropicは、GitHub Actionsからの認証方式として 静的なAPIキー方式 と OIDC(ワークロードIDフェデレーション)方式 の2つを提供しています。本章では、静的な機密情報を持ち回らなくて済む OIDC方式 を採用します。GitHub Actionsが発行する短命なOIDCトークンをAnthropicに送り、それと引き換えに短命なアクセストークンを受け取る仕組みなので、GitHub Secretsに長期の秘密情報を保管する必要がありません。

📝 OIDC(OpenID Connect)とは
OIDC は、認証情報(誰であるか)を短命な署名付きトークンでやり取りする標準仕様です。GitHub Actions は、実行中のワークフローが「どのリポジトリの・どのブランチの・どのイベントで動いているか」を主張するOIDCトークンを発行します。Anthropicはそのトークンを検証して、期待した条件からのリクエストであれば短命なアクセストークンを発行するので、静的なAPIキーを持ち回る必要がなくなります。

1. Anthropicアカウントの作成

OIDC連携の設定は、Anthropic Consoleというブラウザ管理画面で行います。まずはそのアカウントを作成します。既にAnthropicアカウントを持っている場合は、この手順はスキップして次の「使用クレジットの購入」に進んでください。

Anthropic Console にアクセスすると、「Claude Platform で開発する」画面が表示されます。「Googleで続行」または「メールで続ける」からアカウントを作成します。登録後、電話番号による本人確認が求められる場合があるので、SMSで届いた認証コードを入力してアカウントを有効化します。

サインアップが完了すると、Anthropic Consoleのダッシュボードに遷移します。ここまで到達すればアカウント作成は完了です。

2. 使用クレジットの購入

Claude Code Actionは従量課金なので、実際にClaudeを呼び出すには、支払い情報を登録して事前にクレジットをチャージしておく必要があります。

サインアップ直後、または左メニュー「クレジット」→「資金を追加」から「使用クレジットを購入して開始する」画面に入ります。以下を入力します。

設定項目 値 設定の基準
使用クレジット $5(APIを試す)または $20(プロトタイプを構築) プルリクエスト1件あたり数円〜数十円程度の消費目安。本章だけなら最低額の$5でまかなえる。8章以降のAI関連ハンズオンでも使う予定なら$20を選ぶと余裕を持てる
支払い方法 カード(またはApple Pay / Google Pay) クレジットカード決済
請求先住所 氏名・国・郵便番号 郵便番号が未入力だと「クレジットを購入」ボタンが非活性のままなので必ず入力する
事業者登録番号 空欄 個人利用なら空欄でよい(形式チェックで弾かれる可能性があるため入れない)

💡 ポイント
ここでカード情報を登録して「クレジットを購入」を押すと、選んだ金額が即座に決済されます。本章のハンズオンをそのまま進める判断ができてから購入してください。ハンズオンを実施しない場合や、判断を保留したい場合は「今はスキップ」を選び、この節から先を読み流すだけにとどめておくのが安全です。

「クレジットを購入」をクリックしてチャージ完了です。ダッシュボード左メニュー「クレジット」欄にチャージした金額が反映されれば、Claude API呼び出しの準備が整った状態です。

⚠️ 「Insufficient credits」エラーが出る場合
Anthropic Console左メニューの「クレジット」で残高を確認し、必要に応じて追加でチャージしてください。ハンズオン全体で消費するのは数百円程度なので、少額の追加で問題ありません。

3. OIDC連携の設定

GitHub ActionsからOIDC経由でAnthropic APIを呼び出せるようにするため、Anthropic Console側で以下の4つを登録します。

  1. 発行者(Issuer): どのIDプロバイダを信頼するかを登録する(GitHub ActionsのOIDC発行者URL)
  2. フェデレーションルール: どのリポジトリ・ブランチ・イベントを受け入れるかの一致条件を設定する
  3. サービスアカウント: 認証成功時に紐付けるAnthropic側のIDと権限スコープを定義する
  4. 接続テスト用ワークフロー: 実際にトークン交換が動くかを確認するYAMLを取得する

順番に設定していきます。

3.1 発行者(Issuer)の登録

Anthropic Consoleにログインしたら、左メニューから「APIキー」を開きます。

「キーを作成」をクリックします。

APIキー方式かOIDC方式かを選択するダイアログが開きます。今回は静的キーを持たない方式を採用するため、「ID連携を設定する」 をクリックします。

「ワークロード ID フェデレーション」の管理画面に遷移します。まだ発行者が1件も登録されていないので、「発行者を登録」をクリックします。

発行者(Issuer)とは、OIDCトークンを発行する信頼元のことで、ここではGitHub ActionsのOIDCトークン発行URLとその署名鍵の取得方法を登録します。この登録によって、Anthropicは「そのURLから発行され、正しい署名が付いたトークンなら本物として受け入れる」という判断基準を持てるようになります。

発行者登録ダイアログが開くので、以下を入力します。

設定項目 値 設定の基準
名前 github-actions 監査ログに表示される識別名
発行者URL(iss クレーム) https://token.actions.githubusercontent.com GitHub ActionsのOIDCトークン発行者URL(GitHub公式で固定)
JWKSソース OIDCディスカバリー GitHub ActionsはOIDCディスカバリー対応のためデフォルトのままでよい
ディスカバリーベースURL 空欄 発行者URLと同じ場所で公開されているため入力不要
CA証明書 空欄 GitHub Actionsは公開CAで検証できるため入力不要

入力が終わったら、「登録する」をクリックします。

発行者一覧に github-actions が「有効」ステータスで追加されれば、発行者の登録は完了です。

3.2 ワークロードの接続

続いて、この発行者と、GitHub Actions側の一致条件・サービスアカウントを紐付ける4ステップウィザードに進みます。

画面右上の 「ワークロードを接続」 をクリックします。

ステップ1: 発行者

先ほど登録した github-actions を選択して「続ける」をクリックします。

ステップ2: フェデレーションルール

「このルールはどのワークロードに一致させますか?」画面で、以下を入力します。

設定項目 値 設定の基準
ルール名 ai-review-handson 対象リポジトリと揃えて監査時に識別しやすくする
説明(任意) AIレビューハンズオン用(pull_requestトリガー) 用途がわかる短文
GitHub組織 あなたのGitHubユーザ名 個人アカウントの場合はユーザ名を入れる。組織アカウントの場合は組織名
リポジトリ(任意) ai-review-handson 対象を本章のリポジトリのみに絞る
ブランチ / ref(任意) 空欄 プルリクエスト時の ref は refs/pull/N/merge になるため固定できない
イベント名(任意) pull_request AIレビューはプルリクエストトリガーで実行する
組織の数値ID(任意) curl https://api.github.com/users/<ユーザ名> で取得できる id の値 ユーザ名が将来変わっても信頼条件が壊れないよう入れる
すべてのワークスペース オフ 権限スコープを特定のワークスペースに閉じる
ワークスペース Default クレジットを登録済みのワークスペースを指定する

「続ける」をクリックします。

ステップ3: 対象(サービスアカウント)

「これはどのサービスアカウントにしますか?」画面で、以下を入力します。

設定項目 値 設定の基準
モード 新規作成 このハンズオン用のサービスアカウントを新しく作る
サービスアカウント名 ai-review-handson フェデレーションルール名と揃える
説明(任意) AIレビューハンズオン用(GitHub ActionsからClaude Code Actionを実行) 用途がわかる短文
ワークスペース フェデレーションルールに一致(Default) ステップ2で指定したワークスペースを継承

「適用して続行」をクリックします。

ステップ4: テスト用ワークフローの取得

最後に、接続テスト用のワークフローYAMLが表示されます。ここには次の4つの識別子が埋め込まれており、後の手順でGitHub Actionsのワークフローを書くときに使います。

  • federation_rule_id
  • organization_id
  • service_account_id
  • workspace_id

右上のコピーボタンでYAML全文をコピーし、テキストファイルなどに貼り付けて保管しておいてください。 これらの値は後で Anthropic Console から再度確認できますが、ここで控えておくと後の手順がスムーズです。

この時点ではまだGitHub Actions側からトークン交換のリクエストが来ていないため、接続テスト欄は「認証を待機中…」のままで問題ありません。実際の疎通確認は、次章以降でサンプルリポジトリにワークフローを配置してから行います。「完了」を押してダイアログを閉じます。

📝 保管しておく値のまとめ
Anthropic Consoleが生成したテストワークフローYAMLには、GitHub Actionsから利用する4つのID(federation_rule_id / organization_id / service_account_id / workspace_id)が含まれています。これらはIDを漏らしても即座に悪用されるものではありませんが、後の手順でGitHub Actionsのワークフローファイルに埋め込むので手元に控えておくと確実です。