Skip to content
← リリースに戻る · 2.1.257
新機能 / v2.1.257

作業ディレクトリ外の読み取り確認

CHANGELOG 原文(英語)

Added a one-time prompt in auto mode before the first file read outside the working directories, with the option to block such reads (permissions.blockReadsOutsideWorkingDirectories)
公式の変更履歴を開く ↗

日本語での補足

自動モードで初回のディレクトリ外読み取り前に一度だけ確認。permissions.blockReadsOutsideWorkingDirectoriesでブロック可能

ドキュメント

ドキュメントの抜粋(参考訳)

permissions.blockReadsOutsideWorkingDirectories

Claude のファイルツールに、bypassPermissions を含むすべての権限モードで、作業ディレクトリ外の読み取りを拒否させます。Claude Code はそれらのパスに対する Read、Grep、Glob、LSP の呼び出しを拒否し、/add-dir でディレクトリを追加するようユーザーに尋ねるよう Claude に伝えます。スキル、プラグイン、ルール、エージェント、コマンド、~/.claude/ 配下のメモリーファイル CLAUDE.md など、Claude Code 自体が必要とするファイルは引き続き読み取れます。Claude Code v2.1.257 以降が必要です。

Claude Code は、シェルコマンドについては同じようには拒否しません。

シェルパーサーが追跡できない Bash コマンド、たとえばディレクトリを 2 回以上移動するコマンドやサブシェルを実行するコマンドは、自動モードや bypassPermissions モードでも確認が表示されます。コマンドが作業ディレクトリ外のパスを指定していない場合でも、この確認は表示されます。コマンドがサンドボックス内で実行され、サンドボックスがこの禁止を強制する場合、この確認は表示されません。

自動モードで作業ディレクトリ外を初めて読み取る前の確認で、このような読み取りを禁止することを選んだ場合も、Claude Code はこの設定に true を書き込みます。

  • 適用範囲:すべての設定ファイル(Any file)。いずれかの設定ファイルで true が指定されていれば適用されます。リポジトリはこの禁止を自身に対してオンにできますが、ユーザーの設定を解除することはできません。
  • 型:真偽値
    • true:Claude のファイルツールが作業ディレクトリ外の読み取りを拒否します
    • false:未設定と同じです。他の設定ファイルに true があれば、引き続き禁止が適用されます
  • 既定値:未設定。作業ディレクトリ外の読み取りは、権限モードに従います
{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

この禁止を解除するには、それを設定しているすべての設定ファイルからそのキーを削除し、実行中の各セッションを再起動してください。

--add-dir、/add-dir、またはユーザー設定や管理設定の additionalDirectories で追加したディレクトリは、この禁止における作業ディレクトリとして扱われます。リポジトリ設定だけで追加したディレクトリは対象になりません。具体的には、.claude/settings.json にあるディレクトリや、.claude/settings.local.json にあるディレクトリ(そのファイルを git が未追跡として報告している場合を除く)です。git リポジトリでないディレクトリでは、またはそのファイルを git が追跡している場合、Claude Code は .claude/settings.local.json をリポジトリ設定として扱うため、読み取り可能な状態を保ちたいディレクトリは、代わりにユーザー設定に追加してください。

autoMemoryDirectory がプロジェクトの .claude/settings.json、またはリポジトリ提供として扱われる .claude/settings.local.json から設定されている場合、Claude Code はそのディレクトリから自動メモリーを読み込まず、保存もしません。

この禁止下でのサンドボックス化されたコマンド

サンドボックスが有効な場合、この禁止はサンドボックス化されたコマンドにも適用されます。Claude Code は、ホームディレクトリと、ユーザーファイルを保持するその他のルート(/Users、/home、/root、/Volumes、/mnt、/media、/run/media、/srv)への読み取りアクセスを拒否します。その上で、作業ディレクトリ、セッション内で Claude Code が作成するworktree、セッションの一時ディレクトリ、およびスキルやプラグインなど、コマンドに必要な ~/.claude の一部を、再び読み取り可能にします。この禁止が有効な間、リポジトリ設定の allowRead や allowWrite のエントリはカウントされません。

セッションの作業ディレクトリがリンクされた git worktree である場合、セッション途中で Claude Code がその worktree に移動した場合も含め、リポジトリ共通の .git ディレクトリは、サンドボックス内のコマンドから引き続き読み書きできます。そのため、その worktree でも git を利用できます。

次の場合、この禁止はサンドボックス化されたコマンドには及びませんが、Claude のファイルツールは引き続き適用します。

  • sandbox.filesystem.disabled によってファイルシステムの分離がオフになっている場合
  • allowManagedReadPathsOnly が設定されている場合
  • Claude Code を起動したディレクトリのパスに、*、?、[ などの glob 文字が含まれている場合

この禁止下でも、Claude Code はグローバルな git 設定ファイルをサンドボックス化されたコマンドに対して再び読み取り可能にし、git が本人の識別情報や設定を保持できるようにします。対象は次のとおりです。

  • ~/.gitconfig
  • $XDG_CONFIG_HOME/git(既定では ~/.config/git)配下の config、ignore、attributes の各ファイル
  • グローバルな git 設定が [include]、[includeIf]、core.excludesFile、core.attributesFile で指定するファイル

Claude Code はファイルごとに個別に判断します。サンドボックス化されたコマンドが直接またはシンボリックリンク経由で書き込める場所にファイルがある場合、Claude Code はそのファイルが指すファイルを再び開くことはありません。

Linux と WSL2 では、シンボリックリンクである設定ファイルは、そのパス自体では読み取り不能なままになることがあり、その場合 git はそのファイルなしで実行されます。~/.git-credentials と $XDG_CONFIG_HOME/git/credentials は引き続きブロックされます。

再び開かれたファイルに、http.extraHeader トークンなどのシークレットが含まれている場合は、そのパスを sandbox.filesystem.denyRead に追加してください。あるファイルを対象とする denyRead のエントリは、常にこの再オープンより優先されます。

取得日 · 2026-11-20

ドキュメントの抜粋(参考訳)

作業ディレクトリ外の初回読み取り

permissions.blockReadsOutsideWorkingDirectoriesが無効な場合、自動モードではネットワークパスからの読み取りを除き、作業ディレクトリ外も含めたファイルの読み取りを確認なしで実行します。ClaudeがRead、Grep、Globのいずれかのツールで作業ディレクトリ外のパスを初めて読み取ろうとすると、Claude Codeはその読み取りを許可するか確認します。

このプロンプトは、-p実行、Agent SDKセッション、バックグラウンドセッション、VS Codeのチャットパネル、デスクトップアプリには表示されません。これらの環境では、読み取りがそのまま実行されます。

どの回答を選んでも、Claudeは作業を続けます。

  • Yes, and keep allowing any reads outside the working directories:読み取りを実行します。以降の作業ディレクトリ外の読み取りも、これまでどおり実行されます。Claude Codeは回答を記録し、この確認を再び表示しません。
  • No, and block reads outside the working directories from now on:読み取りを拒否し、Claude Codeはユーザー設定のpermissions.blockReadsOutsideWorkingDirectoriesをtrueに設定します。これにより、ファイルツールは今回以降のすべてのセッションとすべての権限モードで、このような読み取りを拒否するようになります。この禁止を解除するには、それを設定している設定ファイルからその設定を削除し、実行中の各セッションを再起動してください。このセッションだけ1つのディレクトリを使えるようにするには、/add-dirを使用してください。
  • No, and ask again next time:読み取りを拒否し、次に作業ディレクトリ外を読み取ろうとしたときに再び確認します。
  • Yes, but ask again next time:読み取りを実行しますが、何も保存されません。次に作業ディレクトリ外を読み取ろうとしたときに再び確認します。

取得日 · 2026-11-20

変更の詳細