settings.json

permissions.additionalDirectories

型string[]記述場所どの設定ファイルでも可

パーミッションのスコープに含める追加のディレクトリを指定します。

記述例

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

使い方・用途

  • プロジェクトルート外にあるライブラリ、ドキュメント、または別リポジトリのコードを Claude に参照・編集させたい場合に設定します。
  • /add-dir コマンドで動的に追加した権限を、セッション再起動後も永続的に維持したい場合に役立ちます。
英語原文(公式ドキュメントより)

Additional directories to include in the permission scope

関連ドキュメント

関連する変更履歴

v2.1.257(1件)

Changed
--add-dir、/add-dir、additionalDirectories が、ネットワークパス（UNC 共有、/net/<host> のオートマウント）に触れる前にメッセージとともに拒否するように変更した。Windows ではマップ済みドライブレターを使用する
英語原文を表示
Changed --add-dir, /add-dir, and additionalDirectories to refuse network paths (UNC shares, /net/<host> automounts) with a message before touching them; on Windows use a mapped drive letter

変更後

ネットワークパスが作業ディレクトリに登録される前に拒否されるため、パスの参照によってホストへの意図しない接続や Windows での資格情報の送信を避けられる。

関連ドキュメント

v2.1.251(1件)

Fixed
ヌルバイトを含む additionalDirectories のエントリで起動時にクラッシュしたり、SDK ホスト・IDE・フック由来の場合に /add-dir やその後の設定更新が壊れる問題を修正した。該当エントリはスキップされるようになった
英語原文を表示
Fixed an additionalDirectories entry containing a null byte crashing startup, or breaking /add-dir and later settings updates when it came from an SDK host, IDE, or hook; it is now skipped

関連ドキュメント

v2.1.133(1件)

Fixed
ネットワークドライブ上のディレクトリを --add-dir で追加した際に、ファイル操作が拒否される問題を修正しました
英語原文を表示
Fixed Read/Write/Edit being denied on mapped network drives passed via --add-dir / SDK additionalDirectories

変更後

共有サーバーや外部ストレージ上にプロジェクト資産がある場合でも、Claude Code を制限なく利用できるようになります。

関連ドキュメント

v2.1.98(2件)

Fixed
セッション中に permissions.additionalDirectories を変更した場合、再起動なしで即座に反映されるよう修正しました。削除されたディレクトリは即座にアクセス権を失い、追加されたものはすぐに機能します。
英語原文を表示
Fixed permissions.additionalDirectories changes not applying mid-session — removed directories lose access immediately and added ones work without restart

変更後

作業対象を動的に広げたいときに、会話の流れを止めることなく設定変更を即座に反映させられます。

関連ドキュメント

Fixed
additionalDirectories からディレクトリを削除すると、同じディレクトリを --add-dir フラグで渡していてもアクセス権が取り消されてしまう問題を修正しました。
英語原文を表示
Fixed removing a directory from additionalDirectories revoking access to the same directory passed via --add-dir

変更後

設定変更時の意図しない権限喪失を防ぎ、確実なディレクトリ管理が可能になります。

関連ドキュメント

v2.1.97(2件)

Fixed
設定ファイルのpermissions.additionalDirectoriesを変更しても、セッションの途中で反映されない問題を修正しました。
英語原文を表示
Fixed permissions.additionalDirectories changes in settings not applying mid-session

変更後

作業の途中で別のディレクトリの参照が必要になった際、思考プロセスを中断してツールを再起動する手間が省けます。

関連ドキュメント

Fixed
settings.permissions.additionalDirectoriesからディレクトリを削除すると、--add-dirで渡された同じディレクトリへのアクセス権まで取り消されてしまう問題を修正しました。
英語原文を表示
Fixed removing a directory from settings.permissions.additionalDirectories revoking access to the same directory passed via --add-dir

変更後

プロジェクト固有の設定とグローバルな設定を併用している環境において、パーミッション管理の挙動が予測可能になり、混乱を避けられます。

関連ドキュメント

v1.0.82(1件)

Changed
SDK: New additionalDirectories option to search custom paths, improved slash command processing

関連ドキュメント