Claude CodeのGitHub Actions入門｜@claudeで依頼

公開 更新 著者 永上裕之仕事の自動化
#Claude Code#GitHub Actions#@claude#プルリクエスト#自動化
GitHubの課題に@claudeと書くと、AIが修正案を出すイメージ

この記事の要点

  • Claude Code GitHub Actions は、リポジトリのワークフローの中で Claude Code を動かす仕組み
  • Claude Code で /install-github-app を打つと、アプリの導入・鍵の登録・ワークフローのプルリクエスト作成までを案内してくれる
  • @claude で頼む対話型と、決まった指示で回す自動型がある。動かせるのは書き込み権限のある人だけ

GitHub の課題（Issue）やプルリクエストに「@claude この不具合を直して」と書くだけで、AIが中身を読み、修正してコミットまでしてくれる。これが Claude Code GitHub Actions です。

この記事では、公式ドキュメント（2026年10月23日確認）にもとづいて、設定のしかたと2つの動かし方、安全のための決まりを順に整理します。

結論：まずは /install-github-app で対話型から

Claude Code GitHub Actions は、リポジトリのワークフローの中で Claude Code を動かす GitHub Action です。中身は Agent SDK で作られています。

始めるなら、手元の Claude Code で /install-github-app を打つのがいちばん早い方法です。そのうえで、まずは @claude と書かれたときだけ動く「対話型」 から使い始めると、何が起きるかを確かめながら広げられます。

似た名前の機能があるので、先に整理しておきます。

機能何をするか
GitHub Actions（この記事）ワークフローの中で Claude Code を動かす。@claude での依頼や決まった仕事
Code Reviewワークフローを書かずに、プルリクエストごとに自動でレビュー
Agent SDKGitHub の外で、自分のプログラムから Claude Code を動かす

レビューだけが目的なら、Claude CodeのCode Reviewとは？ で紹介した機能のほうが手軽です。

手順A：/install-github-app で設定する

前提は2つです。リポジトリの 管理者権限 があること、そして GitHub CLI を入れて gh auth login で認証しておくことです。

  1. 設定したいリポジトリで Claude Code を開き、/install-github-app を打ちます。
  2. 案内にそって Claude の GitHub アプリを入れます。
  3. 認証の鍵を選びます。APIキーか、サブスクリプションで作る長期トークンのどちらかで、リポジトリのシークレット（ANTHROPIC_API_KEY または CLAUDE_CODE_OAUTH_TOKEN）として保存されます。
  4. 使いたいワークフローを選ぶと、ブランチが作られ、プルリクエストの画面が開きます。それをマージすれば @claude が使える ようになります。

途中でやめたいときは Esc を押します。進行中の手順だけ終わり、そこまでに何をしたかが最後に表示されます。この方法は github.com のリポジトリ専用です。

手順B：手で設定する

手元で Claude Code を使わない場合や、ワークフローを細かく決めたい場合は、手で設定します。

  1. Claude の GitHub アプリを入れる：Action が使うのは、ファイル・課題・プルリクエストの読み書きの3つの権限です。
  2. 認証のシークレットを登録する：APIキーなら ANTHROPIC_API_KEY、サブスクリプションなら手元で claude setup-token を実行して作ったトークンを CLAUDE_CODE_OAUTH_TOKEN に入れます。
  3. ワークフローのファイルを置く：公式の例（examples/claude.yml）を .github/workflows/ にコピーします。この例はそのまま動く形で、@claude と書かれたときに反応します。

組織の多くのリポジトリで使うなら、アプリを組織単位で入れ、シークレットも組織単位で持たせます。この場合、個人のサブスクリプションに結びつくトークンではなく、APIキーを使うのが公式のすすめです。

2つの動かし方：対話型と自動型

型動くきっかけ結果の出る場所向いている仕事
対話型課題やプルリクエストに @claude と書くそのコメント欄不具合の修正、質問への回答、実装の依頼
自動型ワークフローに書いた指示（prompt）で、決まったタイミングワークフローの実行ログ（設定でコメントにも）毎週の依存関係の確認、新しい課題の振り分け

ワークフローに prompt を書かなければ対話型、書けば自動型になります。

誰が動かせるか：2つの確認

公式ドキュメントでは、動き出す前に必ず2つの確認が入ると説明されています。

なお、アプリを入れると、ほかの Claude の機能でも使う権限一式をまとめて許すことになります。必要な権限だけにしたい組織は、3つの権限だけの独自アプリを作る方法も公式に案内されています。権限の考え方は Claude Codeの権限設定入門 も参考になります。

仕事にどう使うか

最初は、人が必ず見る場所に結果が出る使い方 から始めるのが安全です。

ワークフローの中で動くのは claude -p と同じ非対話の Claude Code です。手元のスクリプトで試すなら claude -pの使い方 から始めると、指示文の作り方を確かめやすくなります。

よくある質問

使うのをやめるには？

.github/workflows/ からワークフローを消すと動かなくなります。シークレットも消しますが、消しても鍵そのものは有効なままなので、鍵も無効にします。アプリは、Code Review などほかの機能で使っていなければ外します。

GitLab でも使えますか？

/install-github-app は github.com 専用です。GitLab では別の手順（GitLab CI/CD）が用意されています。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール＆コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事

claude -pの使い方｜Claude Codeをスクリプトで動かす2026-10-23・仕事の自動化
Claude Codeをスマホで操作｜Remote Controlの始め方2026-10-22・仕事の自動化
Claude Codeのルーティンとは？定期実行で仕事を自動化する2026-10-18・仕事の自動化