Claude Code の /add-dir 機能は、複数のディレクトリを同時に作業対象として扱える機能です。
こちらにて投稿があった内容を詳しく調査したメモです。
基本的な動作
通常、Claude Code は起動したディレクトリ(カレントディレクトリ)のみをサンドボックスで操作できます。しかし /add-dir を使うことで、シンボリックリンク不要で複数ディレクトリを同時アクセス可能になります。
プロジェクト構造:
/projects
├── current-app/ ← Claude Code起動位置
│ ├── src/
│ └── package.json
└── sdk/ ← 別ディレクトリの共有SDK
├── lib/
└── package.json
使用方法
1. CLI起動時に指定(起動時追加)
claude --add-dir ../sdk
claude --add-dir ../backend --add-dir ../shared-utils # 複数指定可
2. セッション中に追加(スラッシュコマンド)
/add-dir ../sdk
または相対パス・絶対パスで:
/add-dir ~/company/shared-libraries
/add-dir /path/to/external/project
重要な機能特性
| 項目 | 詳細 |
|---|---|
| シンボリックリンク不要 | 実際のディレクトリを直接アクセス |
| セッション切り替え不要 | 1つのセッションで複数ディレクトリ操作 |
| 設定の永続化 | 「設定として保存」を選択すると /.claude/settings.local.json に記録 |
| 動的な拡張 | セッション中に必要に応じて追加可能 |
| 複数ディレクトリ | 同時に複数のディレクトリをサポート |
設定の保存方法
セッション中に /add-dir コマンドを実行すると選択肢が表示されます。
○ 現在のセッションのみ有効にする
○ 設定として保存する
「設定として保存」を選択すると、以下のファイルに記録されます。
// ~/.claude/settings.local.json
{
"additionalDirectories": [
"/Users/username/projects/sdk/",
"/Users/username/projects/shared-libs/"
]
}
次回以降、同じプロジェクトで Claude Code を起動するとこれらのディレクトリが自動的に追加されます。
実践的なユースケース
# フロントエンドアプリのディレクトリで起動
cd ~/projects/web-app
claude --add-dir ../sdk
# セッション中に参照資料も追加
/add-dir ../project-docs
/add-dir ../config
# これで以下が可能に。
# - src/components/Main.tsx から ../sdk/utils/helper.ts をインポート
# - package.json で ../sdk の依存関係を解決
# - SDK変更時に両方を同時編集・テスト
注意点・ベストプラクティス
- 相対パスの基準: 起動時のカレントディレクトリからの相対パス
- パス解決: Claude Code が自動的に複数ディレクトリ間のパス関係を管理
- パフォーマンス: 複数ディレクトリも効率的に処理
- セキュリティ: サンドボックス内でのみアクセス可能
CLI引数との組み合わせ
# モデル選択と組み合わせ
claude --model claude-opus-4-20250805 --add-dir ../sdk
# プロンプト指定と組み合わせ
claude --add-dir ../backend -p "SDKの互換性を確認して"
関連機能: サンドボックス設定
さらにセキュアな環境を構築したい場合
/sandbox
このコマンドで、ファイルシステムとネットワークのアクセス制限をより細かく設定できます。
この機能は、AI開発で共有SDK・ライブラリを扱う際に非常に有効です。モノレポやマイクロサービス開発でも複数プロジェクトを同時作業できるため、生産性が大幅に向上します。