【注意】ClaudeのGitHub連携はまだ未熟？プライベートリポジトリ＆devブランチの連携手順と落とし穴

こんにちは、編集長Kです。

システム開発の現場でClaudeの「プロジェクト機能」を活用している方も多いと思います。GitHub連携は手動でコードをコピペする手間を省ける魅力的な機能ですが……現場でガッツリ使ってみると、「正直、まだ機能としてかなり未熟だな」と感じる場面が多々あります。

今回は、プライベートリポジトリやdevブランチを連携する具体的な手順に加え、私が実際に直面した「連携の落とし穴」とその対処法について、現場の本音を交えて解説します。

スポンサーリンク

結論：GitHub連携は便利だが「過信は禁物」

設定手順の前に、まずお伝えしたい現場のリアルがあります。それは「UI上で連携が完了していても、Claudeが中身を正しく認識していないことが頻発する」という事実です。

Trade Agency 編集長

実は先日、この記事で紹介する手法でdevブランチを連携した直後に「適当なファイルの中身を出力して」と指示したところ、Claudeから「ファイルが見つかりません」と平然と返される事態が発生しました。

同期ステータスが完了になっていても、内部のインデックス生成が追いついていないのか、それとも単なるバグなのか、指定したコードを読み込んでくれない挙動が散見されます。

「AIにコードを読ませたつもりが、実は一般論で回答されていた」という事故を防ぐためにも、連携機能はまだ発展途上（ベータ版に近いクオリティ）であることを前提に活用する必要があります。※2026年3月14日に試した結果

なぜプライベートリポジトリが見えないのか？

ここからは具体的な連携手順です。まず最初の壁である「プライベートリポジトリがリストに表示されない」問題は、GitHub側で付与した「Claudeアプリへのアクセス権限」が原因のほとんどを占めます。

GitHub側でのアクセス権限の変更手順

1. GitHubの右上プロフィールアイコンから「Settings（設定）」を開く
2. 左側サイドバー下部の「Applications」をクリック
3. 「Installed GitHub Apps」タブから「Claude」を探して「Configure」をクリック
   => Claudeが見つからない場合はClaudeからGithubへの連携が完了していません
4. 「Repository access」の項目までスクロールする
5. アクセス範囲を「All repositories」または「Only select repositories」に変更し保存する
   => 「All repositories」はあくまでpublicな全てのリポジトリ、「Only select repositories」で参照許可するprivateリポジトリを選択する必要がある。

【裏技】権限があるのにリストに出ない場合の対処法

権限を正しく付与したにもかかわらず、Claude側の選択リストにすぐ反映されないケースも多々あります。その場合は、リストから探すのをやめて【URLの直接入力】を試してください。

Claude側のリポジトリ検索窓に、連携したいプライベートリポジトリのURL（例: https://github.com/ユーザー名/リポジトリ名）を直接ペーストしてEnterを押すだけで、強制的に読み込ませることができます。

mainブランチではなくdevブランチを参照させる方法

実際の開発では、最新機能を追加しているdevブランチやfeatureブランチのコードをAIにレビューしてほしいですよね。しかし、現在のClaudeのUIには「ブランチ切り替えボタン」が存在しません。これも機能の未熟さを感じるポイントです。

しかし、先ほどの裏技を応用することで、任意のブランチを参照することが可能です。

devブランチを読み込ませる手順

GitHub上でdevブランチを開いた状態のURLを取得し、それをClaudeに直接読み込ませます。大前提として、ローカルの変更がリモートのdevブランチにプッシュされているか確認しておきましょう。

# devブランチへの切り替え
git checkout dev

# リモートのdevブランチへ修正内容反映
git push origin dev

# devブランチへの切り替え
git checkout dev

# リモートのdevブランチへ修正内容反映
git push origin dev

1. GitHubを開き、対象リポジトリの「dev」ブランチに切り替える
2. ブラウザのアドレスバーにあるURL（末尾が /tree/dev となっているもの）をコピーする
3. Claudeの「Search or paste a repository URL」窓にそのまま貼り付ける
4. devブランチのファイルツリーが表示されるので、必要なものを追加する

Trade Agency 編集長

ブランチを切り替える際は、必ず古いプロジェクトファイルをゴミ箱アイコンで削除してから追加し直してください。新旧のコードが混在すると、AIがさらに混乱して「見つかりません」エラーを誘発する原因になります。

同期の安定性にはまだ難がありますが、コード解析の精度自体は本物です。ツールの未熟な部分を人間がカバーしながら使うのが、現在の最適解と言えるでしょう。

よくある質問（FAQ）

まとめ

ClaudeとGitHubプライベートリポジトリ・devブランチの連携手順と、その「不安定さ」について解説しました。

• GitHub連携機能はまだ未熟。「ファイルが見つからない」エラーは頻発する
• プライベートリポジトリが出ない時はGitHubの「Applications」設定を見直す
• 権限があっても出ない時は、リポジトリのURLを直接Claudeにペーストする
• devブランチを参照したい場合は、末尾が「/tree/dev」のURLを直接ペーストする
• 確実性を求めるタスクでは、手動コピペやファイルアップロードを併用する

便利なツールであることは間違いないので、ツールの癖と限界を理解した上で、上手に日々の開発業務へ組み込んでいきましょう。