settings.json

additionalDirectories

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

使い方・用途

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

Additional directories to include in the permission scope

関連する変更履歴

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件)