• Hash icon  Claude
  • Hash icon  GitHub
  • Hash icon  プライベートリポジトリ
  • Hash icon  AI

    • Claude ProjectsでGitHubプライベートリポジトリを追加する方法｜GitHub App設定で完了

    Calendar icon Published:
    Claude ProjectsでGitHubプライベートリポジトリを追加する方法｜GitHub App設定で完了

    Claude Projectsでプライベートリポジトリが見えない？正しい設定方法はこれ！

    エンジニアの皆さん、Claude ProjectsでGitHubプライベートリポジトリを追加しようとして「表示されない」「アクセスできない」で困っていませんか？

    実は、Claude for GitHub Appの権限設定が重要なポイントなんです。多くの記事で「OAuth認証だけ」と書かれていますが、実際にはGitHub Appのインストールと権限付与が必要です。

    この記事では、2025年6月現在の正しい手順を図解付きで解説します。Personal Access Tokenも複雑な設定も不要で、たった3ステップで完了しますよ！

    Claude ProjectsのGitHub連携の仕組み【2025年最新】

    まず、Claude ProjectsがどのようにGitHubと連携するかを理解しておきましょう。

    GitHub Appを使った安全な連携

    Claude ProjectsはClaude for GitHub AppというGitHubアプリケーションを通じてリポジトリにアクセスします。

    従来の方法（Personal Access Token）:

    • ❌ 個人のトークン管理が必要
    • ❌ スコープ設定が複雑
    • ❌ セキュリティリスク

    現在の方法（GitHub App）:

    • ✅ アプリ単位での権限管理
    • ✅ 細かい権限制御が可能
    • ✅ GitHubの標準的な仕組み
    • ✅ セキュリティが向上

    プライベートリポジトリアクセスの仕組み

    GitHub Appをインストールする際に、以下の権限を設定できます：

    リポジトリ選択:

    • All repositories: 全てのリポジトリ（パブリック + プライベート）
    • Selected repositories: 指定したリポジトリのみ

    権限レベル:

    • Read: コード読み取り（Claude Projectsに必要）
    • Write: コード変更（Claude Projectsでは不要）
    • Admin: 管理者権限（Claude Projectsでは不要）

    事前準備：これだけ確認してください

    必要なもの

    ✅ Claude Pro（月額$20）への加入 ✅ GitHubアカウント（Free/Pro問わず） ✅ プライベートリポジトリへの権限（Owner, Admin, またはRead以上）

    組織リポジトリの場合の注意点

    組織のプライベートリポジトリを追加する場合：

    • 個人: 自分で設定完了
    • 組織メンバー: 組織の「Third-party application access policy」を確認
    • 管理者の場合: 自由に設定可能
    • 一般メンバー: 管理者の承認が必要な場合あり

    【正しい手順】3ステップでプライベートリポジトリを追加

    ステップ1：Claude ProjectsでGitHub連携を開始

    1. Claude Projects（https://claude.ai/projects）にアクセス
    2. 既存プロジェクトを開くか「New Project」で新規作成
    3. プロジェクト画面で「+ Add Content」をクリック
    4. 連携オプションから「GitHub」を選択

    Claude ProjectsでGitHub選択

    ステップ2：Claude for GitHub Appをインストール

    1. 「Connect with GitHub」をクリック
    2. Claude for GitHub App のインストール画面に遷移

    直接アクセス: https://github.com/apps/claude-for-github

    1. リポジトリアクセス権限を選択：

    選択肢A: All repositories（推奨）

    • 全てのリポジトリ（パブリック + プライベート）にアクセス
    • 新しく作成するリポジトリも自動で対象
    • 設定が簡単

    選択肢B: Only select repositories

    • 特定のリポジトリのみ選択
    • セキュリティを重視する場合
    • 後から追加・削除が可能

    リポジトリアクセス権限選択

    1. 「Install」をクリック

    ステップ3：Claude Projectsでリポジトリを選択

    1. インストール完了後、Claude Projectsに戻る
    2. リポジトリ一覧が表示される（プライベートリポジトリも含む）

    リポジトリ選択画面

    1. 追加したいプライベートリポジトリを選択
    2. 「Add to Project」で完了！

    動作確認

    あなた: 「このリポジトリの構成を教えて」
Claude: 「このプロジェクトの構成は以下の通りです：

📁 src/
  ├── main.py (メインアプリケーション)
  ├── config/ (設定ファイル群)
  └── utils/ (ユーティリティ関数)
📁 tests/ (テストコード)
📄 README.md
📄 requirements.txt
...」

    プライベートリポジトリの詳細が表示されれば成功です！

    Claude Projectsでできること

    Claude ProjectsでGitHubプライベートリポジトリを追加すると、以下のようなことができます：

    • AIコードレビュー: バグやセキュリティ脆弱性の自動検出
    • ドキュメント生成: README、API仕様書の自動作成
    • リファクタリング提案: コード改善案の具体的な提示
    • 技術負債の特定: 保守性向上のための改善点抽出
    • チーム規約チェック: 社内コーディング規約への準拠確認

    詳しい活用方法は今後の記事で解説予定です。まずは設定を完了させましょう！

    よくある問題と解決法

    組織のリポジトリが表示されない

    原因: 組織の「Third-party application access policy」による制限

    解決法:

    1. 組織のSettings → Third-party access
    2. 「Claude」アプリケーションを承認
    3. または組織管理者に承認を依頼

    特定のリポジトリだけ見えない

    原因: GitHub Appインストール時に「Selected repositories」を選択し、そのリポジトリが含まれていない

    解決法:

    1. GitHub Settings → Applications → Installed GitHub Apps
    2. 「Claude」の設定を開く
    3. Repository accessで追加したいリポジトリを選択

    「Access denied」エラー

    原因: リポジトリへの読み取り権限不足

    解決法: リポジトリの「Settings」→「Collaborators」で最低でもRead権限があるか確認

    よくある質問（FAQ）

    Q: Personal Access Tokenは本当に不要ですか？

    A: 2025年現在、通常のClaude Projects（Web版）では不要です。Personal Access Tokenが必要なのは：

    • Claude Desktop + MCP連携
    • Claude Code GitHub Actions
    • 古いバージョン（2024年以前）

    現在はGitHub Appで完結します。

    注意: 「Claude」と「Claude for GitHub」は別のGitHub Appです：

    • Claude for GitHub: Claude Projectsでのリポジトリ連携用（本記事の対象）
    • Claude: GitHub Actions・PR自動化用（別の用途）

    Q: 「All repositories」と「Selected repositories」どちらがおすすめ？

    A: 用途によって使い分けをおすすめします：

    All repositories（推奨）:

    • 個人開発者
    • 小規模チーム
    • 設定の手間を省きたい場合

    Selected repositories:

    • 大規模組織
    • セキュリティを重視
    • 特定プロジェクトのみ使用

    Q: GitHub Appの権限で何ができますか？

    A: Claude for GitHub Appは読み取り専用です：

    取得される情報:

    • ファイル名とファイル内容のみ
    • 指定ブランチの最新状態

    取得されない情報:

    • コミット履歴
    • プルリクエスト
    • Issue
    • その他のメタデータ

    できること:

    • ファイル内容の読み取りと分析
    • コードレビューと改善提案
    • ドキュメント生成

    できないこと:

    • コードの変更・追加
    • コミット・プッシュ
    • Issue/PRの作成

    Q: 組織管理者の承認が必要ですか？

    A: 組織の設定によります：

    • 承認不要: メンバーが自由にアプリインストール可能
    • 承認必要: 管理者の事前承認が必要
    • 禁止: Third-party appの利用を禁止

    事前に組織のポリシーを確認してください。

    Q: 後からリポジトリを追加できますか？

    A: はい、簡単に追加可能です：

    1. GitHub Settings → Applications → Installed GitHub Apps
    2. 「Claude」の設定を開く
    3. Repository accessで追加リポジトリを選択

    Q: セキュリティは大丈夫ですか？

    A: GitHub Appは以下の安全性があります：

    • 最小権限の原則: 読み取り専用アクセス
    • スコープ制限: 指定したリポジトリのみ
    • 監査ログ: GitHubでアクセス履歴を確認可能
    • 即座の取り消し: いつでもアプリ削除可能

    まとめ

    Claude ProjectsでGitHubプライベートリポジトリを追加するには、Claude for GitHub Appのインストールと適切な権限設定が重要です。Personal Access Token不要で、3ステップで簡単に完了します。

    組織利用の場合は事前にポリシーを確認し、適切な権限範囲（All repositories vs Selected repositories）を選択しましょう。

    設定完了後は、AIによる高精度なコードレビューと開発効率の向上を実感できるはずです！

    参考リンク

    免責事項: 本記事は2025年6月19日時点の情報に基づいています。Claude ProjectsやGitHubの仕様は変更される可能性がありますので、最新情報は各公式サイトでご確認ください。

    セキュリティに関する設定は、ご利用の組織のポリシーに従って慎重に行ってください。

    Share this post on:
    Facebook Share this post on Facebook X Share this post on X Mail Share this post via email

    このトピックの他の記事

    VSCodeで確実に休憩を取る方法：Time Keeper拡張機能完全ガイド

    2025/06/27

    Blender MCPでAIが3D制作してくれるって本当？Claude Desktopと連携してみた結果が凄すぎた

    2025/06/22

    Go言語でGitHub Bot作ってみた

    2025/05/27

    前の記事
    Blender MCPでAIが3D制作してくれるって本当？Claude Desktopと連携してみた結果が凄すぎた
    次の記事
    Go言語でGitHub Bot作ってみた