Claude GitHub連携、3方式の違いと設定手順

「claude github 連携」で検索すると、claude.aiのコネクタ、Claude Code GitHub Actions、Code Review（研究プレビュー）という性質の異なる3つの公式機能が同じ言葉で語られており、混乱しやすい状況があります。目的に合わない方式を選んでしまうと、遠回りな設定作業になったり、期待した動作が得られなかったりします。本記事では、資料参照からPR自動化、自動コードレビューまで、それぞれの機能の違いと具体的な設定手順を整理しました。2026年8月〜9月時点のv1.0移行に伴う破壊的変更やCode Reviewの料金、SSO環境での注意点、既知の不具合まで実運用目線で解説しているので、自分の目的に合った方式をすぐに見極められる内容になっています。

Claudeが提供するGitHub連携、3つの方式を理解する

「claude github 連携」と検索すると、実は性質の異なる3つの公式機能が同じ言葉で語られていることに気づきます。目的に合わない方式を選んでしまうと、遠回りな設定作業をしてしまったり、期待した動作が得られなかったりするため、まずは全体像を整理しておきましょう。

方式1：claude.aiのGitHubコネクタ

Claude公式サイトのチャットやプロジェクト機能から、GitHubリポジトリのファイルを直接参照する仕組みです。コーディング不要で、GitHubのコネクタディレクトリから有効化できるため、非エンジニアがドキュメントやMarkdownメモを参照させたい場合に向いています。あくまで「読み込んで会話に活かす」機能であり、コードの自動修正やPR作成は行いません。

方式2：Claude Code GitHub Actions

任意のPRやIssueで「@claude」とメンションするだけで、コードの分析・PR作成・機能実装・バグ修正までを自動化できる仕組みです。Claude Code Docsによると、これはClaude Agent SDKの上に構築されており、GitHub Actionsのワークフローとして動作します。開発フローに組み込んで自動化したいエンジニア向けの方式であり、GitHub Appのインストールやシークレット設定といった開発者向けの準備が必要になります。

方式3：Code Review（研究プレビュー）

すべてのPRに対して自動的にレビューコメントを投稿する機能で、Claude Code GitHub Actionsとは別に提供されています。同じくClaude Code Docsで「すべてのPRに自動的に投稿されるレビューはGitHub Actionsとは別に『Code Review』という機能として提供されている」と明記されており、両者を混同しないことが重要です。GitHub Actionsの@claudeメンションが「呼び出したときに動く」方式なのに対し、Code Reviewは「PR作成やプッシュのたびに自動で走る」レビュー専用の仕組みという違いがあります。

3方式の分類軸

大まかに整理すると、以下のような棲み分けになります。

claude.aiコネクタ：対象はエンジニア以外も含む全ユーザーで、用途はチャット・プロジェクトでの資料参照やナレッジ管理です。
Claude Code GitHub Actions：対象は開発者で、用途はPR作成・バグ修正・Issue対応などの自動化タスクです。
Code Review（研究プレビュー）：対象は開発チームで、用途はPRの自動レビューによる品質チェックです。

この後のセクションでは、上から順に具体的な設定手順と使い方を解説していきます。自分の目的がどれに当てはまるかを念頭に置きながら読み進めてみてください。

claude.ai（チャット・プロジェクト）でGitHubリポジトリを連携する方法

コーディング環境を用意しなくても、Anthropicヘルプセンターが案内するGitHubコネクタを使えば、claude.ai上でGitHubのファイルを直接参照できます。ここでは、チャットとプロジェクトそれぞれでの連携手順を見ていきます。

チャットでGitHubから直接ファイルを追加する手順

単発の会話でリポジトリの内容を参照したい場合は、チャット画面から手軽に連携できます。

画面左下の「+」ボタンをクリックします。
メニューから「GitHubから追加」を選択します。
表示されるファイルブラウザで、参照したい特定のファイルやフォルダを選択します。
選択後にメッセージを送信すると、Claudeが選んだファイルの内容にアクセスし、回答に反映します。

コードの一部だけを見てもらいたい、特定のドキュメントについて質問したいといった軽量な用途に向いた方法です。

プロジェクトにリポジトリを同期する手順

継続的にリポジトリの内容を参照しながら作業したい場合は、プロジェクト機能を使うと便利です。

プロジェクトの「プロジェクトナレッジ」セクションにある「+」をクリックします。
「GitHub」を選択します。
連携したいリポジトリのURLを貼り付け、追加するファイルを選択します。
選択したファイルはプロジェクトナレッジに追加され、以降は「同期」アイコンをクリックするだけで最新の内容に更新できます。

ドキュメントやMarkdownメモをナレッジベースとして常時参照したい非エンジニアの担当者にとって、この同期機能は特に有用です。なお、1つのプロジェクトやチャットには複数のリポジトリを追加できますが、追加したファイルはClaudeのコンテキストウィンドウに収まる範囲である必要がある点には注意が必要です。

プライベートリポジトリへの接続とSSO組織での注意点

プライベートリポジトリに接続しようとしてもアクセスできない場合は、GitHub Appへのリンクから管理者にアクセス許可を求めるか、組織管理者に直接リクエストを送る必要があります。

さらに注意したいのが、組織でSSO（シングルサインオン）を要求している場合の挙動です。GitHub接続がclaude.ai上で「接続済み」と表示されていても、プライベートリポジトリが一覧に表示されないケースが報告されています。この場合は、github.com/settings/applicationsにアクセスし、組織へのアクセスを個別に許可する操作が必要です。接続をいったん切断して再接続しても解決しない点は覚えておくとよいでしょう。

また、リポジトリへのアクセス権を後から失った場合、以前プロジェクトに追加していたコンテンツは表示できなくなりますが、それまでの会話履歴自体は保持されます。

連携時に取得される情報とベストプラクティス

GitHubコネクタを通じてClaudeが取得するのは、指定したブランチのファイル名とその中身のみです。コミット履歴やプルリクエスト、その他のメタデータは取得されません。プライバシー面での懸念を抑えつつ、必要な情報だけを共有できる設計になっています。

ベストプラクティスとしては、次の点を意識するとよいでしょう。

参照させるのは必要なファイル・フォルダに絞り、コンテキストウィンドウを圧迫しないようにします。
リポジトリの更新頻度が高い場合は、こまめに「同期」アイコンで最新化します。
利用可能な連携先の全体像はコネクタディレクトリから確認できるため、GitGub以外の外部サービスと組み合わせる際の参考にもなります。

Claude CodeとGitHub Actionsを連携する設定手順

Claude Code GitHub Actionsの導入方法は、大きく分けて「クイックセットアップ」と「手動セットアップ」の2通りです。どちらも最終的にはClaude Code Docsが示す構成にたどり着きますが、開発環境やAPIの利用形態によって適した方法が異なります。ここでは、開発者がつまずきやすいポイントを含めて具体的に解説します。

クイックセットアップ：/install-github-appコマンド

もっとも手早く連携を始めたい場合は、Claude Codeのターミナルで次のコマンドを実行するクイックセットアップがおすすめです。

/install-github-app

このコマンドを実行すると、Claude GitHub Appのインストールから、リポジトリへのワークフローファイルの追加、必要なシークレットの登録までを対話形式でガイドしてくれます。Claude Code v2.1.187以降であれば、「Skip for now」を選択することでGitHub Appの導入だけを先に済ませ、ワークフローの配置は後回しにすることも可能です。とりあえず権限だけ先に確保しておきたいチームには便利な選択肢です（出典: Claude Code Docs）。

ただし、このクイックセットアップ方式が使えるのはClaude APIを直接利用しているユーザーのみという制約があります。Amazon BedrockやGoogle Cloud経由でClaudeを利用している場合は、この方式ではなく別途用意されている手順に従う必要があるため、自社の利用形態を事前に確認しておきましょう。

手動セットアップ：GitHub Appのインストールとワークフロー配置

クイックセットアップが使えない場合や、ワークフローの内容を細かくコントロールしたい場合は、手動セットアップを選びます。手順は次の3ステップです。

Claude GitHub Appのページから、対象リポジトリにGitHub Appをインストールします。
ANTHROPIC_API_KEYをリポジトリのシークレットとして追加します。
公式が公開しているワークフロー例（examples/claude.yml）を、自分のリポジトリの.github/workflows/ディレクトリにコピーします。

この3ステップにより、Issueやプルリクエストで「@claude」とメンションするだけでClaudeが応答する基盤が整います。セットアップが完了したら、実際にIssueやPRのコメントで「@claude」をタグ付けし、正しく反応するかを確認してください。反応がない場合は、次で説明する権限設定に不備がないかを見直すのが近道です。

必要な権限とAPIキー管理の注意点

GitHub Appのインストールおよびシークレットの追加には、リポジトリの管理者権限が必要です。チームで導入する場合は、事前に管理者権限を持つメンバーに依頼しておくとスムーズに進みます。

また、GitHub Appに要求される権限は次の3種類で、いずれも読み取り・書き込みの両方が必要です。

Contents：コードの読み取りとPR作成のための書き込み
Issues：Issueの参照とコメント投稿
Pull requests：PRの参照、レビューコメントの投稿

APIキーの管理についても注意が必要です。ANTHROPIC_API_KEYは必ずGitHub Secretsとして登録し、ワークフローファイルに平文で書き込まないようにしてください。設定自体はこのセクションで完了しますが、キーの取り扱いや権限を最小限に絞るといった具体的なセキュリティ対策については、後ほど別のセクションで詳しく取り上げます。

なお、クイックセットアップ・手動セットアップのいずれを選んだ場合でも、連携が完了した時点ではまだ「導入しただけ」の状態です。実際に@claudeメンションでどのような操作ができるか、ワークフローをどう組み立てるかについては、次のセクションで具体的に解説します。

Claude Code GitHub Actionsでできること・使い方

セットアップが完了したら、実際にClaude Code GitHub Actionsをどう使いこなすかがポイントになります。ここでは@claudeメンションの基本操作から、実務で役立つワークフロー例、そしてv1.0移行時の注意点までを解説します。

@claudeメンションで実行できる基本操作

Claude Code GitHub Actionsの基本的な使い方は非常にシンプルです。任意のPRやIssueのコメント欄で「@claude」とメンションするだけで、Claudeがそのやり取りをトリガーに動き出します。

具体的には、以下のような操作が可能です。

コードの分析や質問への回答（「このロジックの意図を説明して」など）
新しいPRの作成（Issueの内容から実装案を組み立てて提案）
機能実装（要件をコメントで伝えると、該当ファイルを編集してコミット）
バグ修正（エラー内容を伝えると原因を特定し修正パッチを作成）

これらはすべてClaude Agent SDKの上に構築されており、Claude Codeがターミナルで行っているのと同じ思考プロセスを、GitHub上のコメントというインターフェースで実行できるイメージです。

なお、すべてのPRに自動的にレビューコメントを投稿する機能は、この@claudeメンション方式とは別に「Code Review」という独立した機能として提供されています。Code Reviewの詳細は次のH2で扱いますが、ここで紹介するGitHub Actionsは「呼びかけたときに動く」方式である点を押さえておくとよいです。

ワークフロー設定例（Issueコメント・スキル・スケジュール実行）

基本的なワークフローは、issue_commentやpull_request_review_commentといったイベントをトリガーにして、anthropics/claude-code-action@v1アクションを呼び出し、@claudeメンションへ応答する構成です。多くの導入例はこの形をベースにカスタマイズしていく形になります。

さらに一歩進んだ使い方として、promptにプレーンテキストの指示だけでなく、スキル呼び出しを指定することもできます。plugin_marketplacesとpluginsを使ってプラグイン化されたスキル（例えばclaude-code-actionリポジトリで公開されているcode-reviewプラグイン）を組み込めば、PRの新規作成・更新をトリガーに自動でレビュー相当の処理を走らせるワークフローも実現できます。

もう一つ便利なのが、cronによるスケジュール実行です。人がメンションしなくても、定期的にClaudeを動かすことができるため、たとえば「昨日のコミットとオープンIssueの要約を生成する」といった日次レポート的な自動化にも活用できます。チームの朝会前にClaudeが状況をまとめてくれるような運用も、この仕組みを使えば構築可能です。

ワークフローファイルの具体的な書き方は、claude-code-actionリポジトリのexamplesにサンプルが公開されているため、まずはこれをベースに自分のリポジトリ向けへ調整していくのが実践的です。

v1.0への移行で変わったポイント

2026年8月〜9月時点で注意したいのが、Claude Code GitHub Actionsがベータ版からv1.0へ移行し、いくつかの破壊的変更が加わっている点です。既存のワークフローをそのまま使い続けていると動作しなくなるケースがあるため、以下の変更点を確認しておく必要があります。

アクションの参照を@betaから@v1に変更する必要があります
mode指定は削除され、実行内容から自動検出される仕様に変わりました
direct_promptはpromptに置き換えられています
custom_instructions・max_turns・model・allowed_tools・disallowed_toolsは、個別のパラメータではなくclaude_args経由のCLI引数としてまとめて指定する形式に統合されました
claude_envは環境変数のリスト形式ではなく、settings JSON形式で記述する必要があります

これらはClaude Code Docsの公式ドキュメントに詳細が記載されているため、既にベータ版で運用しているワークフローがある場合は、移行前に一度目を通しておくことをおすすめします。特にclaude_argsへの統合は複数パラメータをまとめて書き直す作業になるため、YAMLファイルを丸ごと見直すくらいの気持ちで対応するとスムーズです。

Code Review（研究プレビュー）でPRを自動レビューする

前のH2で紹介したClaude Code GitHub Actionsは「@claudeメンション」をトリガーに動作する仕組みでしたが、これとは別に、すべてのプルリクエストに自動でレビューコメントを投稿する「Code Review」という機能が研究プレビューとして提供されています。ワークフローYAMLを自分で組む必要がなく、GitHub Appの設定だけで運用できる点がGitHub Actionsによるレビューとの大きな違いです。

Code Reviewは現時点でTeamおよびEnterpriseプランで利用可能です。ただし、ゼロデータ保持が有効な組織では利用できない点に注意が必要です。設定はClaude Codeのコードレビュー設定ガイドに沿って、claude.ai/admin-settings/claude-codeのCode Reviewセクションから行います。手順としては、まず組織にClaude GitHub Appをインストールし、続いてレビュー対象とするリポジトリを選択するだけで完了します。

Code Reviewの仕組みと重大度レベル

Code Reviewでは、複数のエージェントが並行してプルリクエストのdiffと周囲のコードを分析します。単純に変更行だけを見るのではなく、コードベース全体の文脈を踏まえてレビューする点が特徴です。分析後は、以下の3段階の重大度でランク付けされたインラインコメントとしてPR上に投稿されます。

🔴（通常）：マージ前に修正すべきバグ
🟡（軽微な問題）：致命的ではないものの改善が望ましい指摘
🟣（既存の問題）：今回の変更とは直接関係ないが、既存コードに残る課題

このレビューは平均20分程度で完了するとされており、人間のレビュアーが着手する前に一次チェックを済ませておく用途に向いています。また、リポジトリルートにCLAUDE.mdとREVIEW.mdを追加しておくと、どのような基準でフラグを立てるかをプロジェクトごとにカスタマイズできます。コーディング規約やレビューで重視したい観点をあらかじめ明文化しておくと、Code Reviewの指摘精度を実運用に近づけやすくなります。

レビュートリガーの選び方と料金

Code Reviewはレビューを実行するタイミングを次の3種類から選べます。

プルリクエスト作成後に1回：新規PRが立った時点で一度だけレビューする、最も軽量な運用
すべてのプッシュ後：コミットのたびにレビューが走るため精度は高まりますが、最もコストがかかる設定です
手動（@claude reviewとコメント）：必要なタイミングだけ人が明示的にレビューを呼び出す方式

チーム規模やPRの頻度に応じてトリガーを選ぶことで、レビュー精度とコストのバランスを取ることができます。

課金面では、Code Reviewはトークン使用量に基づいて別途請求される仕組みで、プランに含まれる使用量にはカウントされません。レビュー1回あたりの平均コストは15〜25ドルとされており、PRのサイズやコードベースの複雑さによってスケーリングします。頻繁にプッシュが発生するリポジトリで「すべてのプッシュ後」を選ぶと、このコストが積み上がりやすいため、まずは「プルリクエスト作成後に1回」から試し、必要に応じてトリガーを見直すのが現実的な運用と言えます。

運用コストとセキュリティ、既知の不具合

Claude Code GitHub Actionsを実運用に載せる際には、料金だけでなくセキュリティ管理や既知の不具合まで把握しておくと、導入後のトラブルを減らせます。

GitHub Actionsの実行コストとAPIトークン費用

Claude Code GitHub Actionsを利用すると、コストは大きく2つに分かれます。

GitHub Actionsの実行時間コスト：ワークフローはGitHubホストランナー上で実行されるため、GitHub Actionsの実行時間（分）を消費します。料金体系の詳細はGitHub Actions課金ドキュメントで確認できます。
APIトークン費用：プロンプトと応答の長さに基づいてトークンが消費されるため、タスクの複雑さやコードベースのサイズによってコストが変動します。最新の料金はClaude API価格ページを参照するのが確実です。

コストを抑えるには、以下のような工夫がClaude Code Docsで紹介されています。

特定の@claudeコマンドのみに反応させ、不要な呼び出しを減らす
claude_argsで適切な--max-turnsを設定し、対話ターン数を制限する
ワークフローレベルのタイムアウトを設定し、暴走を防ぐ
GitHubの並行制御（concurrency）で並列実行数を制限する

なお、Code Reviewの1回あたり15〜25ドルという料金は前のセクションで触れた通り別枠の課金であり、ここで挙げたGitHub Actionsのコストとは別に発生する点に注意が必要です。

セキュリティ管理の4つのポイント

APIキーやリポジトリへのアクセス権限を扱う以上、セキュリティ管理は運用の要になります。Claude Code Docsとセキュリティガイドで挙げられている主なポイントは次の4つです。

APIキーをコミットしない：APIキーはリポジトリに直接書き込まず、常にGitHub Secretsに登録します。ワークフロー内ではanthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}のように参照します。
権限を必要最小限に絞る：GitHub Appやワークフローに付与する権限は、Contents・Issues・Pull requestsなど実際に必要なものだけに限定します。
人によるレビューを挟む：Claudeが生成したコードやPRの提案は、マージ前に必ず人が確認する運用にします。
クラウド環境ではID連携を活用する：Amazon BedrockやGoogle CloudのAgent Platformを利用する場合は、直接API利用とは異なる認証セットアップが必要です。独自のGitHub App作成や、OIDCによるWorkload Identity Federationの設定が求められます。

既知の不具合：サブディレクトリが表示されない問題

2026年1月には、Claude Desktop／Web UIのGitHub連携において、サブディレクトリが見えなくなる障害が報告されました。DevelopersIOの記事によると、関連するGitHub Issueとして「サブディレクトリにアクセスできない（#17807）」「全ファイルが0%容量と表示される（#17824）」が挙げられています。

同記事では、以下のような基本的な対処を試しても効果がなかったケースが記録されています。

接続の再接続
GitHub Appの再インストール
新規プロジェクトでの確認
GitHub Appの権限確認

同様の症状に遭遇した場合は、まずリポジトリ全体を対象にするのではなくファイル単位で選択し直す、あるいは連携先のGitHub Issueの進捗を確認するなど、既知の不具合として切り分けて対応するのが現実的です。プライベートリポジトリでの表示不整合は、前のセクションで触れたSSO関連の制約とも紛れやすいため、まずどちらの問題かを区別することが早期解決の近道になります。

目的別に見るGitHub連携方法の選び方

ここまで紹介してきたclaude.aiのGitHubコネクタ、Claude Code GitHub Actions、Code Review（研究プレビュー）は、いずれも「GitHub連携」と呼ばれながら対象ユーザーも用途もまったく異なります。最後に3方式を整理し、目的別にどれを選べばよいかをまとめます。

対象ユーザーで選ぶ

コードを書かず、資料やナレッジを参照したいだけの人は、claude.aiのGitHubコネクタが最適です。チャットの「+」ボタンやプロジェクトのナレッジ機能からリポジトリを追加するだけで、コミット履歴やターミナル操作を意識せずに済みます。
Issue・PRの作成や修正を自動化したい開発者は、Claude Code GitHub Actionsが向いています。@claudeメンション一つでコード分析から実装まで任せられるため、日常の開発フローに組み込みやすいのが特徴です。
チーム全体でPRの品質を底上げしたい開発リーダーや運用担当者には、Code Review（研究プレビュー）が候補になります。人手を介さずに全PRへ自動でレビューコメントが付くため、レビュー漏れの防止に役立ちます。

必要なプランで選ぶ

claude.aiのコネクタはコネクタディレクトリから追加する標準機能で、多くのプランで利用できます。一方、Code ReviewはTeamおよびEnterpriseプラン限定で、ゼロデータ保持を有効にしている組織では使えない点に注意が必要です。Claude Code GitHub Actionsは、直接Claude APIを使う場合とAmazon Bedrock・Google Cloudを使う場合でセットアップ方法が異なるため、自社のAPI利用形態を先に確認しておくとスムーズです。

向いている用途で選ぶ

目的	向いている方式
ドキュメントやコードを読ませて質問したい	claude.aiのGitHubコネクタ
PRやIssueに対してコード修正・機能実装を自動化したい	Claude Code GitHub Actions
コミットやIssueの定期的な要約を自動生成したい	Claude Code GitHub Actionsのスケジュール実行
すべてのPRに自動でレビューコメントを付けたい	Code Review（研究プレビュー）

実際には、これらは排他的な選択肢ではなく併用が前提です。たとえば、日常的な調べ物にはclaude.aiのコネクタを使いつつ、開発フローにはGitHub Actionsを組み込み、さらに品質担保としてCode Reviewを有効化するといった組み合わせも十分に現実的です。まずは自分の当面の課題が「調べたい」のか「自動化したい」のか「レビューさせたい」のかを切り分けたうえで、該当するセクションの手順に沿って導入を進めてみてください。

まとめ

Claudeが提供するGitHub連携は、資料やコードを参照したいだけならclaude.aiのGitHubコネクタ、Issue・PRの作成や修正を自動化したいならClaude Code GitHub Actions、全PRの品質を自動チェックしたいならCode Review（研究プレビュー）というように、目的に応じて選ぶべき方式が異なります。それぞれプラン要件や料金体系も異なるため、導入前に自社の利用形態とAPIの契約状況を確認しておくことが大切です。またGitHub Actionsを使う場合は、v1.0移行に伴うclaude_argsへの統合などの破壊的変更や、APIキーの安全な管理方法にも注意が必要です。まずは自分の課題が「調べたい」のか「自動化したい」のか「レビューさせたい」のかを切り分け、該当するセクションの手順に沿って一つずつ設定を進めてみてください。併用することで、日常の調べ物から開発フロー、品質担保までを一貫してカバーできます。