2026-10-19、Claude Code v2.1.304がリリースされた。
前回のv2.1.302（2026-10-17）から2日しか経っていないが、今回も追加・修正・改善合わせて55件前後の変更が入っている。Claude Codeのリリースペースは相変わらず速く、実運用している側としては「何が変わったか」を毎回追うのがそれなりの作業になっている。
この記事は、リリースノートを読んで「これは無人実行や組織での利用に影響しそうだ」と感じたものを優先して整理したメモだ。Claude Codeを自動化・無人実行に使っている人、チームや組織でClaudeを使う場合に管理設定を気にしている人向けに絞って書く。
この記事で分かること：
- v2.1.304の主な追加機能（/auto-mode-setup・/claude-api managed-agents-secure）
- 無人実行・SDK利用に影響するバグ修正（5件）
- プラグイン・mod関連の主な変更
追加された機能（Added）
/auto-mode-setup：自動モードの設定ガイドが追加
/auto-mode-setup というコマンドが追加された。プロジェクトと最近のセッションを読んで、自動モード（auto mode）について環境を教えてくれるガイド付きセットアップだ。
これまで自動モードは手動で設定する必要があり、初めて使う人には敷居が高かった。今回の追加で、Claude Codeが自分でプロジェクトを分析して自動モードの推奨設定を提示してくれる流れになる。
Bedrock、Vertex、Foundry、Claude apps gateway、テレメトリ無効セッションでも利用可能。
/claude-api managed-agents-secure：セキュリティ設定の比較
/claude-api managed-agents-secure が追加された。Managed AgentsエージェントのAnthropicの公式セキュリティガイドとの設定比較を行う。何も変更しない読み取り専用の診断コマンドだ。
組織でManaged Agentsを使っている場合、設定がガイドラインに沿っているかをこのコマンドで手軽に確認できる。「何も変更しない」という設計は、本番環境での診断に使いやすい。
decider: "person" の追加
mod（プラグイン機能）のtool.checkアンサーにdecider: "person"が追加された。これを指定すると、そのツール呼び出しの承認はパーミッションダイアログかホストのコールバックのみが行える。誰にも承認を求められない状況では拒否される。特定のツール呼び出しに人間の確認を必須にしたい場面で使える機能だ。
使用上限が近い場合の警告（ProおよびMaxプラン）
ProとMaxプランで、非アクティブな会話を再開したとき、5時間の使用枠の相当な量を使いそうな場合に警告が出るようになった。「そのまま再開する」か「新しい会話を始める（以前の会話はClaudeに参照させられる）」かを選択できる。
無人バッチを動かしている側にも影響する可能性がある。深夜に止まっていたセッションを再開するとき、残量によっては警告が出て止まるかもしれない。
バグ修正（Fixed）のうち無人実行・SDK利用に影響しそうな5件
今回のv2.1.304は修正件数が多い。無人実行やSDK利用者に影響しそうなものを5件選ぶ。
1. ヘッドレス実行がmax-turns後も続く問題
Fixed a plugin keeping a headless run going past --max-turns, Stop, or ended input by spawning subagents or re-running a finished one
プラグインがサブエージェントを生成したり終了済みのものを再実行することで、ヘッドレス実行が--max-turns・Stop・入力終了を超えて続いていたバグが修正された。
無人で動かしている場合に、想定外にセッションが延びてコストがかかっていた可能性がある。このバグが影響していたかどうかは、自分のセッションのcapacity-logなどで確認できる。
2. LLMゲートウェイ経由のcontext_managementエラー
Fixed context_management: Extra inputs are not permitted errors behind LLM gateways
LLMゲートウェイ経由で使っている場合に「Extra inputs are not permitted」エラーが出ていたバグが修正された。ゲートウェイ経由での利用が安定するはずだ。リクエストをフィールドなしで再送信するよう修正された。
3. CLIの出力ファイル削除バグ
Fixed Bash and PowerShell deleting a large command's output file when it could not be copied to the session's tool-results folder, unless the disk is full
BashやPowerShellで大きなコマンドの出力ファイルが、tool-resultsフォルダにコピーできなかった場合に削除されてしまうバグが修正された。大きなファイルを扱う処理で出力が消えていた可能性がある。
4. サブエージェントの最近の作業が消える問題
Fixed subagents sometimes forgetting their most recent work when they were messaged or resumed right after finishing
サブエージェントが終了直後にメッセージを受けたり再開されたりしたとき、直近の作業内容を忘れる問題が修正された。マルチエージェント構成での動作が安定するはずだ。
5. /loopの自己ペーシング問題
Fixed self-paced /loop wakeups scheduled at the 1-hour maximum firing just after the 1-hour prompt cache expired, so those wakeups no longer re-read the conversation uncached
セルフペーシングの/loopで、1時間の最大スケジュールで設定された場合に、プロンプトキャッシュの有効期限（1時間）が切れた直後に起動してしまい、会話全体をキャッシュなしで再読みしてしまっていた問題が修正された。
/loopでの定期実行でコストが想定より高かった場合、このバグが原因だったかもしれない。定期実行コストの見直しのきっかけにもなる修正だ。
ワークツリー関連の重要な修正
Fixed claude --worktree removing the worktree and its branch without asking at exit when HEAD was detached or on another branch
--worktreeオプション使用時、HEADがdetachされているか別のブランチにある場合に、終了時にworktreeとブランチを確認なしに削除してしまうバグが修正された。コミットが失われる可能性があったバグで、--worktreeを使っている人は修正の恩恵を受けることになる。
mod（プラグイン）関連の修正
mod関連の修正が今回も複数入っている。
- modのフェイル時のリロードで、残ったバージョンのツールとコマンドが削除されていたバグの修正
- 同じラベルでkeyなしのボタンが再描画されたときにクリックが失われていたバグの修正
- mod共有がsecretscanで止まる問題の修正（managed設定環境・TeamおよびEnterpriseプランでの問題）
- modのonceフックが、同じフックを持つ別のmodのフックまで削除していたバグの修正
modを積極的に使っている環境では、今回の修正で予期しない動作が減ることが期待できる。
改善（Improved）のうち目立つもの
/usageの表示改善
使用量データのレート制限が解除されるタイミングを「try again in a moment」ではなく具体的な時間で表示するようになった。使用上限に当たったときの把握がしやすくなる。
クラウドセッションの初回ターン遅延改善
新しい会話の最初のターンが、claude.aiから同期されたプラグインのローカルMCPサーバーを待たなくなった（alwaysLoad: trueが設定されている場合を除く）。初回レスポンスが速くなるはずだ。
大きなコンパクションセッションのレジューム改善
SDKおよびヘッドレスセッションで、大きくコンパクションされたセッションの再開が改善された。
無人実行環境で気になる変更まとめ
Windowsタスクスケジューラ経由でclaude -pを定期実行している構成で影響しそうなものを選ぶと、以下の4点が実用上の影響として大きい。
| 変更 | 影響 |
|---|---|
| /auto-mode-setup追加 | 初期の自動モード設定が楽になる |
| ヘッドレス実行がmax-turns後も続くバグ修正 | 想定外のコスト増加のリスクが減る |
| /loopのキャッシュ切れ後の無駄な再読み修正 | 定期実行のコストが安定する |
| サブエージェントの作業消失バグ修正 | マルチエージェント構成の信頼性向上 |
まとめに代えて
Claude Codeはこのペースで毎週数十件の変更を重ねている。無人実行やSDK利用をしている場合は、セッションが止まる・コストが増える・出力が消える類のバグ修正は毎回確認しておく価値がある。
v2.1.304ではヘッドレス実行の信頼性改善が中心の一つで、無人バッチを安定させる観点からは歓迎のリリースだ。正直、ヘッドレス実行がmax-turns後も動き続けていたバグは、気づかずにコストが出ていた可能性がある。
出典：Claude Code v2.1.304 リリースノート（GitHub、2026-10-19）
https://github.com/anthropics/claude-code/releases/tag/v2.1.304