Claude GitHub連携の使い方 — チャット・プロジェクトでリポジトリを参照する

Claude GitHub連携とは

Claude GitHub連携は、GitHubのリポジトリをチャットやプロジェクトに直接追加し、ファイルの内容をコードの文脈としてClaudeに渡す標準搭載のConnectorです。ファイル単位・フォルダ単位で選んで追加でき、公開リポジトリだけでなくプライベートリポジトリも許可設定を済ませれば対象にできます。

この連携が扱うのは、指定したブランチのファイル名とファイルの中身だけです。コミット履歴やプルリクエスト、Issueといったメタデータは取得しません。コードレビューの自動化やIssue操作まで任せたい場合は対象が異なり、GitHub自身が公開するGitHub MCPサーバーや、Claude CodeのGitHub PR自動レビューがその役割を担います。本記事が扱うのは、あくまでコードを読ませて質問するための文脈提供の連携です。

Connectors全体の中でGitHubがどう位置づくかはClaude Connectorsとはで整理しています。

チャットでリポジトリを参照する手順

チャット画面での追加は3ステップです。

1. チャット入力欄の左下にある「+」ボタンをクリックする
2. ドロップダウンから「Add from GitHub」を選ぶ
3. ファイルブラウザーで参照したいファイル・フォルダを選ぶ

選択が終わってメッセージを送信すると、Claudeはその内容を読み込んで回答に反映します。GitHubで未認証の場合は、この時点で認証画面にリダイレクトされます。チャットでの追加はその会話限りの一時的な参照で、プロジェクトのナレッジのように継続して残る仕組みではありません。1回きりの質問や、特定のファイルだけをその場で確認したいときに向いています。

プロジェクトにリポジトリを追加する手順

プロジェクトのナレッジにリポジトリを組み込む手順はチャットよりやや工程が多く、継続的な参照を想定した作りになっています。

1. プロジェクトのナレッジセクション右上にある「+」をクリックする
2. ドロップダウンから「GitHub」を選ぶ
3. アクセス可能なリポジトリを検索するか、リポジトリのURLを直接貼り付ける
4. ファイルブラウザーで対象のファイル・フォルダを選ぶ
5. 選択した内容がプロジェクトナレッジに追加される

追加後は2つのアイコンが使えるようになります。「Sync」はリポジトリの最新状態を取り込み直すアイコンで、「Configure files」は分析対象のファイル・フォルダを後から変更するアイコンです。コードベースに大きな変更が入ったタイミングや、新しい分析を始める前には、この同期を挟む運用が実務的です。

プライベートリポジトリへのアクセスを許可する

有効なリポジトリURLを入力してもClaudeが中身を取得できない場合、多くはプライベートリポジトリへの接続がまだ許可されていないことが原因です。対処は権限によって2通りに分かれます。

• GitHub管理者本人の場合: Claude公式のGitHub Appのページからアクセスを許可します。全リポジトリを許可するか、対象を絞るかを選べます
• 管理者権限がない場合: アクセスをリクエストします。GitHub組織の管理者にメール通知が届き、承認されると同期・参照ができるようになります

組織のSSOでリポジトリが表示されないときの対処

GitHub接続自体は成立しているのに、特定の組織のプライベートリポジトリだけがピッカーに出てこないことがあります。多くの場合、その組織がシングルサインオン(SSO)を必須にしているのが原因です。SSOが必須な組織では、メンバー1人ずつが自分でその組織向けにClaudeアプリを認可し直す必要があり、これをしていないとGitHub側がその組織のプライベートリポジトリを一覧から除外します。接続自体は正常に動いたままなので、一見すると原因が分かりにくいつまずき方です。

この状態をClaudeが検知すると、リポジトリピッカーにSSO認可を促すバナーが表示されます。認可の手順は次の通りです。

1. github.com/settings/applicationsを開き、Claudeのエントリを選ぶ
2. 「Organization access」欄で該当するGitHub組織の横にある「Grant」をクリックする
3. ボタンが「Grant」でなく「Request」と表示されている場合、自分にはその組織を認可する権限がない。GitHub組織のOAuthアプリケーションポリシー設定から管理者に承認してもらう

GitHub Enterprise CloudでEnterprise Managed Users(EMU)を使っている組織では、この認可に加えてエンタープライズレベルでの承認も必要です。

GitHub MCPサーバーとの違い

同じ「GitHubとClaudeをつなぐ」話でも、この連携とGitHub MCPサーバーは対象範囲がまったく異なります。

コードを読んで質問したいだけならこの連携で十分です。Issueの起票やPRの自動化までコード側から操作したい場合は、GitHub MCPサーバーの使い方を確認してください。

うまく使うコツ

公式のベストプラクティスとして、いくつかの運用上の注意点が挙げられています。最初から大きなリポジトリ全体を選ぶのではなく、小さめのサブセットから始めるとClaudeの読み方の傾向がつかみやすくなります。ファイル選択は「Configure files」で戦略的に絞り込むのが要点です。不要なファイルまで含めるとコンテキストウィンドウを圧迫し、回答の焦点がぼやけます。

複数リポジトリを1つのプロジェクトやチャットに同時追加することもできます。ただし合計のファイル量はClaudeのコンテキストウィンドウに収まる範囲に限られるため、関連性の低いリポジトリまで足すと、かえって的確な回答が返りにくくなります。

Claudeの回答をそのまま採用するのではなく、人によるレビューを挟む姿勢も公式のベストプラクティスに含まれています。Claudeの分析はチームでの調査や議論の出発点として使い、最終的な判断はコードを書いた本人やレビュアーが確認する運用が前提です。初回の回答が期待とずれていたら、遠慮せず追加の質問や条件の絞り込みを重ねます。

よくあるつまずき

リポジトリを更新したのにClaudeの回答が古いままのときは、単に同期し忘れているケースがほとんどです。プロジェクトでは「Sync」アイコンを押すまで最新化されません。チャットでは追加のたびに新しく選び直す必要があり、過去のメッセージで参照した内容は自動更新されません。

アクセス権を失ったリポジトリは、それ以降プロジェクト内でプレビューできなくなります。会話履歴自体は残りますが、リポジトリのプレビュー表示は消えます。組織の異動やリポジトリの権限変更があったタイミングでこの症状が出た場合は、まず自分のGitHubアカウント側でそのリポジトリへのアクセス権が現在も有効かを確認するのが切り分けの第一歩です。

よくある質問

GitHubから取得される情報は何ですか

特定のブランチにあるファイルの名前と中身だけです。コミット履歴やプルリクエストなど、それ以外のメタデータは取得しません。

プロジェクトに追加した後でリポジトリが更新されたらどうなりますか

自動では反映されません。「Sync now」をクリックすると最新の変更を取得し、以前選択していたファイル・フォルダの内容を更新します。

複数のリポジトリを1つのプロジェクトやチャットに追加できますか

できます。開発タスクに必要な文脈を複数リポジトリにまたがって渡せます。ただし合計のファイル量はClaudeのコンテキストウィンドウに収まる範囲が前提です。

まとめ

Claude GitHub連携は、チャットの「+」ボタンかプロジェクトのナレッジ画面から、ファイル・フォルダ単位でリポジトリをClaudeに読ませる標準搭載のConnectorです。プライベートリポジトリはGitHub App側の許可かリクエストが必要で、組織がSSOを必須にしている場合はメンバー個別の認可がもう1段階加わります。Issueの起票やPR操作まで含めたコード側の自動化が必要になったら、対象が異なるGitHub MCPサーバーやClaude CodeでのGitHub PR自動レビューに切り替える場面です。Coworkから同じ接続を使う場合の承認モードはClaude CoworkのConnectors一覧にまとめています。