メインコンテンツへスキップ
Dev Tools 19分で読める

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を無人の自動実行でも回している。人が画面を見ていない以上、承認ダイアログは安全装置にならない。だから優先度はこうなる。

  1. claude --version で2.1.316以降か確認し、古ければ claude update
  2. blockWritesOutsideWorkingDirectories を true にする。 必要な外部フォルダは additionalDirectories に明示する
  3. /sandbox でサンドボックスを有効にする。 Bash経由の書き込みはここで止める
  4. 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バックドア事件のように、エージェントの周辺は攻撃の的になりつつある。書き込める範囲は狭いに越したことはない。

30秒で伝える要点
  • v2.1.314で、ファイルツールの書き込みを作業フォルダ内に限定する設定が追加された(全権限モードで有効)
  • Bash経由の書き込みは対象外。サンドボックスとの併用が前提
  • Opus 4.8のfast modeは11月30日に削除。以降はエラーになるため、Opus 5.5への移行が必要
  • 設定を入れる前に、普段Claudeに作業フォルダ外を書かせていないか確認する

denyルールとサンドボックスの関係をもう一歩深く知りたいなら、Claude Codeのdenyが効かない?.envを守る権限設定を読む →

詳しく見る

関連記事


免責事項: 本記事は2026年11月3日時点の公開情報(Claude Code公式CHANGELOG、公式ドキュメント、GitHub Issue、DevelopersIO・DEV Communityの記事)に基づく。Claude Codeは頻繁に更新されるため、仕様や挙動は変わる場合がある。料金はAPIの公表値(税別・米ドル)で、変更される場合がある。記載した設定は一例であり、特定の環境での安全性を保証するものではない。筆者はこの設定の挙動を独自に検証しておらず、検証結果は引用元によるものである。セキュリティ上の判断は各自の責任で行い、最新の情報は公式ドキュメントで確認してほしい。Claude、Claude CodeはAnthropic PBCの商標または登録商標である。本記事は同社と関係のない個人による解説であり、同社の公式見解ではない。

Share