この記事でわかること：
- v2.1.299 で追加された「アイドルコンパクション」の動作と設定方法
- v2.1.300 で修正された WSL2 sandbox バグ（実際に踏んでいた方には朗報）
- エージェントのトランスクリプト表示・
agent.spawnでのモデル書き換えなど自動化用途向けの新機能
2026-10-14 と 10-15 の 2 日連続で、Claude Code の新バージョンがリリースされた（v2.1.299 と v2.1.300）。リリースノートが非常に長いので、大企業で AI・デジタル化推進を担当する立場から「実際に使っているところに刺さった変更」に絞って整理する。
普段、WSL2 上の Claude Code を Playwright + Node.js スクリプトと組み合わせて自動化を動かしている。そういう使い方の目線での読み解きになる。
v2.1.299 の主な変更点（2026-10-14 02:49 JST リリース）
1. アイドルコンパクション（idle compaction）の追加
今バージョンで一番実用的な追加機能だと思っている。
何が変わったか：会話のトークン数が 200,000 を超えた状態で約 54 分間アイドル（入力なし）になると、自動でコンパクション（文脈の圧縮）を実行するようになった。
Claude Code のプロンプトキャッシュは約 1 時間で失効する。200K を超えるコンテキストを持った状態で長時間放置すると、次のメッセージを送った瞬間にキャッシュミスが発生し、大量のトークンを再読み込みする——そのコストが一度で数百円相当になることもある。アイドルコンパクションは失効の前に自動で圧縮することで、この再読み込みのコストを回避する設計。
# 環境変数で閾値（トークン数）を変更できる（デフォルト 200000）
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS=150000
# settings.json で無効化する場合
{ "idleCompaction": false }
注意：コンパクションによって細かいコンテキストが落ちる可能性はある。「前の話を忘れた？」と感じたら、アイドルコンパクションが走ったことを疑う。無効化したい場合は settings.json に "idleCompaction": false を設定する。なお、54 分のタイムアウト自体は現状変更できない（環境変数で変えられるのはトークン閾値のみ）。
長時間の自動化エージェントを走らせていて、途中で席を離れる時間がある場合に特に効いてくる。
2. CLAUDE_CODE_DISABLE_FILE_MENTIONS の追加
@ファイル名 でファイルを言及したとき、これまではファイルの内容ごとコンテキストに渡されていた。この環境変数を有効にすると、ファイルのパスだけが渡され、内容は Claude が自分のファイルツール（Read など）で読みに行く形になる。
CLAUDE_CODE_DISABLE_FILE_MENTIONS=1
どんなときに使うか：大きなファイルを @ で言及するだけでトークン数が跳ね上がっていたケースの緩和策。Claude がツールを使って読むためターン数は増えるが、不要なトークン消費を防げる。大量の設定ファイルを @ で参照しながら作業するようなワークフローで有効。
3. /effort と /fast が agent view で使えるようになった
/effort と /fast コマンドが、エージェントの一覧・詳細画面（agent view）でも操作できるようになった。新しく起動するセッションのデフォルト設定をその場で変えられる。
複数のエージェントを並行で動かしている場合、個別のセッションに対してこれらをあとから設定しなおす手間が減る。地味な変更だが、エージェントを何本も走らせている環境では操作が楽になる。
4. v2.1.299 のバグ修正（実用的なもの抜粋）
多数の修正の中で実際に踏みやすいものをピックアップする：
| 修正内容 | 影響を受けていた状況 |
|---|---|
/branch でメッセージが消えるバグ |
会話内に Unicode 行/段落セパレータ（U+2028, U+2029）があった場合 |
claude mcp list が空の .mcp.json を「無効」と報告 |
.mcp.json が存在するが空の環境 |
SDK・ヘッドレスセッションが auto モードを誤って引き継ぐ |
セッション間でモード設定がブレていたケース |
| セキュアなシェルコマンド確認が過剰に出るバグ |
rm を含むスクリプトを実行していた場合 |
MCP サーバーを使っている環境では、空の .mcp.json のバグが原因で診断に迷うことがあったので、地味にありがたい修正。
v2.1.300 の主な変更点（2026-10-15 03:24 JST リリース）
5. WSL2 の sandbox バグ修正
WSL2 環境で Claude Code の sandbox を有効にしていた場合、bwrap: Can't mkdir /mnt/c/Program Files/ClaudeCode というエラーで sandboxed コマンドが失敗するバグが修正された。
WSL2 からは Windows の C:\Program Files\ClaudeCode がマウントパスとして見える状態になっているが、sandbox の設定がそのパスへの mkdir を誤ってブロックしていた。このバグは WSL2 + sandbox の組み合わせでないと再現しないため、気づかずに「なぜか動かない」と悩んでいたケースがあった可能性がある。
v2.1.300 にアップデートした後、WSL2 + sandbox を有効にした状態で Node.js や Playwright スクリプトを実行すると、この問題による失敗は出なくなるはず。
6. $.ui.view({agentId}) でエージェントのトランスクリプトが表示できるようになった
Claude Code の mod（プラグイン機能）を使っている場合の追加機能。
// mod の中で
await $.ui.view({ agentId: "ターゲットエージェントのID" }); // そのエージェントの会話を表示
await $.ui.view({}); // メインビューに戻る
複数のエージェントを並行で動かしているときに、特定エージェントの途中経過を mod 側から参照できるようになった。mod を自作している方には実用的な追加。普段の使い方でここまで入り込む人は少ないかもしれないが、エージェント監視や自動化の高度な組み合わせを考えている場合には覚えておきたい。
7. agent.spawn でワークフローエージェントのプロンプト・モデルを書き換えられるようになった
従来の agent.spawn mod hook は、ワークフローエージェントの起動を「拒否する」しかできなかった。今バージョンからプロンプトとモデルを書き換えて起動させることができる。
具体的な使い道としては：単純なタスクは Haiku（低コスト）、複雑な判断が必要なものは Sonnet と、エージェントの種類に応じてモデルを動的に切り替えるというコスト最適化が考えられる。複数の自動化ジョブを Claude Code で動かしているような環境で、コストを細かく制御したい場合に有効。
8. v2.1.300 のバグ修正（実用的なもの抜粋）
| 修正内容 | 影響を受けていた状況 |
|---|---|
| TLS 検査プロキシ（Zscaler 等）でキャッシュが古い情報のままになる | 企業のネットワーク監視環境 |
| Cowork クラウドセッションでの Write/Edit が「成功」と誤報告 | Cowork を使っている環境 |
--worktree が reftable 使用のリポジトリで .invalid ブランチになる |
Git の reftable ref storage を使っている場合 |
| ログを大量に出力中にメモリが増え続けて最終的にハングする |
--debug や --debug-file を使っていた場合 |
claude purge が Unicode セパレータを含むサブフォルダのプロジェクトをスキップ |
上記同様の Unicode 問題 |
企業の TLS インスペクション環境（Zscaler, Forcepoint 等）でプロキシを挟んでいる場合は、キャッシュ関連の修正が実用的に効いてくる可能性がある。大企業での Claude Code 利用では避けて通れないケースが多い。
また、--debug をつけて長時間デバッグしていたときのメモリリーク修正も地味に重要。複雑な自動化スクリプトのデバッグで長時間 --debug を使っていると、気づいたらメモリが食い尽くされていることがあった。
まとめ
v2.1.299〜v2.1.300 の実用ポイント：
- アイドルコンパクション（v2.1.299）：200K+ トークンの会話が 54 分アイドルで自動圧縮。プロンプトキャッシュ失効によるコスト増を防ぐ。不要なら
"idleCompaction": falseで無効化- WSL2 sandbox バグ修正（v2.1.300）：
bwrap: Can't mkdir /mnt/c/Program Filesの問題が解消。WSL2 + sandbox の組み合わせで詰まっていた方はアップデートを- エージェント制御の強化（v2.1.300）：mod から特定エージェントのトランスクリプトを表示・
agent.spawnでプロンプト/モデルを書き換えて起動可能に
どちらのリリースもバグ修正が多く、リリースノートを全部読むのはなかなか大変だった（v2.1.300 のリリースノートは特に長い）。実際に踏んでいたバグが直っているかどうかだけ確認するなら、バグの症状（エラーメッセージ）で検索するのが早い。
皆さんの環境で、これらの変更のうち実際に影響が出たものはありましたか？特に WSL2 + sandbox の組み合わせで詰まったことがある方がいれば、状況をコメントで教えてもらえると嬉しい。
出典：
- Claude Code v2.1.299 リリースノート: https://github.com/anthropics/claude-code/releases/tag/v2.1.299
- Claude Code v2.1.300 リリースノート: https://github.com/anthropics/claude-code/releases/tag/v2.1.300
この記事の内容で詰まったことや、自分の環境に応用したいケースはありますか？Copilot・AIエージェント構築の相談を受け付けています（ご連絡の際は「Qiitaを見た」とお書きください）：https://coconala.com/services/4209036