メインコンテンツにスキップ

GitHubインテグレーションを使用する

アカウント内でGitHubを有効にする方法の詳細については、コネクタを使用してClaudeの機能を拡張するを参照してください。

GitHubリポジトリをClaudeに直接接続して、ソフトウェア開発タスクの包括的なコンテキストを提供します。リストから選択してリポジトリを簡単に追加でき、Claudeがコードベースをより良く理解し、支援できるようになります。

GitHubリポジトリを追加する方法

注: 現在GitHubで認証されていない場合、このインテグレーションを使用する前に、GitHubにリダイレクトされて認証する必要があります。

チャット

  1. チャットインターフェースの左下隅にある「+」ボタンをクリックします。

  2. ドロップダウンから「GitHubから追加」を選択します。

  3. ファイルブラウザを使用して、特定のファイルとフォルダを選択します。

  4. メッセージを送信すると、Claudeはコンテンツにアクセスして処理し、その応答に反映させます。

プロジェクト

  1. プロジェクトナレッジセクションの右上隅にある「+」ボタンをクリックします。

  2. ドロップダウンから「GitHub」を選択します。

  3. アクセス可能なリポジトリを検索するか、リポジトリURLを貼り付けます。

  4. ファイルブラウザを使用して、特定のファイルとフォルダを選択します。

  5. 選択したコンテンツがプロジェクトナレッジに追加され、Claudeがアクセスして処理できるようになります。

  6. 「同期」アイコンを使用して、コードベースの最新バージョンで作業していることを確認できます。

  7. 「ファイルを構成」アイコンを使用して、Claudeが分析するファイルとフォルダを変更できます。

プライベートリポジトリに接続する

  • 有効なURLを入力した後、Claudeがリポジトリにアクセスできない場合、Claudeをプライベートリポジトリに接続しようとしている可能性が高いです:GitHubアプリへのリンクをたどってください。GitHubの管理者であれば、リポジトリへのアクセスを許可できます。そうでない場合は、GitHub組織の管理者にリクエストを送信してください。

  • できれば自分でアクセスを許可してください:Claudeがすべてのリポジトリにアクセスするか、特定のリポジトリのみにアクセスするかを選択できます。

  • 必要な権限がない場合はアクセスをリクエストしてください:GitHub組織の管理者がリクエストについてのメール通知を受け取ります。管理者がリクエストを承認すると、Claudeでリポジトリを同期してアクセスできるようになります。


ベストプラクティス

  1. 小さく始める:コードベースの小さなサブセットを選択して分析することから始めます。これにより、Claudeがコードをどのように解釈し、議論するかを理解するのに役立ちます。

  2. 反復と改善:Claudeの最初の応答が質問に完全に対応していない場合は、遠慮なくフォローアップの質問をするか、説明を求めてください。

  3. 人間の専門知識と組み合わせる:Claudeの洞察を、チームとのさらなる調査と議論の出発点として使用してください。Claudeの作業を確認してください。

  4. 思慮深いファイル選択:「ファイルを構成」を使用する場合、選択について戦略的に考えてください。現在のタスクまたはプロジェクトの中心となる主要なファイルとディレクトリを含めますが、トークン制限内に留まり、焦点を維持するために不要なファイルの選択は避けてください。

  5. 定期的な更新:プロジェクトのGitHub同期を定期的に更新して、Claudeが最新バージョンのコードベースで作業していることを確認してください。特に新しい分析を開始する前、またはリポジトリに大きな変更があったことがわかっている場合に重要です。


トラブルシューティング

組織からのリポジトリが接続後に表示されない

GitHub接続が接続済みと表示されているが、特定の組織からのプライベートリポジトリが表示されない場合、その組織はシングルサインオン(SSO)を要求している可能性があります。SSOが必要な場合、各ユーザーはその組織のClaudeアプリを個別に認可する必要があります。そうするまで、接続は正常に機能していても、GitHubはその組織のプライベートリポジトリをビューからフィルタリングします。

Claudeがこの状態を検出すると、リポジトリピッカーはSSOを認可するよう促すバナーを表示します。組織のClaudeアプリを認可するには:

  1. github.com/settings/applicationsに移動して、Claudeエントリを開きます。

  2. 組織アクセスの下で、関連するGitHub組織の横にある「許可」をクリックします。

  3. ボタンが「許可」ではなく「リクエスト」と表示されている場合、アプリを自分で認可する権限がありません。GitHub組織の管理者が組織のOAuthアプリケーションポリシー設定からリクエストを承認する必要があります。

重要:Claude設定でGitHubを切断して再接続しても、これは解決されません。新しい接続はSSOを必要とする組織を自動的に認可しないため、上記の認可手順を完了する必要があります。

組織がエンタープライズマネージドユーザー(EMU)を備えたGitHub Enterprise Cloudを使用している場合、Claudeアプリはエンタープライズレベルでも承認される必要があります。詳細については、Claude Codeのコードレビューを設定するを参照してください。


よくある質問

GitHubからどのような情報が取得されますか?

特定のブランチのリポジトリ内のファイル(名前とコンテンツ)のみが同期されます。コミット履歴、PR、またはその他のメタデータは取得されません。

プロジェクトに追加した後、リポジトリが更新された場合はどうなりますか?

「今すぐ同期」をクリックして、リポジトリから最新の変更を取得できます。これにより、以前に選択したすべてのファイルとフォルダが更新されます。

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

はい、複数のリポジトリを追加して、開発タスクの包括的なコンテキストをClaudeに提供できます。リポジトリはClaudeのコンテキストウィンドウ内に収まる必要があります。

リポジトリへのアクセスを失った場合はどうなりますか?

リポジトリへのアクセスを失った場合、以前に追加されたプロジェクトでそのコンテンツを表示できなくなります。リポジトリプレビューは削除されますが、会話履歴は保持されます。

コネクタディレクトリで利用可能なすべてのコネクタを参照してください。

こちらの回答で解決しましたか?