11/3 の公式ドキュメント更新：作業ディレクトリ外への書き込みブロックとコスト指標の扱い

Posted at 2026-11-05

2026-11-03 に追加された文は、permissions.blockWritesOutsideWorkingDirectories（作業ディレクトリ外への書き込みをブロックする設定）の説明が複数ページに入ったことが中心です。設定、worktree、権限モード、サンドボックスの各ページがこの設定を別々の角度から扱っています。あわせて、パス限定ルールの glob 展開の説明と、コスト指標を請求根拠にしない旨の注意書きも追加されました。対象は 11 ページです。

書き込みブロックは管理設定の false で打ち消せない

設定ページに、permissions.blockWritesOutsideWorkingDirectories の行が追加されました。Claude Code v2.1.257 以降が必要と記載されています（2026-11-03 時点）。値の欄には「どのスコープからでも true」とあり、備考には managed な設定元が false を指定していても有効になると書かれています。

true from any scope Honored even when a managed source sets false

（出典 [1]）

（訳：どのスコープからでも true であれば有効で、managed なソースが false を設定していても尊重されます。）

このキーは、管理側の false では打ち消せないことになります。個人や repository 側で true にすれば、組織の既定値に関係なく効く設計です。

同じページには、blockReadsOutsideWorkingDirectories（読み取り側のキー）についての記載もあります。セッション途中でこのキーを削除しても、実行中のセッションではファイルツールがブロックを保持するとのことです。続けて、設定しているすべての設定ファイルからキーを削除し、実行中の各セッションを再起動するという解除手順が書かれています。この手順が書き込み側のキーにも当てはまるかは、追加文からは読み取れません。ドキュメントには、読み取り側の文脈に続けて記載されているとだけ確認できます。

ブロックを有効にすると worktree ツールが使えなくなる場合がある

worktree のページでは、この設定の副作用が説明されています。Claude に worktree での作業を頼んでも EnterWorktree や ExitWorktree ツールが見当たらない場合は、まずこのキーが有効かどうかを確認するよう案内されています。

Once the key is on, Claude Code removes both worktree tools or refuses calls to them.

（出典 [2]）

（訳：キーが有効になると、Claude Code は両方の worktree ツールを取り除くか、その呼び出しを拒否します。）

worktree は通常、作業ディレクトリの外に作られます。そのため、ブロックと worktree ツールが両立しないのは自然な帰結です。同じページには、キーが有効でも worktree での作業は続けられるとあり、対話セッションでは claude --worktree でセッションを worktree 内から開始する方法が挙げられています。その他の利用形態の詳細は、今回の追加文には含まれていません。

制限が及ぶのは Write、Edit、NotebookEdit だけ

権限モードのページでは、ブロックの範囲が具体的に書かれています。作業ディレクトリ外では、Write、Edit、NotebookEdit の呼び出しが拒否されます。ただし Claude Code 自身のファイルの一部は例外です。どのファイルが例外なのかは、追加文からは分かりません。

The key doesn't limit shell commands, MCP tools, or the programs hooks run, so use sandboxing to limit where shell commands write.

（出典 [3]）

（訳：このキーはシェルコマンド、MCP ツール、フックが実行するプログラムを制限しません。シェルコマンドの書き込み先を制限するにはサンドボックスを使ってください。）

Bash 経由の書き込みや MCP ツール、フックのプログラムはこのキーでは止まりません。これらを制限するには、サンドボックスとの併用が前提になります。サンドボックスのページにも関連する追加文があり、macOS では network.allowMachLookup に列挙した Mach/XPC サービスにサンドボックス内のコマンドが到達でき、サービス側の動作はサンドボックスの制限対象外と明記されています。

同じページに「Requires Claude Code v2.1.314 or later.」という文も追加されています。どの項目に対する要件かは、追加文だけでは判別できません。

パス限定ルールの対象と glob の展開

memory のページでは、.claude/rules のパス限定ルールの説明が補強されました。ルールが読み込まれる条件は、一致するファイルに対して Claude が Read、Write、Edit のいずれかのツールを使ったときです。

追加された内容は次の 3 点です。

シンボリックリンク経由でプロジェクトディレクトリ内のファイルに到達した場合も、マッチングが働く
兄弟関係にある git worktree のファイルにルールを効かせるには、その worktree で Claude Code を起動するか、/cd でセッションを移す
ブレース展開では、ブレースのグループごとにパターン数が掛け算で増える

Each brace group multiplies the number of expanded patterns

（出典 [4]）

（訳：ブレースのグループごとに、展開後のパターン数が掛け算で増えます。）

ドキュメントの例では、src/.{ts,tsx} は 2 パターン、{a,b}/{c,d}/.{ts,tsx} は 8 パターンに展開されます。広い範囲を 1 行で指定できる反面、グループを重ねるとパターン数が急に増えます。上限の有無は追加文には書かれていません。

コスト指標は概算で、請求の根拠にしない

monitoring-usage と Agent SDK の cost-tracking の 2 ページに、公式の請求データは「Manage costs for your organization」を見るよう案内する文が追加されました。monitoring-usage では、コスト指標が概算であることも明記されています。

Don't bill end users or trigger financial decisions from these fields.

（出典 [8]）

（訳：これらのフィールドを使って、エンドユーザーへの請求や金銭に関わる判断を行わないでください。）

これは Agent SDK 側の注意書きです。SDK が返すコスト関連フィールドを、顧客への課金や上限制御の根拠に使っている実装は見直しが必要になります。monitoring-usage には、ストリーミング応答がコスト・トークン指標に 1 回だけ数えられるという文も追加されました。対象には、ANTHROPIC_BASE_URL の先のゲートウェイやプロキシが使用量を複数フレームに分けて流す場合も含まれます。skill.name、plugin.name、agent.name 属性で支出を帰属できるという説明も加わっています。

その他の更新

hooks: prompt 型フックが入力とプロンプトを送るモデルは、既定では背景機能に使われるモデルであると明記
sub-agents: v2.1.314 以降で /btw が開いているトランスクリプトから回答する旨を追記
env-vars: CLAUDE_CODE_DISABLE_CFC_PROMPT を追記。Chrome 用ブラウザツールを残したまま、システムプロンプトの Chrome 節とバンドルスキルを省く
cli-reference: v2.1.265 より前は、システムプロンプト系フラグで記録も無効になったという履歴を追記

まとめ

この日の更新で運用が変わるのは、主に管理者とセキュリティ担当者です。作業ディレクトリ外への書き込みを制限したい場合、blockWritesOutsideWorkingDirectories は管理設定の false で無効化されません。一方で制限の範囲は組み込みの編集ツールに限られ、シェルや MCP、フックはサンドボックスで別に扱う必要があります。また、このキーを有効にした環境で worktree 機能が使えなくなる可能性があります。コスト情報を集計・課金に使う開発者は、指標を概算として扱い、請求根拠には公式の請求データを使う前提で設計する必要があります。いずれも 2026-11-03 時点のドキュメント記載に基づく内容で、挙動の詳細は各ページの原文で確認してください。

出典

本稿の引用はすべて一次資料と逐語照合（verify_article 通過）のうえ掲載しています（2026-11-06 検証）。

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up