Claude Code v2.1.265、subagent 再開の cache 再利用を修正、SDK で cd が持続

Claude Code の v2.1.265 が 2026年9月8日付で GitHub Releases に出た。ノートの中で比重が大きいのは、subagent や agent team を多用している人、-p や Agent SDK で自動化を組んでいる人、そして Claude apps gateway の managed settings で端末を管理している人に関わる変更だ。端末で対話的に使っているだけなら、変わるのは tmux や /model まわりの細かな修正が中心になる。

使い方	変わったこと	やること
subagent・agent team を多用	再開時に prompt cache が外れていた経路を修正	更新前後の入力トークンを比べる
-p・Agent SDK・cloud session	cd が turn をまたいで残るようになった	作業ディレクトリを前提にした処理を点検
Claude apps gateway 配下	telemetry の項目と送信先、起動時のログイン扱いが変更	collector の到達性と managed settings を確認

出典：GitHub Releases の v2.1.265 リリースノート（2026年9月8日付）

Tags では同じ 9月8日付で v2.1.266 も切られている。以下は v2.1.265 のノートに載った変更を、影響を受ける側から順に見ていく。

再開した subagent が prompt cache を捨てていた

費用に直結する修正が二つある。フォアグラウンドで起動した subagent を再開すると tool list と system prompt の prefix が変わり、その agent の prompt cache が再利用されなくなっていた。agent teammate と再開した subagent では、後続の turn で SubagentStart hook のコンテキストと preload された skill が prompt prefix の外へ動き、やはり cache が効かなくなっていた。どちらも v2.1.265 で直っている。

削減幅はノートにない。subagent を長く回すワークフローほど prefix の再利用が効くはずなので、更新の前後で入力トークンの内訳を比べる価値はある。ただしこれは推測で、ノートは効果を数字で示していない。

関連して、advisor tool とその指示がリクエストごとに、そのリクエストのモデルで決め直されていた挙動も改まった。判断は一度だけ行われ、変わったときは会話上で告知される。前のプロセスがツール実行中に落ちた後の再開も直り、最後のプロンプトは書き換えられず、中断されたツール呼び出しは interrupted の印を付けて残る。多数のファイルを読んだ長いセッションの再開時間も短くなったとある。container の再起動後に workflow の実行を再開するとき、run journal が無ければ全 agent を再実行せずに明確なエラーで止まるようになった。

-p と Agent SDK で cd が turn をまたぐ

非対話セッション、すなわち stream-json 入力の -p、Agent SDK、cloud session では、ユーザーメッセージが届くたびにシェルの作業ディレクトリがリセットされていた。v2.1.265 からは cd が turn をまたいで持続する。

ノートは Fixed に分類しているが、自動化の側から見れば挙動の変更だ。毎 turn がリポジトリのルートから始まる前提でコマンドを組んでいたなら、二つ目の turn 以降で相対パスの向きが変わる。影響の有無はワークフロー次第で、ここはノートに書かれていない筆者の推測になる。

stream-json まわりでは、context: fork の skill が kickoff プロンプトを流さず、--forward-subagent-text を付けてもテキストの turn が progress event として出ていなかった不具合が直った。--bg セッションが idle timeout の直前にメッセージを受けると turn の途中で retire されることがあった問題と、token の更新中にセッションを閉じると VS Code や SDK で再ログインを求められることがあった問題も修正されている。

ディスクに保存する tool result には 1GB の上限が付いた。上限で切り詰められた場合は、会話内のプレビューにその旨が出る。

gateway 配下の端末は送信項目と送信先が変わる

Claude apps gateway を通す環境で管理者が読む項目は、telemetry の内容、送信経路、起動時のログインに分かれる。telemetry では、Claude Desktop と Cowork が gateway 経由で送る項目に user.email と user.groups が加わった。ノートはこれを端末セッションに合わせる変更だと書いており、Claude Code の端末セッションはすでにこの二つを送っていたと読める。Claude Code のリリースノートに Desktop と Cowork の項目が載っている理由は書かれていない。

送信経路は、gateway の managed settings で OTEL_EXPORTER_OTLP_ENDPOINT に collector が指定してあれば、gateway セッションの OpenTelemetry が relay を通さず collector へ直接送るようになった。指定がなければ従来どおり relay を使う。直接送るなら各端末から collector に届く経路が要ると読めるが、ネットワーク要件はノートに書かれていない。relay 側では、不正または大きすぎる payload をいくつか拒否した後に 30秒間すべての転送を止めていた不具合も直った。

起動時のログインは、managed settings に forceLoginGatewayUrl がある端末が、forceLoginMethod を gateway にしたときと同じく起動時から gateway セッションになる。残っていた claude.ai のログインや API key は使われない。managed settings で指定した gateway にサインインしたセッションで /login を再実行すると「no gateway URL is configured」と出ていた不具合、skill だけを plugin に固定した設定で /add-dir がサブディレクトリの agent を読み込まなかった不具合も修正されている。

plugin ディレクトリと MCP の接続

--plugin-dir に複数の plugin を入れたフォルダを指せるようになった。manifest を持つ子フォルダがそれぞれ読み込まれ、実行中に子フォルダを足したり消したりしても拾われる。

plugin のパス検査も二件直った。macOS と Linux で、バックスラッシュを含むパスが symlink の封じ込め検査をすり抜けていた。逆に、名前がドット二つで始まるディレクトリは plugin root の外だと誤判定されて拒否されていた。symlink ループのように OS が検査できない既定の component フォルダは、黙って飛ばされずに /plugin にエラーコード付きで表示される。

MCP は、http として設定したサーバーが旧来の HTTP+SSE しか話さない場合に一度も接続できなかった問題が直り、MCP の仕様どおり SSE に fallback する。サインインが要るリモート MCP サーバーには、実際に認証するまで OAuth client を登録しなくなった。

端末と VS Code の細かな修正

tmux の中では二つ目のキーが 1秒より遅れて届き、二キーのショートカットが黙って取り消されていた。待ち時間は 3秒になり、時間切れのときは通知が出る。/model opusplan[1m] が「Model not found」で拒否されていた件も直った。設定ファイルに書けなかったのに /model が「saved as your default」と表示していた件は、保存に失敗した理由を出すようになった。

大きなリポジトリでの --worktree 起動は、git 2.32 以降なら worktree のチェックアウトが並列になる。画像処理はランタイム組み込みの機能を使うようになり、CLI がネイティブの画像モジュールを一時ディレクトリに展開しなくなった。Windows では AppContainer や制限トークンのサンドボックス内で Read、Write、Edit がすべてのファイルを拒否していた不具合が直っている。

他人が書いた artifact を Artifact tool で読むときの要約は、ページを信頼できない内容として扱い、埋め込まれた指示を中継せずに指摘する。同梱の claude-api skill のエラーコード一覧も訂正され、モデルへのアクセス失敗は 404、使えない beta header は 400 で、403 ではない。

VS Code 拡張には「Archive inactive sessions」設定が加わり、一定期間動きのないセッションが自動でアーカイブされる。既定は 14日だ。サイドバーの履歴を長く残す使い方なら、既定のままでよいかは確認しておきたい。

更新経路と同日の v2.1.266

リポジトリの README は npm 経由のインストールを deprecated としており、macOS と Linux ではインストールスクリプトか Homebrew、Windows ではスクリプトか WinGet を案内している。

curl -fsSL https://claude.ai/install.sh | bash
brew install --cask claude-code

npm で入れたままの環境に v2.1.265 が届くかは README に書かれていない。v2.1.257 で auto モードの拒否ルールを扱ったときから、リリースは数日おきに続いている。Tags では v2.1.263 と v2.1.265 の間に番号の抜けがあり、v2.1.266 は同じ 9月8日付で並ぶ。更新後にどのバージョンが入ったかは確かめておきたい。