Claude Code v2.1.314の新設定|作業フォルダ外への書き込みを止める方法
- Claude Codeをbypassモードや自動実行(
claude -p)で使っている方 - クライアントの案件フォルダを複数抱えていて、「隣のフォルダを書き換えられたら終わり」と感じている方
- Opus 4.8のfast modeを使っていて、11月30日の廃止に備えたい方
「プロジェクト外のファイルにアクセスしたいと言われたので、断った。そうしたらClaudeはbashとPythonを使って ./local にファイルを作った。正直、どうかしている」
2026年2月、GitHubのIssue #25425に、ユーザーのjoeto-devがこう書いている(筆者訳・要約)。やりたかったのはリモートデスクトップ用に透明なカーソルを作るという小さな作業で、本人も「おかげで作業はずっと楽になった。でも、その経路を選んだことに驚いた」と認めている。助かったけれど怖い。Claude Codeを長く使っている人なら、この感覚に覚えがあるはずだ。
2026年10月30日に公開されたClaude Code v2.1.314で、この不安の半分に答える設定が入った。permissions.blockWritesOutsideWorkingDirectories である。
先に結論を書く。この設定は入れていい。ただし止まるのはファイルツールだけで、冒頭の事例のようなBash経由の書き込みは止まらない。 両方を塞ぐには、サンドボックスと組み合わせる必要がある。
- 作業ディレクトリ: Claude Codeを起動したフォルダと、
--add-dirなどで追加したフォルダ - Write / Edit / NotebookEdit: Claude Codeがファイルを作成・編集するときに使う組み込みツール
- bypassモード(bypassPermissions): 確認ダイアログを省略して、Claudeに作業を任せる権限モード
- サンドボックス: Claudeが実行するシェルコマンドを、OSの機能で「触れてよい範囲」に閉じ込める仕組み
v2.1.314で何が変わったか
公式のCHANGELOGの記述は1行だけだ。
Added
permissions.blockWritesOutsideWorkingDirectories: Write, Edit and NotebookEdit refuse paths outside the working directories in every permission mode
要点は「every permission mode」の部分にある。これまでも、通常モードなら作業フォルダの外を編集するときに確認が出た。しかしbypassモードでは確認そのものが出ない。今回の設定は、確認を出すかどうかとは関係なく、書き込み自体を拒否する。
ベルリンのクリエイティブスタジオRAXXO StudiosはDEV Communityの記事で、この違いを短く言い表している。権限モードは「承認の境界」であって「書き込みの境界」ではなかった。「この2つは別の約束だ」。PMとしてこの一文はわかりやすかった。承認フローと権限設計は、業務システムでも分けて考えるものだからだ。
設定方法
~/.claude/settings.json(全プロジェクト共通)か、プロジェクトの .claude/settings.json に書く。
{
"permissions": {
"blockWritesOutsideWorkingDirectories": true
}
}
作業ディレクトリとして扱われるのは、起動したフォルダ、起動時の --add-dir、セッション中の /add-dir、設定ファイルの permissions.additionalDirectories だ。共通ライブラリなど作業フォルダの外を編集したい場合は、/add-dir で明示的に追加する。
実際に止まるのか
クラスメソッドの石川覚氏が、DevelopersIOで検証結果を公開している(2026年10月30日)。claude -p をbypassモードで起動し、隣のフォルダへのWriteを指示したところ、設定ありでは permission_denied になってファイルは作られなかった。設定なしでは普通に書き込めている。拒否メッセージには「/add-dir で追加するか、設定を外すように」と案内が出たという。石川氏の感想は「かなり安心できる」だ。
ただ、この検証は1ターン限定の短いもので、Writeツールしか試していない。EditとNotebookEditは未確認だと記事に明記されている。
Bashからの書き込みは止まらない
ここがいちばん大事な点だ。CHANGELOGが名指ししているのはWrite・Edit・NotebookEditの3つで、Bashは入っていない。前出のRAXXO Studiosの記事もBashには触れていない。
冒頭のIssue #25425は、まさにBashとPythonでファイルを作った事例だった。2025年8月のIssue #5773では、Windowsユーザーのseocorpが「作業フォルダは D:\github\claude-only なのに、Editツールで AppData\Local 配下のスクリプトを書き換えられた」と報告している。後者のようなファイルツール経由のケースは今回の設定で止まる。前者のようなシェル経由のケースは止まらない。
Bashの書き込みまで囲むなら、サンドボックスを使う。公式ドキュメントによると、サンドボックス内のコマンドが書き込めるのは作業ディレクトリ、ユーザーごとの一時フォルダ、追加したディレクトリだけで、子プロセスも含めてOSレベルで制限される。逆に、サンドボックスはReadやEditなどのファイルツールには効かない。つまり2つは守備範囲が違い、互いの穴を埋める関係にある。
| 書き込みの経路 | blockWritesOutside… | サンドボックス |
|---|---|---|
| Write / Edit / NotebookEdit | 止まる | 対象外 |
Bash(echo > ~/x など) | 止まらない | 止まる |
| Bashから起動したPython・Node | 止まらない | 止まる |
| MCPサーバー・フック | 止まらない | 対象外 |
サンドボックスはmacOS、Linux、WSL2で動き、ネイティブのWindowsでは使えない(公式ドキュメント、2026年11月時点)。MCPサーバーとフックはどちらでも囲めないので、そこはコンテナやVMで丸ごと隔離するしかない。
有効にして困るケース
abhayla/claude-best-practicesのIssue #635(11月1日)は、この設定をチーム共通のsettings.jsonに入れる提案だ。同時に「正当な作業フォルダ外への書き込み、特にスクラッチパッド(作業用の一時メモ領域)が壊れないか、ローカルで確認が必要」と懸念も書いている。
自分の環境でも、たとえば ~/.claude/ 配下のメモや、別リポジトリにある共通ドキュメントをClaudeに更新させている人は、設定を入れた瞬間にそこが書けなくなる。入れる前に「普段Claudeにどこを書かせているか」を一度洗い出したほうがいい。
同じ週のv2.1.316で押さえる3点
10月31日ごろに出たv2.1.316のCHANGELOGには、50以上の変更が並ぶ。フリーランスが気にすべきものは3つに絞れる。
1. Opus 4.8のfast modeが11月30日に削除される。 10月30日付で非推奨になった。削除後は、fast modeでOpus 4.8を呼ぶとエラーが返り、通常速度のOpus 4.8には切り替わらない。高速化を続けたいならOpus 5.5へ移るよう案内されている。fast modeの公式ドキュメントによれば、fast modeの料金は100万トークンあたり入力/出力で、Opus 4.8が10ドル/50ドル、Opus 5.5が8ドル/40ドル(いずれもAPI料金、税別、2026年11月時点)。移行先のほうが2割安い計算になる。
2. CLAUDE_CODE_SUBAGENT_EFFORT が追加された。 サブエージェントの推論の深さ(effort)を、メインセッションから引き継がずに個別に決める環境変数だ。調べ物を任せるサブエージェントは軽く、本体はしっかり考えさせる、という配分がしやすくなる。effortの基本はv2.1.292実践ガイドにまとめてある。
3. CLAUDE_CODE_DISABLE_ULTRATHINK が追加された。 プロンプトに「ultrathink」と書くと最大級の思考が走る機能を、無効化できるようになった。VS Code版ではultrathinkが xhigh で動くよう変更されている。チームで使用量を管理している人には、うっかりを防ぐスイッチになる。
ほかに、--restricted セッションでRead許可ルールがあると作業フォルダ外のファイルをアップロードできた問題も直っている。
自分(電脳狐影)ならこう設定する
自分はこのブログの運用で、Claude Codeを無人の自動実行でも回している。人が画面を見ていない以上、承認ダイアログは安全装置にならない。だから優先度はこうなる。
claude --versionで2.1.316以降か確認し、古ければclaude updateblockWritesOutsideWorkingDirectoriesをtrueにする。 必要な外部フォルダはadditionalDirectoriesに明示する/sandboxでサンドボックスを有効にする。 Bash経由の書き込みはここで止める- fast modeでOpus 4.8を指定している設定やスクリプトを探し、11月30日より前にOpus 5.5へ書き換える
{
"permissions": {
"blockWritesOutsideWorkingDirectories": true,
"additionalDirectories": ["~/work/shared-docs"]
},
"sandbox": {
"enabled": true
}
}
additionalDirectories のパスは一例なので、自分の環境に合わせて書き換えてほしい。
正直に書くと、サンドボックスがbubblewrapやSeatbeltでどう隔離しているのか、PMの自分は技術的に説明しきれない。わかっているのは、「確認を出す仕組み」と「物理的に書けなくする仕組み」は別物で、今回Anthropicは後者を1枚増やした、ということだ。11月1日に報じられたCursor向けClaude Code拡張機能のSSHバックドア事件のように、エージェントの周辺は攻撃の的になりつつある。書き込める範囲は狭いに越したことはない。
- v2.1.314で、ファイルツールの書き込みを作業フォルダ内に限定する設定が追加された(全権限モードで有効)
- Bash経由の書き込みは対象外。サンドボックスとの併用が前提
- Opus 4.8のfast modeは11月30日に削除。以降はエラーになるため、Opus 5.5への移行が必要
- 設定を入れる前に、普段Claudeに作業フォルダ外を書かせていないか確認する
denyルールとサンドボックスの関係をもう一歩深く知りたいなら、Claude Codeのdenyが効かない?.envを守る権限設定を読む →
関連記事
- Claude Codeのdenyが効かない?.envを守る権限設定と10日で12版の修正
- Cursorの公式Claude Code拡張機能がSSHバックドアに汚染|5,000人の開発者への影響と完全対処法
- Claude Code v2.1.292 実践ガイド|プラグイン1コマンド導入とeffort制御の使い方
- Claude Fast Mode完全ガイド|2.5倍速・6倍コスト、使う場面はここだ
- Claude Code —restrictedモード解説:CI/CDリスクとAnthropicの回答
- Claude Codeアイドル圧縮の止め方|放置54分で要約されるidle compactionを無効化
免責事項: 本記事は2026年11月3日時点の公開情報(Claude Code公式CHANGELOG、公式ドキュメント、GitHub Issue、DevelopersIO・DEV Communityの記事)に基づく。Claude Codeは頻繁に更新されるため、仕様や挙動は変わる場合がある。料金はAPIの公表値(税別・米ドル)で、変更される場合がある。記載した設定は一例であり、特定の環境での安全性を保証するものではない。筆者はこの設定の挙動を独自に検証しておらず、検証結果は引用元によるものである。セキュリティ上の判断は各自の責任で行い、最新の情報は公式ドキュメントで確認してほしい。Claude、Claude CodeはAnthropic PBCの商標または登録商標である。本記事は同社と関係のない個人による解説であり、同社の公式見解ではない。