v2.1.251
2026-08-28 18:19:32 UTC
v2.1.251 は大型の feature + fix release で、model switch hook、foreground subagent の live stream、/usage / /cost の可視化追加に加え、sandbox、plugin path、managed settings、MCP、background session、Remote Control、cloud session 周辺に多数の修正が入った。
新機能
PreModelSwitch と PostModelSwitch hook event を追加し、model switch を block・confirm・annotate できるようにした。加えて SessionStart の resume hook には session の stale 状態と推定 re-cache cost を渡すようにした。
- foreground subagent の tool call と結果を Remote Control client へ live stream する機能を追加した。background subagent は従来どおり status のみ表示する。
- Claude apps gateway の spend limit 利用者向けに、
/usage の Spend limit bar と status line script 用の rate_limits.spend_limit フィールドを追加した。
/cost に session 単位の prompt cache 行を追加し、hit ratio、misses、re-cached token 数、warm / cold を見られるようにした。status line script 向けにも対応する prompt_cache object を追加した。
claude --help に attach、logs、stop、respawn、rm を追加し、実行中の background session に対する --resume メッセージでは正確な claude attach <id> を表示するようにした。
変更
- turn 中の interactive session における冗長な UI 再描画を減らし、CPU 使用率を改善した。
- native binary を約 5 MB 小さくし、install size を改善した。
- cloud session で network proxy が Bash command 中に接続を落とした場合、tool result で単なる
connection reset ではなく host 名と理由を表示するよう改善した。
/schedule の説明を改善し、Claude Code に設定された MCP server は cloud routine へ attach できないことを、簡素な No MCP connectors ではなく明示するようにした。
- 自分の subagent から来た message の framing を改善し、無関係な別 session の Claude ではなく、この session 内 worker からの送信だと Claude へ伝えるようにした。
- background subagent や subagent panel /
/tasks から開いた fork transcript を見ているとき、prompt placeholder が Message @name... と出るよう改善した。
- error message、menu、command result に出る MCP server 名の sanitization を改善した。
CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST 配下の Amazon Bedrock session start を改善し、Bedrock model ID や ARN を渡された session が inference-profile discovery 待ちで止まらないようにした。
- managed settings approval dialog を改善し、前回承認後に変わった設定だけを一覧表示するようにした。
- model の tool call が malformed な場合の retry を改善し、壊れた出力を retry context から落とすようにした。Bedrock、Vertex、Foundry でも同様とした。
/radio を Bedrock、Vertex AI、Foundry、Claude Platform on AWS、および telemetry 無効時でも利用可能に変更した。
- Claude in Chrome は browser action を常に Claude Code の permission check 経由で実行するよう変更した。従来 telemetry 無効 session で使っていた Chrome extension 側 prompt を通さない。
CLAUDE_CODE_SUBAGENT_MODEL は subagent model を全面 override するのではなく default 値を決めるだけに変更し、agent definition の model: や明示的な per-spawn model を優先するようにした。
- active model が認識済み Claude model でない場合の default commit trailer を
Co-Authored-By: Claude Code に変更した。
- seat-based Enterprise subscription の default model を、他の premium plan に合わせて Opus 5 へ変更した。
/effort は model ごとに default effort level を保存するよう変更し、model を切り替えても各 model の設定を保持するようにした。
- analytics は、managed settings による gateway login 強制や設定未読だけでは sign-in 前に無効化しないよう変更した。gateway sign-in 後または
DISABLE_TELEMETRY 時には引き続き無効になる。
- Bedrock、Vertex、Foundry、および telemetry 無効時の footer PR badge は、
gh auth token、GH_TOKEN、GITHUB_TOKEN 経由で GitHub API を直接呼ぶよう変更した。
- sandbox で Bash command を走らせる際の output file の作成と読み戻し方法を変更し、sandboxed command がその file を redirect や差し替えできないようにした。
- plugin / LSP install suggestion と auto-mode default offer は、入力中テキストを送信または消すまで待つよう変更し、prompt 送信の Enter で誤って応答しないようにした。
- sandbox TLS 終端、自前 proxy 経由の sandbox traffic、credential 注入、sandbox isolation 弱化を伴う server-managed settings は、適用前に approval を必須に変更した。
- managed または project settings 由来の
ANTHROPIC_CUSTOM_HEADERS が credential、org / tenant、routing、API behavior header を設定する場合は approval を必須に変更した。
- project-level の
.claude/settings.json の env では、CLAUDE_CONFIG_DIR、CLAUDE_CODE_TMPDIR、TMPDIR / TMP / TEMP を設定しないよう変更した。必要なら shell、user、managed settings で設定する。
- 6つのあまり使われない言語(
1c、gml、isbl、mathematica、maxima、sqf)の syntax highlighting を削除し、binary をさらに 2.5 MB 小さくした。
- [VSCode] Remote Control banner を footer pill に変更し、Remote Control が有効または失敗中のあいだ
claude.ai/code 上の session を開けるようにした。切り替えは /remote-control で行う。
修正
- working directory 内で symlink が permission check 後に差し替えられた場合でも、file tool の Read、Write、Edit が承認範囲外を読んだり書いたりできないよう修正した。
- marketplace entry で宣言された plugin command が plugin directory の外を指せていた問題を修正し、そのような path は path-traversal error で拒否するようにした。
- project settings が detailed beta tracing や raw API body logging を有効化できていた問題と、より低い scope の beta tracing endpoint が managed settings や host app に pin された OTLP collector を回避できていた問題を修正した。
- Workflow tool が permission check 前に、session が読めないはずの
scriptPath を読んだり error 内で引用したりしていた問題を修正した。
- Grep と Glob が、symlink された search path 経由で到達した file に
Read(...) deny rule を適用していなかった問題を修正した。
- model が thinking だけを出した turn のあとに conversation が
text content blocks must be non-empty で詰まる問題を修正した。
- fresh install の初回起動で、startup default が auto mode の account でも default mode で始まっていた問題を修正した。
- thinking 無効時に effort が xhigh / max だと Opus 5 request が
effort ... is not supported when thinking is disabled で失敗する問題を修正し、その場合は high を送るようにした。
- 他 session から Claude Desktop 経由で届いた message へ返信するとき、その session id への
SendMessage が失敗していた問題を修正し、Claude Desktop 経由で配送するようにした。
- 多数の parallel subagent がいると TUI が重くなる問題を修正し、1秒ごとの progress tick は transcript に積み増さず前のものを置き換えるようにした。
- agent team で teammate の最終回答が team lead に届かず、中身のない
available notice だけになる問題を修正した。回答は idle notification に届くようにした。
- background subagent が名前のない sibling や parent agent からの message に返信できない問題を修正した。原因だった
from が agent type になっていた挙動を直した。
- managed-settings の
disableAutoMode が session 中に到着しても、すでに動作中の auto-mode session が default mode へ戻らない問題を修正した。
- 現在の Opus model がすでに 1M context window を持っていても
switch to Opus 1M for 5x more context tip が出る問題を修正した。
- Claude apps gateway session が保存済み Anthropic profile を active と誤認し、
/status に出したり gateway 401 retry に使おうとした問題を修正した。実際の request には使わないようにした。
- cloud session が、host が session の初期 model を設定しただけなのに Claude へ model change が起きたと伝えていた問題を修正した。
- organization policy で Remote Control が無効なときに failure 扱いしていた問題を修正し、静かな single notice を出すだけにした。
- Remote Control 上の
/mcp reconnect が、別 session で server 無効化されていたとき generic withheld-detail error しか出さない問題を修正し、実際の remedy を示すようにした。
--input-format stream-json で、client 注入の assistant tool call に message id がないと最初の call に merge され結果が失われる問題を修正した。古い session の resume 時も同様だった。
- directory change によって session が同一 ID の既存 transcript 上へ移ったとき、transcript が無言で上書きされる問題を修正した。
- background session とその subagent が、自分で
git worktree add した git worktree 内の file を編集できない問題を修正した。
- 別の Claude Code process が plugin marketplace を refresh 中だと、background session が plugin skill を一切持たずに起動し、そのまま戻らないことがある問題を修正した。
- SSH 越しの tmux で開いた background session 内で text 選択すると、foreground session のように tmux buffer へ copy されず OSC 52 fallback していた問題を修正した。
- SDK MCP server の handshake acknowledgment が失われると SDK / cloud session が無期限に hang する問題を修正し、70秒で timeout してその server だけ failed 扱いにするようにした。
- self-hosted runner で stuck した session を force-stop したあとも Bash tool process が残る問題を修正した。
- Team / Enterprise member で admin が org の usage-credit limit を
$0 に設定している場合、/usage-credits が cap 到達と誤案内する問題を修正し、admin に依頼する案内へ変更した。
--worktree --tmux を gitlab.com origin と merge-request number 付きで使うと、失敗する GitHub 形式 fetch を先に試す問題を修正し、GitLab ref を直接 fetch するようにした。
- background session で
Ctrl+G を押すと、/dev/tty を開く editor(emacs -nw、micro など)で Emacs quit unexpectedly が出る問題を修正した。
additionalDirectories に null byte を含む entry があると startup crash したり、SDK host / IDE / hook 由来だと /add-dir や後続 settings update が壊れる問題を修正し、その entry を skip するようにした。
- MCP server menu の copy shortcut が、実際には失敗していても sign-in URL を copy したと常に成功表示する問題を修正した。
- GNU screen や terminal type が
screen の tmux session で italic text が highlighted block のように描画される問題を修正した。
claude mcp add --header と claude mcp add-json の help text が誤った transport 名を示していた問題を修正した。
claude ultrareview と /ultrareview が cloud session 起動失敗時にも 30分待ち切る問題を修正し、早めに止まって理由を報告するようにした。
- Bash permission check が整数 shell variable への算術式代入(例:
OPTIND=1/0、RANDOM=2+2)を自動承認していた問題を修正し、approval を求めるようにした。
- backgrounded session(
←、/background、--bg)が shell export された Vertex / Bedrock gateway(ANTHROPIC_*_BASE_URL + CLAUDE_CODE_SKIP_*_AUTH)を失い、request がすべて失敗する問題を修正した。
claude --bg --model fable が、同じ account の interactive session にはまだ Fable allowance があるのに usage credits を尋ねて止まる問題を修正した。
- 一度だけ出る
make auto mode your default offer が unattended session にも表示され、偶発的な keypress で unread のまま承認され得る問題を修正した。
- 同じ Claude apps gateway に再 sign-in したあと、managed-settings approval prompt が設定不変でも再表示される問題を修正した。
- 無効化された
/bug と /share が、/feedback が無効だと誤報する問題を修正した。tips、/help、refusal message も、org policy や env var で無効な /feedback を勧めないようにした。
- cloud session 作成時に一時的な GitHub connection failure が起きると GitHub setup を案内してしまう問題を修正し、retry を促す message にした。
- [VSCode] sign-in screen の
Bedrock, Foundry, or Vertex button が docs 冒頭を開いていた問題を修正し、third-party provider setup section を開くようにした。
v2.1.251 release note