4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code の `/add-dir` 機能について

4
Posted at

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変更時に両方を同時編集・テスト

注意点・ベストプラクティス

  1. 相対パスの基準: 起動時のカレントディレクトリからの相対パス
  2. パス解決: Claude Code が自動的に複数ディレクトリ間のパス関係を管理
  3. パフォーマンス: 複数ディレクトリも効率的に処理
  4. セキュリティ: サンドボックス内でのみアクセス可能

CLI引数との組み合わせ

# モデル選択と組み合わせ
claude --model claude-opus-4-20250805 --add-dir ../sdk

# プロンプト指定と組み合わせ
claude --add-dir ../backend -p "SDKの互換性を確認して"

関連機能: サンドボックス設定

さらにセキュアな環境を構築したい場合

/sandbox

このコマンドで、ファイルシステムとネットワークのアクセス制限をより細かく設定できます。


この機能は、AI開発で共有SDK・ライブラリを扱う際に非常に有効です。モノレポやマイクロサービス開発でも複数プロジェクトを同時作業できるため、生産性が大幅に向上します。

4
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
4
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?