ASADASHI
親フォルダに複数リポジトリを集めてClaudeを起動するミニチュア紙工作のジオラマ
時短ハック2026.05.24·読了 2·難易度: やさしい

Claudeを「親フォルダ起動」するだけでコンテキスト精度が上がる

親フォルダに複数リポジトリを集めてClaudeを起動するミニチュア紙工作のジオラマ

朝の出汁版(通勤2分)

  • ポイント1: 複数リポジトリを持つ開発者の間で、モノレポ化せずにローカルの親フォルダでClaudeを起動する運用が広がっている。
  • ポイント2: @id_1555300026347180032 が指摘するように、モノレポはAIのコンテキスト読み取りには有利だが、リリース管理や開発負荷の問題があり、「親フォルダにリポジトリを集めてClaudeを起動する」やり方が現実的な妥協点として注目されている。
  • ポイント3: 試したい人は、ローカルに1つ親フォルダを作り、関連するリポジトリをすべてその配下に置いた上でClaudeをその親フォルダから起動してみるとよい。

出汁の素(深読みモード)

これって結局どういうこと?

複数のリポジトリをAIに読ませたいとき、「モノレポにすればいい」という話はよく聞く。だが実際には、リリースタイミングが違うプロジェクトや、技術スタックが異なるコードベースを一つのリポジトリに押し込むと管理コストが跳ね上がる。そのトレードオフへの現実的な回答として、開発者の間で広がっているのが「ローカルの親フォルダにリポジトリを集めてClaudeを起動する」という運用だ。要は、モノレポの構造を実際には作らず、ローカルのフォルダ配置だけでAIに「横断的なコンテキスト」を与えるという発想。GitHubのリモートには影響せず、既存の開発フローを変えずに試せる点が支持されている。

なぜこのタイミングで重要?

背景にあるのは、AIコーディングアシスタントがコンテキストウィンドウをどう使うかという構造的な問題だ。ClaudeのようなLLMは、起動時に参照できるファイルツリーの範囲がそのままコンテキストの射程になる。単一リポジトリから起動すれば、他のリポジトリの型定義・共通関数・設定ファイルは「見えていない」状態になる。これが原因で、AIが不完全な前提で補完・修正を提案してしまうケースが起きやすい。

一方でモノレポへの移行はコストが高い。CIの再設計、パッケージ管理の統一、チームへの周知と運用変更——どれも一朝一夕ではない。「親フォルダ起動」はその移行コストを払わずに、AIへのコンテキスト提供だけを最適化する。Gitの管理単位・CIの設定・デプロイフローはすべてそのままで、ローカルのフォルダ構造を変えるだけで済む。

Claudeがとくにこの恩恵を受けやすいのは、プロジェクト全体のファイル構造を踏まえた上で提案を組み立てる傾向が強いためだと見られている。AIを「使い分け」から「連携」へ。プロンプト設計の新常識でも触れているように、AIの出力品質はコンテキストの設計に大きく依存する。ツールの機能よりも「何を見せるか」の設計が効いてくる局面が増えている。

具体的に始めるなら

やり方はシンプルで、ステップは三つ。

① ローカルに親フォルダを作る まず任意の場所に workspaceprojects といった名前のフォルダを作る。既存のリポジトリをその配下に移動(またはシンボリックリンクで参照)する。Gitの管理対象は各リポジトリ単位のまま変わらないため、git remote.gitignore に手を加える必要はない。

② 関連するリポジトリをすべてその配下に置く フロントエンド・バックエンド・共通ライブラリなど、横断的に参照させたいリポジトリをまとめる。全部を入れる必要はなく、「今取り組んでいる機能に関係するもの」だけに絞っても効果がある。フォルダが重くなると読み込みに時間がかかるため、不要なリポジトリは入れないほうが実用的だ。

③ 親フォルダからClaudeを起動する Claude for Desktopを使う場合は、親フォルダをプロジェクトのルートとして開く。VSCode拡張やCursorを使う場合は File > Open Folder でその親フォルダを指定する。これだけで、Claudeが参照できるファイルツリーが複数リポジトリにまたがった状態になる。

発展の提案

  • 「APIとフロントエンドの型定義を合わせたい」「共通コンポーネントの使われ方を横断して把握させたい」といったタスクで効果を確認しやすい
  • CLAUDE.md(Claudeへの指示ファイル)を親フォルダのルートに置くと、複数リポジトリにまたがるルールやコンテキストをまとめて渡せる
  • LLMの出力をHTML化してブラウザで見る技と組み合わせると、Claudeが生成した横断レポートをそのままブラウザで確認するフローが作れる

よくある疑問

Q. Gitの管理に影響は出ないか? A. 各リポジトリの .git フォルダは独立して存在し続けるため、コミット・プッシュ・ブランチ操作はすべて従来どおりに動く。親フォルダ自体をGit管理する必要はない(むしろしないほうがよい)。リモートリポジトリの構成にも影響はない。

Q. Claude以外のAIコーディングアシスタントでも同じ手法は使えるか? A. Cursor、Windsurf、GitHub Copilot(VSCode拡張)などでも、フォルダをワークスペースのルートとして開く概念は共通しているため、同様の効果が期待できる。ただし、各ツールがファイルツリーをどの深さまでインデックスするかは実装による。Claudeが特にこの手法と相性がよいとされているのは、ファイル構造を積極的に参照するアーキテクチャに起因すると見られている。

Q. リポジトリ数が増えると動作が重くなるか? A. フォルダ配下のファイル総数が多くなるほど、インデックスや初回の読み込みに時間がかかる可能性がある。実用上は「今のタスクに関係するリポジトリだけを親フォルダに入れる」という運用が現実的だ。常時使うリポジトリセットを絞り込んでおくことで、速度と精度のバランスを取りやすくなる。

もう一歩踏み込みたい人へ

この手法をさらに発展させるなら、CLAUDE.md の活用が鍵になる。Claude for Desktopはプロジェクトルートに CLAUDE.md が存在するとその内容を自動的に参照する。親フォルダのルートにこのファイルを置き、「このワークスペースには以下のリポジトリが含まれる」「A-repo はフロントエンド、B-repo はAPIサーバ、C-repo は共通型定義」といった構造情報を書いておくと、Claudeがファイルツリーを読む前提を正確に把握した状態で動作する。

さらに踏み込むなら、Claude APIとMCP(Model Context Protocol)を組み合わせる方向がある。MCPはClaudeが外部ツールやファイルシステムと連携するためのプロトコルで、公式リポジトリ(https://github.com/anthropics/anthropic-cookbook)にサンプル実装が公開されている。ローカルのファイルシステムをMCP経由で参照させる構成にすると、親フォルダ内のリポジトリ構造をプログラマティックにClaudeへ渡すパイプラインが作れる。

自動化の観点では、リポジトリ間の依存関係チェックやAPI仕様の整合性確認を定期的にClaudeに実行させるスクリプトへの応用も視野に入る。これらはまだ実験的な領域だが、親フォルダ起動という基本構造を押さえておくことが、そのどれに対してもベースラインになる。

元になったツイート

  • モノレポのほうがAIがコンテキストを読みやすいはそうなんだけど、リリースタイミングとか基盤の違うものを混ざるな危険だし、開発者としても重くて開発しづらい。 ローカルで1個親フォルダ作ってそこに全てのリポジトリを追加して、その親フォルダでClaude起動してあげると良き

  • 布団から出たくないからiPhoneでぽちぽちclaude対話やってるのに、xcodeへの移動圧が強い。 磯野野球しようぜ気質があるclaude兄貴

  • 自分の人生に起きた「不幸」と「幸運」を箇条書きにして並べてバランスが取れているか?ってchatGPTに質問したら結論がこれ。救いがなくて泣いた。 https://t.co/1Rg2ZoQa4h

参照ソース