Release archive

Claude Code v2.1.296：gatewayのcodeポリシー、サブエージェントごとの自動コンパクトウィンドウ、ワークフローサブエージェントのモデル設定

Claude Code v2.1.296では、Claude apps gatewayのポリシーにcodeキーが、サブエージェントにautoCompactWindowが加わり、CLAUDE_CODE_WORKFLOW_SUBAGENT_MODELとReadツールのallow_largeオプションが追加され、管理フックとWindowsの問題が修正されました。

• 10 min read • 著者：ClaudeWorld

Claude Code v2.1.296の変更履歴は79項目です。Claude apps gatewayのmanaged.policies[]にcodeキーが加わり、サブエージェントが独自のautoCompactWindowを設定できるようになりました。さらにCLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL、CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS、Readツールのallow_largeオプションが追加されています。修正は、管理設定のフック、Claude apps gatewayのサインイン、←によるバックグラウンド移行、プラグインとmods、そして複数のWindowsの問題に及びます。

新機能

Claude apps gatewayのcodeポリシー

Claude apps gatewayのmanaged.policies[]が新しいcodeキーを受け付けるようになりました。cliと同じ設定を持ち、Claude DesktopのCodeタブにも適用されます。desktopと併用すると、Claude Desktopのgatewayモードが有効になります。gatewayの背後にあるCodeタブのセッションを開始できない場合（gatewayのcode設定に対応していないマシンを含む）、その理由が返信として表示されるようになりました。

サブエージェントごとのautoCompactWindow

サブエージェントのフロントマターと--agentsの定義でautoCompactWindowを指定できるようになり、サブエージェントをメインの会話のウィンドウより早く自動コンパクトさせられます。

ワークフローサブエージェントのモデルと過負荷時の再試行遅延

CLAUDE_CODE_WORKFLOW_SUBAGENT_MODELを使うと、他のサブエージェントはそれぞれのモデルのまま、すべてのワークフローエージェントを1つのモデルで実行できます。CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MSでは、過負荷（529）のリクエストを再試行する際のバックオフの最大遅延を長く設定できます。

Readツールのallow_large

Readツールにallow_largeオプションが追加されました。ファイル全体が必要でコンテキストに余裕がある場合、Claudeは通常のサイズ上限を超えるテキストファイルを1回の呼び出しで読み取れます。

MCPの説明文の上限を拡大

最初に送られるMCPツールの説明とMCPサーバーの指示のデフォルト上限が、2,048文字から4,096文字に引き上げられました。

コスト表示でのSonnet 5.5キャッシュ読み取り料金

/cost、ステータスライン、--max-budget-usd、SDKのコスト値は、Sonnet 5.5のキャッシュ読み取りを100万トークンあたり$0.10（以前は$0.20）で計算するようになりました。

←による移行中に始まった作業を停止

セッションをバックグラウンドへ移している最中に始まったターンや!コマンドは、見えないところで最後まで実行されるのではなく、停止されるようになりました。

より役立つ--debug出力

--debugは、カスタムエージェントファイル内の認識できないフロントマターのフィールド名を示し、タイプミスの可能性についてヒントを出すようになりました。ツール呼び出し、プロンプト、SessionStart、Stopに対するコマンドフックは、完了時にコマンド、プラグイン、結果、所要時間をログに記録するため、遅いフックを特定できます。

VS Code：Claude in Chromeがブラウザー操作の前に確認

VS Codeでは、Claude in Chromeがターミナルと同様に、@browserで接続したセッションを含むすべてのセッションでブラウザー操作の前に確認を求めるようになりました。そのセッションでサイトを許可すると、同じ確認は繰り返されません。

Claude Tag：メモリファイルと返信のフッター

Claude Tag Admin権限を持つメンバーは、ActivityページのMemoryタブでワークスペースとチャンネルのメモリファイルを作成、編集、削除できるようになりました。Slack上のClaudeは、セッションへのリンク、モデル、コストを含むフッターを、スレッド内の最新の返信にだけ表示するようになりました。

修正と改善

  • 管理設定のフック：管理設定のPreToolUseフックが"continue": falseでツール呼び出しを拒否した場合や、管理設定のpromptフックが呼び出しをブロックした場合に、呼び出しを拒否するだけでなくターンも終了するようになりました。管理設定のPostToolUseフックが、一部のセッションでupdatedMCPToolOutputを適用しない問題も修正されています。
  • フックの入出力：UserPromptSubmitフックやmodのprompt.submitフックの実行中にEscや中断を行っても、ヘッドレスセッションが終了したり、入力済みのプロンプトが消えたり、未チェックのプロンプトが通過したりしなくなりました。プラグインのヒントタグに似たテキストを含むフック出力が書き換えられることもなくなり、CLAUDE_ENV_FILEが単純な代入だけを含む場合、フックが書き込んだ変数をPowerShellのコマンドからも参照できるようになりました。
  • ヘッドレスのMCP：ディレクトリの変更やプラグインの再読み込みの後に、そのフォルダーでオフにされた.mcp.jsonやプラグインのMCPサーバーをヘッドレスセッションが起動しなくなりました。
  • gatewayへのサインイン：allowedProvidersを"gateway"付きで提供するClaude apps gatewayが、ユーザー設定でそのgatewayを指定しているノートPCを締め出すことがなくなりました。管理設定でforceLoginMethodがgatewayに設定されforceLoginGatewayUrlがないマシンで、保存済みのgatewayサインインが無視される問題（2.1.295でのリグレッション）も修正されました。
  • トークン数：Haiku 5.5など適応型の思考のみを受け付けるモデルのトークン数の計算が、一部のゲートウェイの背後で失敗したり、それ以外の環境で予算型の思考として計算されたりすることがなくなりました。
  • 権限：シェル変数BASH_ARGV0に代入してから使う一部のコマンドを、Bashの権限チェックが自動承認しなくなりました。Windowsでは、Git Bashでのrm -rf /c/Users/<name>が権限スキップモードでも確認を求めるようになりました。機能フラグが読み込まれていない場合に、保存済みの権限で許可されたClaude in Chromeの操作に対するauto modeのチェックを、クラウドセッションが省略することもなくなりました。
  • UTF-8以外のファイルの編集：有効なUTF-8ではないファイル（Windows-1252、Shift-JIS、GBK）で、EditとNotebookEditがすべての非ASCII文字を置き換えてしまう問題を修正しました。このような編集は拒否されるようになりました。
  • ←によるバックグラウンド移行：バックグラウンドサービスの応答が遅いときに、←の直後に送ったプロンプトが2回実行されることがなくなりました。SessionStartフックの実行中に送ったプロンプトは、←でセッションを移しても消えなくなりました。送信はされませんが、↑で呼び戻せます。
  • resume：セッションの履歴を読み取れない場合に--teleportが空の会話を開くことがなくなり、セッションのシャットダウンで中断されたツール呼び出しを、再開したサブエージェントがユーザーに拒否されたと伝えられることもなくなりました。CLAUDE_CODE_RESUME_INTERRUPTED_TURNが、MCPツールの結果で終了済みのターンを再実行することもなくなりました。
  • シークレットの秘匿：共有されたトランスクリプトやデバッグログでのシークレットの秘匿処理が、値のないキーの後に続く一部の値（シェル文字列内に書かれたJSONを含む）を見逃さなくなりました。
  • プラグインとmods：プラグインが提供する$メソッドが、呼び出し元エージェントの作業ディレクトリで実行されるようになりました。modの再読み込みや削除の後もまだ動いているフックからの$.agent.registerは拒否されます。レスポンスが4 MiBの本文上限を超えるContent-Lengthを宣言していても、$.http.fetchがHEADリクエストを拒否しなくなりました。constructorのような名前のmarketplaceは、内部エラーではなくaddの時点で明確に拒否されます。
  • claude.aiとの同期：複数のセッションが設定ディレクトリを共有している場合でも、claude.aiから同期したスキルのインストールが完了するようになりました。同期したプラグインが宣言するmarketplaceの依存関係もclaude.aiから同期されている場合に、そのプラグインが無効化されることもなくなりました。
  • ワークフロー：ワークフロースクリプトが、約20,000階層より深くネストした結果、エージェントのオプション、その他の値を黙って切り詰めることがなくなりました。WorkflowツールはCRLF改行のスクリプトファイルも受け付けます。
  • /code-review：クラウドセッション、Agent SDK、IDE連携で、/code-reviewが生のJSON配列で終わることがなくなり、指摘は番号付きリストで出力されます。
  • ターミナル：MATE Terminalなど古いVTEベースのターミナルで、コピー後に余分な52;c;…エスケープシーケンスが画面に表示されなくなりました。/diffパネルやダイアログを開いている間、トーストや通知が見えないまま待たされることもなくなりました。フルスクリーンモードではマウスポインターの下のリンクに下線が付き、コードの多い会話でのトランスクリプト切り替え（ctrl+o）の反応も速くなりました。
  • Windows：約1 KBを超えるPowerShellコマンドが常に権限の確認を求めることがなくなりました（許可ルールと読み取り専用の判定は32 KBまで適用されます）。stdio MCPサーバーがシャットダウン時に強制終了されなくなり、GitHub SSHキーのないマシンではclaude plugin installがGitHubのowner/repoソースをHTTPSで再試行します。
  • self-hosted runner：登録が拒否されたときに、claude self-hosted-runnerが誤解を招くエラーを表示しなくなりました。--capacityが1より大きいrunnerで同じリポジトリの別のセッションが開始されている間に、セッションのgit fetch、pull、pushが失敗することもなくなりました。
  • トランスクリプト：CLAUDE_CODE_TRANSCRIPT_LOCAL_GCが、Unicodeの行区切りや段落区切り（U+2028、U+2029）を含むメッセージを保存済みトランスクリプトから落とさなくなり、解放できる容量が10%未満の場合は大きなトランスクリプトファイルを書き換えなくなりました。claude purgeがそのようなプロンプトを履歴ファイルに残すこともなくなりました。
  • VS Code：拡張機能の設定にclaudeCode.spinnerVerbsが追加され、settings.jsonで補完と検証が効くようになりました。Windowsの完全なパスで書かれたチャット内のリンクでファイルが開くようになり、OS、VS Code、またはprefersReducedMotion設定でモーションを減らす設定（reduced motion）がオンのときは、作業中インジケーターのアニメーションが止まります。
  • Code Review：レビューの完了後に、プルリクエストのCode Reviewチェックが「in progress」のまま残ることがなくなりました。管理設定では、設定を保存できなかった理由が一般的な失敗メッセージではなく具体的に表示されます。

このリリースには合計79件の変更が含まれています。すべての項目は完全な変更履歴をご覧ください。

アップデート方法

  1. インストール済みのバージョンを確認：claude --version
  2. その場でアップデート：claude update
  3. EditとNotebookEditは、有効なUTF-8ではないファイル（Windows-1252、Shift-JIS、GBKなど）の非ASCII文字を置き換えるのではなく、編集自体を拒否するようになりました。Claudeがそのようなファイルを編集しようとすると拒否される点に注意してください。

リンク