GitHubにClaudeを置く（GitHub Actions）

@claudeと書くだけで、Claudeが動き出す

あるチームのことです。GitHubでPull RequestとIssueは毎日使っている。レビューのコメントも、Issueへのラベル付けも人の手でやってきた。GitHub Actionsという言葉は聞いたことがあるけれど、設定したことは一度もない。

こういうチームがまず試すことになるのが、claude-code-actionです。Claude Codeの公式のGitHub Actionで、ワークフローファイルを1つ置くだけで、リポジトリの中にClaudeを常駐させられます。

動き方は2つあります。

前者はPRのコメント欄に「@claude ここのテストが落ちてる理由を調べて」のように書きかけて使う形、後者は「PRが開かれたら自動でレビューする」のように仕込んでおく形です。個々の使い道は次のレッスンで扱うので、ここでは導入までを一通り済ませます。

導入は2通りある

窓口は2つあります。GitHub CLIが使えるならクイックセットアップの方が早く、そうでなくても手動で3ステップで終わります。どちらの窓口も、対象リポジトリに対して管理者権限を持つ人が行う前提です。GitHub Appのインストールやsecretsの登録は、リポジトリの設定そのものを変える操作なので、閲覧権限だけのメンバーでは進められません。

クイックセットアップ

/install-github-app が使えるのはgithub.comのリポジトリだけです。GitLabやBitbucketで管理しているなら、次の手動セットアップになります。

手動セットアップ

どちらの窓口を通っても、最終的にリポジトリの中身は同じです。ワークフローファイルとsecretsが揃えば準備完了です。

動作を確かめたいときは、実際にPRかIssueのコメント欄で「@claude」と書き込んでみるのがいちばん早い方法です。しばらくしてClaudeからの返信やコミットが付けば、ここまでの設定は正しく効いています。

secretsに何を入れるか

認証に使えるsecretsは2種類あります。値そのものは、対象リポジトリのGitHub画面にあるSettingsタブの中のSecrets and variables(Actions)から登録します。登録する名前は、ワークフローファイルが参照する名前(ANTHROPIC_API_KEYまたはCLAUDE_CODE_OAUTH_TOKEN)と一字一句そろえてください。名前がずれていると、ワークフロー自体は動いても認証だけ失敗します。

どちらを選んでも、値そのものはリポジトリのSecretsに保存し、ワークフローからは${{ secrets.ANTHROPIC_API_KEY }}のように参照します。コードやCLAUDE.mdにキーの値をそのまま書き込まない理由は、APIキー、Claudeに渡してませんか？で扱った通りです。会話にキーを貼らないのと同じ理由で、リポジトリにも直接書きません。

最小のworkflow構成

公式ドキュメントに載っている構成要素を組み合わせると、@claudeのメンションに応答する最小のworkflowはこうなります。permissionsのブロックと、アクションの呼び出し方は公式ドキュメントの記載をそのまま使っています。

name: Claude Code
on:
  issue_comment:
    types: [created]

jobs:
  claude:
    if: contains(github.event.comment.body, '@claude')
    runs-on: ubuntu-latest
    permissions:
      contents: write
      pull-requests: write
      issues: write
      id-token: write
      actions: read
    steps:
      - uses: actions/checkout@v6
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

anthropics/claude-code-action@v1のように、バージョンを固定して参照します。ワークフローファイルはコードと同じ扱いです。git管理下に置き、変更はレビューを経てからマージします。

onに指定したissue_commentは、Issueのコメントだけでなく、Pull Requestのコメントにも反応します。GitHubの仕様上、PRのコメントもissue_commentイベントとして扱われるためです。ifの行で本文に「@claude」が含まれるかを確認しているので、それ以外のコメントではジョブ自体は起動しても、Claudeは何もしません。

権限は必要な分だけ

id-token: writeは、既定のGitHub App認証に必要な権限で、APIキーそのものを扱っているわけではありません。actions: readは、PRのCI結果をClaudeに読ませるための権限です。使わない権限までは足さないのが基本です。

呼び出す側にも既定の歯止めがあります。IssueやPRのコメントでは、リポジトリへの書き込み権限を持つ人のコメントだけが起動条件になり、ボットのコメントは既定で拒否されます。

かかる費用は2種類

GitHub Actionsでの実行には、2種類の費用が同時にかかります。

具体的な金額の目安や、モデル・effortの既定をチームでどう決めるかは、次のレッスンで扱います。

今日のまとめ

3行で振り返ります。

• claude-code-actionは、@claudeのメンションに応答するInteractiveと、prompt指定で自動実行するAutomationの2通りで動く
• 導入は/install-github-appのクイックセットアップか、App+secrets+ワークフロー配置の手動セットアップ
• キーは会話やコードに直接書かず、secretsに置いて権限も必要最小限に絞る

次のレッスンでは、このworkflowを土台に、PRレビューとIssue整理を自動化していきます。PRレビューとIssue整理を任せるを見ていきましょう。