claude -p でバッチを動かしているシステムをいくつか持っている。毎日自動で動いて、朝までに処理が終わっている構成だ。今日のリリースノートに目が止まったのは、そのせいだと思う。
Changed fork subagents ( subagent_type: "fork" ) to be on by default in claude -p
設定を変えていないのに、動作が変わる可能性がある変更だ。
v2.1.302 は 2026年10月17日のリリース。変更点は 35 項目以上。全部を業務で使うわけではないが、無人実行・バッチ処理・クラウド連携に関係するものを中心に整理した。
出典: https://github.com/anthropics/claude-code/releases/tag/v2.1.302
1. fork subagents がデフォルト ON になった
今回の変更で一番気になったのはここだ。
claude -p（非インタラクティブ・無人実行モード）で使う場合、これまで fork subagents は明示的に設定しないとOFFだった。v2.1.302 からは デフォルトでON になった（Agent SDK、デスクトップアプリ、VS Code でも同様）。
fork subagent とは、Claude Code が内部で別のサブエージェントを起動して処理の一部を並列化・分担する仕組みのことだ。これを使わない前提で書いたスクリプトや、リソース競合を避けるために直列実行にしていたパイプラインは、挙動が変わる可能性がある。
OFFに戻すには: 環境変数 CLAUDE_CODE_FORK_SUBAGENT=0 を設定する。
自分の環境は同じ処理を複数チャンネルに対して順番に実行している。fork subagents がONになると、同一のファイルを複数のサブエージェントが同時に読み書きする状況が起きうる。アップデート後に挙動がおかしいと感じたらまずここを確認することにした。
2. 無人実行・定期タスクに影響する変更
深夜のルーティンが途中失敗後に再実行されていたバグが修正された
Cloud Sessions を使っている場合の話だが、こんな修正が入った。
Fixed a scheduled routine run that failed partway being run again from the start an hour or more later, which could repeat work such as posting the same report twice
途中で失敗したルーティンが、1時間以上後に 最初から 再実行されてしまう問題が修正された。「同じレポートが2回投稿された」という具体例がリリースノートに書かれている。
自分の環境は Windows タスクスケジューラで claude -p を直接呼んでいて Cloud Sessions ではないが、失敗後に自動リトライする仕組みを自前で持っている。再試行は「続きから」に設計しないと同じことが起きる——改めてその重要性を確認した。
デスクトップアプリと VS Code でサブエージェントがデフォルトでバックグラウンド実行に
Changed the desktop app and VS Code to always run the main conversation's subagents in the background
デスクトップアプリや VS Code 経由でも、メインのサブエージェントが常にバックグラウンドで動くようになった。claude -p には直接影響しないが、IDE 経由で自動化タスクを流している場合は動作を確認するとよい。
プロンプトキャッシュのミスが修正された
Fixed a prompt cache miss when a tool added mid-session was loaded again through ToolSearch or after compaction
セッションの途中でツールが追加された場合に、ToolSearch 経由やコンパクション後に再ロードされたツールのキャッシュミスが修正された。
長い無人セッションで「キャッシュ読み込みトークン数が予想より少ない」「コストが不釣り合いに高い」という記録があった場合、この修正が当てはまるかもしれない。
「Prompt is too long」エラーの修正
Fixed a "Prompt is too long" error when stopping a turn while the conversation was being compacted
コンパクション（会話の自動圧縮）中にターンを停止したとき、「Prompt is too long」エラーが出ていた問題が修正された。長時間のセッションを途中で止めるケースに関係する。
3. Read ツールのメモリ問題が修正された
Fixed the Read tool loading an image file of any size, or a pipe or device named like an image, entirely into memory; image sources over 128 MB are now refused
これはセキュリティ・安定性に関わる修正だ。
これまでは、画像ファイルのパス（または画像のような名前のパイプ・デバイスファイル）を Read ツールで読もうとすると、サイズを問わずメモリに全部読み込んでいた。巨大な画像ファイルや /dev/urandom のようなデバイスファイルを誤って読もうとすると、メモリを食い尽くす可能性があった。
修正後は、128 MB を超える画像ソースは拒否 される。
リポジトリに大きな画像が混ざっていたり、何らかの理由でデバイスファイルが混在している環境で無人実行している場合は、エラーになるケースが出るかもしれない。対象ファイルのサイズを確認するとよい。
4. 設定・環境関連
CLAUDE_CODE_AUTO_MODE_MODEL 環境変数が追加された
Added CLAUDE_CODE_AUTO_MODE_MODEL to choose the model the client-side auto mode classifier uses; it does not change the model for server-side auto mode
クライアント側 auto mode の分類器に使うモデルを環境変数で指定できるようになった（サーバー側の auto mode のモデルは変わらない）。コスト最適化のために分類器だけ軽いモデルを使いたい場合に有効だ。
/config に Idle compaction のON/OFFが追加された
Added an Idle compaction row to /config for turning idle compaction off or back on
アイドル状態でのコンパクション（会話の自動圧縮）を /config でON/OFFできるようになった。コンパクション後の通知にも「OFFにする方法」の案内が追加された。無人実行で予期しないタイミングのコンパクションをなくしたい場合の選択肢が増えた。
/autocompact と /effort の保存先バグが修正された
Fixed /autocompact and /effort saving to the wrong model when a gateway names Opus 4 or 4.1 with a prefix, such as anthropic/claude-opus-4-1
VAertex AI や AWS Bedrock など、モデル名にプレフィックスが付くゲートウェイを使っている場合、/autocompact や /effort の設定が間違ったモデルに保存されていたバグが修正された。カスタムゲートウェイを使っている環境では確認しておくとよい。
claude.ai/design が 2026年12月14日にクローズ
Added a notice to /design-sync and /design-login that standalone Claude Design (claude.ai/design) closes by December 14, 2026
/design-sync と /design-login に、claude.ai/design が 2026年12月14日でクローズするという告知が追加された。Claude Design を使っている場合は移行計画を立てる必要がある。
5. MCP・プラグイン関連
MCPサーバーが2026-07-28プロトコルバージョンで動かない問題が修正された
Fixed MCP servers showing no tools, or every tool call failing, when the server negotiates protocol version 2026-07-28 but omits resultType, ttlMs or cacheScope
MCPサーバーがプロトコルバージョン 2026-07-28 でネゴシエートするが resultType 等を省略している場合に、ツールが表示されない、またはすべてのツール呼び出しが失敗する問題が修正された。内製のMCPサーバーや、やや古いバージョンのMCPサーバーを使っている場合に関係する。
プラグインの起動時間が大幅に改善された
Improved startup time with many plugins enabled: plugin command and agent files now take far fewer file system calls to load, most of all on Windows
多数のプラグインを有効にしている場合、起動時のファイルシステムへのアクセス回数が大幅に削減された。特に Windows 環境での改善が大きいとのこと。claude -p を毎回起動するバッチ処理では、起動時間の短縮は地味に効いてくる。
プラグインの設定書き込みタイミングの修正
Fixed claude plugin and other subcommands sometimes exiting before a queued settings or config write finished, which could lose the change or leave a .tmp file behind
プラグインのサブコマンドが、設定の書き込みが完了する前に終了してしまい、設定が消える・.tmp ファイルが残るという問題が修正された。
6. Windows 環境向けの修正
Fixed every file write being refused or asked about for projects on exFAT or FAT32 drives, including in sessions started with --plugin-dir
exFAT または FAT32 形式のドライブ上にあるプロジェクトで、すべてのファイル書き込みが拒否またはパーミッション確認を要求されていた問題が修正された。外付けドライブや特定のパーティション上でプロジェクトを管理している場合に影響する。
7. Cloud Sessions の修正（10件以上）
| 修正内容 | 影響 |
|---|---|
| ルーティンが途中失敗後に再実行される問題 | 二重投稿・二重処理の可能性があった |
Rewind to here が最新メッセージ以外で動かない問題 |
self-hosted runner は v2.1.246 以降が必要 |
| 競合PRをreadyに戻してしまうステータスバーの問題 | PRのコンフリクト検知が誤動作 |
| cloud session停止後にCompletedと表示される問題 | ステータスの誤表示 |
| リポジトリリネーム後にdiff viewが失敗する問題 | リネーム後の操作ができなかった |
| コスト・使用量が新プロセス再起動後にリセットされる問題 | セッション再開後に費用の追跡ができなかった |
| ルーティンが開始しなかった理由がページに表示されるように | 原因の可視性が向上 |
8. その他の修正（一覧）
- Vertex/Bedrock 切り替え後に
diagnostics: Extra inputs are not permittedエラーが出る問題を修正 - auto mode で会話が長すぎる場合にコンパクションするよう改善（すべてのチェック済みツール呼び出しが拒否されていた問題）
- アーティファクトの公開・更新失敗の修正（空の編集リストを送った場合、不正な再試行をしていた）
- OpenTelemetry の
tool_decisionイベントでclassifier_categoryが欠落する問題を修正 -
claude remote-control --helpが未サインイン時に出力されずに終了する問題を修正 - URL のハイパーリンク表示の修正（折り返し時に1行目しかリンクにならない問題）
- ワークツリー分離が git 2.56 以降で失敗する問題を修正
- プロンプト提案がクレジット対象モデルで使用量を消費する問題を修正
- [VSCode] コードブロック表示の修正
- [VSCode] MCPサーバーのパネルからのサインインURLの修正
- [VSCode] @browser バナーの修正
今回確認したこと
全35項目の変更のうち、claude -p を使った無人バッチ実行で一番確認が必要だと感じたのは fork subagents のデフォルト有効化だった。
設定変更なしで挙動が変わる変更は、事前に確認しておかないと原因不明の動作につながる。CLAUDE_CODE_FORK_SUBAGENT=0 で従来の動作に戻せる。
あとは Read ツールの 128MB 制限——無人実行で予期しないファイルを指定するケースへの安全網として機能する。スクリプトがエラーになったときの原因候補として頭に入れておきたい。
変更点全リスト: https://github.com/anthropics/claude-code/releases/tag/v2.1.302