GitHubリポジトリをClaudeに直接接続して、ソフトウェア開発タスクの包括的なコンテキストを提供します。リストから選択してリポジトリを簡単に追加でき、Claudeがコードベースをより良く理解し、支援できるようになります。
アカウント内でGitHubを有効にする方法の詳細については、コネクタを使用してClaudeの機能を拡張するを参照してください。
GitHubリポジトリを追加する方法
注: 現在GitHubで認証されていない場合、この統合を使用する前に、GitHubにリダイレクトされて認証する必要があります。
チャット
チャットインターフェースの左下隅にある"+"ボタンをクリックします。
ドロップダウンから"GitHubから追加"を選択します。
ファイルブラウザを使用して、特定のファイルとフォルダを選択します。
メッセージを送信すると、Claudeはコンテンツにアクセスして処理し、その応答に反映させます。
プロジェクト
プロジェクトナレッジセクションの右上隅にある"+"ボタンをクリックします。
ドロップダウンから"GitHub"を選択します。
アクセス可能なリポジトリを検索するか、リポジトリURLを貼り付けます。
ファイルブラウザを使用して、特定のファイルとフォルダを選択します。
選択したコンテンツがプロジェクトナレッジに追加され、Claudeがアクセスして処理できるようになります。
"同期"アイコンを使用して、コードベースの最新バージョンで作業していることを確認できます。
"ファイルを構成"アイコンを使用して、Claudeが分析するファイルとフォルダを変更できます。
プライベートリポジトリに接続する
有効なURLを入力した後、Claudeがリポジトリにアクセスできない場合、Claudeをプライベートリポジトリに接続しようとしている可能性が高いです:GitHub Appへのリンクをたどってください。GitHubの管理者の場合はリポジトリへのアクセスを許可できます。または、GitHub組織の管理者にリクエストを送信してください。
可能な場合は自分でアクセスを許可する:Claudeがすべてのリポジトリにアクセスするか、特定のリポジトリのみにアクセスするかを選択できます。
必要な権限がない場合はアクセスをリクエストする:GitHub組織の管理者がリクエストについてのメール通知を受け取ります。管理者がリクエストを承認すると、Claudeでリポジトリを同期してアクセスできるようになります。
ベストプラクティス
小さく始める:コードベースの小さなサブセットを選択して分析を開始します。これにより、Claudeがコードをどのように解釈し、議論するかを理解するのに役立ちます。
反復と改善:Claudeの初期応答が質問に完全に対応していない場合は、遠慮なくフォローアップの質問をするか、説明をリクエストしてください。
人間の専門知識と組み合わせる:Claudeの洞察をさらなる調査とチームとの議論の出発点として使用してください。Claudeの作業を確認してください。
思慮深いファイル選択:「ファイルを構成」を使用する場合、選択について戦略的に考えてください。現在のタスクまたはプロジェクトの中心となる主要なファイルとディレクトリを含めますが、トークン制限内に留まり、焦点を維持するために不要なファイルの選択は避けてください。
定期的な更新:プロジェクトのGitHub同期を定期的に更新して、Claudeがコードベースの最新バージョンで作業していることを確認してください。特に新しい分析を開始する前、またはリポジトリに大きな変更があったことがわかっている場合に重要です。
トラブルシューティング
接続後、組織のリポジトリが表示されない
GitHub接続が接続済みと表示されているが、特定の組織のプライベートリポジトリが表示されない場合、その組織はシングルサインオン(SSO)を要求している可能性があります。SSOが必要な場合、各ユーザーはその組織のClaudeアプリを個別に認可する必要があります。そうするまで、接続は正常に機能していても、GitHubはその組織のプライベートリポジトリをビューからフィルタリングします。
Claudeがこの状態を検出すると、リポジトリピッカーにSSOを認可するよう促すバナーが表示されます。組織のClaudeアプリを認可するには:
github.com/settings/applicationsに移動して、Claudeエントリを開きます。
組織アクセスの下で、関連するGitHub組織の横にある"許可"をクリックします。
ボタンが"許可"ではなく"リクエスト"と表示されている場合、アプリを自分で認可する権限がありません。GitHub組織の管理者が組織のOAuthアプリケーションポリシー設定からリクエストを承認する必要があります。
重要:Claude設定でGitHubを切断して再接続しても、これは修正されません。新しい接続はSSOを必要とする組織を自動的に認可しないため、上記の認可手順を完了する必要があります。
組織がEnterprise Managed Users(EMU)を備えたGitHub Enterprise Cloudを使用している場合、マネージドアカウントでサインインしており、アクティブなSSOセッションがある状態でGitHubに接続してください。組織の所有者は、GitHub組織の設定>サードパーティアクセス>GitHub Appsの下でClaudeアプリを確認し、必要なリポジトリへのアクセス権があり、保留中の権限リクエストがないことを確認できます。
ゼロデータ保持を持つ組織にGitHubをリンクできない
組織がClaude Codeに対してゼロデータ保持(ZDR)を有効にしている場合、Claude GitHubアプリをClaude組織にリンクすることはできません。これはZDRの制限であり、GitHubの権限の問題ではありません:リンクするには、Anthropicが組織のGitHub接続を保存する必要があり、ZDRではこれが許可されていません。
組織設定>GitプロバイダでGitHubをリンクしようとすると、すでに所有者である場合でも、GitHub組織の所有者である必要があるというエラーが表示される場合があります。
重要:GitHubで役割またはアプリの権限を変更したり、GitHubを切断して再接続したりしても、これは修正されません。同じ理由で、Claude Code分析の貢献メトリクスはZDR組織では利用できません。
組織がGitHubリンクが必要な場合は、Anthropicアカウントチームに連絡して、ZDR構成について相談してください。Claude Codeのゼロデータ保持について詳しく学ぶ。
よくある質問
GitHubから取得される情報は何ですか?
特定のブランチのリポジトリ内のファイル(名前とコンテンツ)のみが同期されます。コミット履歴、PR、またはその他のメタデータは取得されません。
プロジェクトに追加した後、リポジトリが更新された場合はどうなりますか?
"今すぐ同期"をクリックして、リポジトリから最新の変更を取得できます。これにより、以前に選択したすべてのファイルとフォルダが更新されます。
1つのプロジェクトまたはチャットに複数のリポジトリを追加できますか?
はい、複数のリポジトリを追加して、開発タスクの包括的なコンテキストをClaudeに提供できます。リポジトリはClaude のコンテキストウィンドウ内に収まる必要があります。
リポジトリへのアクセスを失った場合はどうなりますか?
リポジトリへのアクセスを失った場合、以前に追加されたプロジェクトでそのコンテンツを表示することはできません。リポジトリプレビューは削除されますが、会話履歴は保持されます。
コネクタディレクトリで利用可能なすべてのコネクタを参照してください。