Claude Code は、--add-dir フラグと対話型コマンド /add-dir を使用して、単一セッションで複数のディレクトリにわたって作業できるようになりました。これにより、プロジェクト間の絶え間ないコンテキスト切り替えが不要になります。
マルチディレクトリサポートとは
コア機能
--add-dir /path/to/dir フラグは、作業ディレクトリを変更せずに、ディレクトリを Claude Code セッションに追加します。対話型セッション中に /add-dir <path> を使用すると、ワークスペースを動的に拡張できます。
Claude Code は、パフォーマンスを維持しながら、異なるディレクトリ構造にわたるファイルの関係性を維持します。追加されたディレクトリからファイルを参照すると、システムはパス解決を自動的に処理します。
主なユースケース
モノレポ
セッションを切り替えることなく、フロントエンド、バックエンド、共有モジュール間で作業できます。論理的に分離された大規模なアプリケーションは、すべてのコンポーネントへの統合されたアクセスから恩恵を受けます。
共有設定ファイル
別の場所に保存されている設定ファイル、ドキュメント、開発成果物にアクセスします。個人の生産性ファイルやチームドキュメントは、セッション間で常に利用可能になります。
クロスプロジェクト開発
相互接続されたリポジトリを同時に管理します。API クライアントはサーバーの実装と同期を保ちます。ドキュメントはコード変更と並行して更新されます。
実装戦略
ワークスペース設定
- 主要な作業ディレクトリを特定する
--add-dirを使用して関連ディレクトリを追加する- 一般的な設定のためにシェルエイリアスを作成する
- チーム全体でディレクトリパターンを確立する
パフォーマンス最適化
- 積極的に使用するディレクトリのみを追加する
- ビルド成果物のあるディレクトリは避ける
- 大規模な設定でのコンテキストトークン使用量を監視する
- 信頼性の高いアクセスのために絶対パスを使用する
開発統合
マルチディレクトリサポートは、既存の Git ワークフロー、CI システム、デプロイメントパイプラインと連携します。Apidog のような API 開発ツールは、複数のプロジェクトディレクトリにわたる仕様を監視できます。
実用的な例
マイクロサービスアーキテクチャ
サービス実装、共有ライブラリ、設定テンプレート、デプロイスクリプトに単一セッションでアクセスします。新しいサービスを開発しながら、既存のパターンを参照します。
オープンソースへの貢献
フォークされたリポジトリ、アップストリームソース、個人設定を同時に扱います。関連するすべてのコードベースにアクセスしながら、クリーンな貢献を維持します。
Infrastructure as Code
複数のリポジトリにわたるアプリケーション定義、デプロイ設定、監視設定を管理します。インフラストラクチャの変更中に一貫性を維持します。
ベストプラクティス
構成管理
解決の問題を避けるために絶対パスを使用します。すべてのディレクトリの読み取り権限を確認します。チームの一貫性のために標準化された設定を作成します。
セキュリティ上の考慮事項
ディレクトリを追加する前に内容を確認します。機密情報や本番環境の認証情報を除外します。専用の開発ディレクトリを使用します。
パフォーマンス監視
広範なディレクトリ構造を持つ場合のメモリ使用量を監視します。ローカルディレクトリはネットワークマウントされたディレクトリよりも優れたパフォーマンスを提供します。セッションから未使用のディレクトリを削除します。
高度な機能
コマンドライン統合
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
対話型コマンド
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
チームワークフロー
チーム全体でマルチディレクトリ設定を標準化します。一貫した開発者エクスペリエンスのために共通パターンを文書化します。オンボーディングプロセスと統合します。
API 開発ワークフロー
マルチディレクトリサポートは、API ファースト開発を強化します。バックエンドサービス、ドキュメント、クライアント SDK、テストスイートは、しばしば別々のリポジトリに存在しますが、同期された更新が必要です。
Apidog は、マルチディレクトリワークスペース全体で機能する統合テストインターフェースを提供します。これにより、複数のプロジェクトにまたがる機能を開発する際に、API の一貫性が保証されます。
一般的な問題のトラブルシューティング
パス解決の問題
- 相対パスではなく絶対パスを使用する
- シンボリックリンクが正しく機能することを確認する
- ディレクトリのアクセス許可を確認する
パフォーマンスの問題
- 追加するディレクトリを必要なものに限定する
- システムリソースを監視する
- 長時間のセッション中は未使用のディレクトリを削除する
アクセス制御
- 適切な読み取り権限を確保する
- 機密データを含むディレクトリの追加を避ける
- 開発専用のディレクトリ構造を使用する
将来の機能強化
コミュニティは、永続的なワークスペース設定のための設定ファイルを要求しています。これにより、チーム全体での標準化が可能になり、繰り返し発生するセットアップタスクが削減されます。
開発プラットフォームとの統合機会は拡大し続けています。API 開発ツール、プロジェクト管理システム、コラボレーションプラットフォームは、強化されたワークスペース機能を活用できます。
結論
Claude Code のマルチディレクトリサポートは、現代の開発におけるワークフローの摩擦を解消します。モノレポ、マイクロサービス、クロスプロジェクトコラボレーションは、コンテキスト切り替えのオーバーヘッドなしでシームレスになります。
シンプルな2ディレクトリ構成から始め、プロジェクトのニーズに基づいて拡張してください。最小限の学習曲線で、プロジェクトの複雑さが増すにつれて大幅な生産性向上が実現します。
Apidog のような包括的な API テストツールと組み合わせることで、マルチディレクトリサポートは、合理化されたエンドツーエンドの開発エクスペリエンスを生み出します。最大の利益を得るために、特定のプロジェクト要件に合った構成を試してみてください。