settings.json

permissions.additionalDirectories

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

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

記述例

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

使い方・用途

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

Additional directories to include in the permission scope

関連する変更履歴

v2.1.257(1件)

Changed
ネットワークパス(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

変更前

以前は、--add-dir/add-dir、および additionalDirectories で指定されたディレクトリに対して、ネットワークパス(UNC共有や /net/<host> 自動マウント)も許可されていました。これにより、意図せずネットワーク上のリソースにアクセスしてしまう可能性がありました。

変更後

現在は、これらのオプションでネットワークパスを指定しようとすると、操作を行う前にメッセージを表示して拒否するようになりました。Windows環境では、マップされたドライブレターを使用する必要があります。

ユーザーへの恩恵

意図しないネットワークパスへのアクセスを防ぎ、セキュリティを強化します。

v2.1.251(1件)

Fixed
SDK ホスト、IDE、またはフックから来る additionalDirectories エントリに null バイトが含まれている場合、起動時にクラッシュしたり、/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

変更前

SDK ホスト、IDE、またはフックから来る additionalDirectories エントリに null バイトが含まれている場合、Claude Code が起動時にクラッシュしたり、/add-dir や後続の設定更新が破損したりしていました。

変更後

SDK ホスト、IDE、またはフックから来る additionalDirectories エントリに null バイトが含まれている場合、Claude Code はエントリをスキップするようになり、起動時のクラッシュや設定更新の破損が発生しなくなりました。

ユーザーへの恩恵

無効なエントリが含まれていても Claude Code が正常に起動し続け、設定の更新が確実に行われるようになります。

関連ドキュメント

v2.1.133(1件)

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

変更前

追加ディレクトリとして指定したパスがネットワーク上のマップされたドライブにある場合、Read/Write/Edit 権限が正しく認識されずアクセス拒否される場合がありました。

変更後

ネットワークドライブ上のパスに対する権限判定が改善され、ローカルドライブと同様にシームレスなファイル操作が可能になりました。

ユーザーへの恩恵

共有サーバーや外部ストレージ上にプロジェクト資産がある場合でも、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

変更前

設定ファイルを変更しても、実行中のセッションには反映されず、一度 Claude Code を終了して立ち上げ直す必要がありました。

変更後

ディレクトリ権限の変更がライブで適用されるようになり、柔軟な権限管理が可能になりました。

ユーザーへの恩恵

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

関連ドキュメント

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

変更前

対話中に/configなどでアクセス許可ディレクトリを追加しても、一度セッションを再起動するまでClaudeがそのディレクトリ内のファイルを認識できないことがありました。

変更後

セッションを維持したまま、新しいディレクトリへのアクセス権限を即座に適用できるようになりました。

ユーザーへの恩恵

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

関連ドキュメント

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

関連ドキュメント