Claude Code 9月中旬アップデート実践メモ — managed MCP・/diff・auto-compact

対象は Claude Code 2.1.257〜2.1.273（GitHub Releases の公開日でおおむね 2026-09-01〜09-15 UTC）。正本は CHANGELOG.md と docs changelog。既存の /advisor やローカルデータ保存の話とは別トピックで、運用で効く3点だけ拾う。

日付の注意: 2.1.273 の published_at は 2026-09-15 20:23 UTC（= 09-16 05:23 JST）。「〜9/15」を日付で切るなら UTC 基準と書いておく。2.1.262 と 2.1.264 は GitHub release / changelog 節が見つからない。

Managed MCP: 全員に配るか、固定セットにするか

組織向けの MCP 制御は、docs の Control MCP server access が正本。パターンは大きくこう分かれる。

  • managed-mcp.json: 固定セット（または空マップで MCP ほぼ無効）。ユーザーは追加できない。パスは macOS /Library/Application Support/ClaudeCode/managed-mcp.json、Linux/WSL /etc/claude-code/managed-mcp.json、Windows C:\Program Files\ClaudeCode\managed-mcp.json。server-managed settings では配信できない。
  • managedMcpServers: managed settings 経由で HTTP/SSE サーバを全員に「足す」。ユーザー自身のサーバは残る。要 v2.1.259 以降。
  • allowlist / denylist: allowedMcpServers / deniedMcpServers。権威ある allowlist にするなら allowManagedMcpServersOnly: true を managed ソースに置く。

2.1.259 で何が変わったか

v2.1.259 で managedMcpServers が追加された。changelog の要旨は次のとおり。

  • organizations can provide HTTP/SSE MCP servers to every user（.mcp.json と同じエントリ形。command を指定するエントリはスキップ）
  • allowedMcpServers は ユーザーが追加するサーバだけ を対象にする。以前 allowlist で弾いていた managed-mcp.json のサーバは、アップグレード後に載り始める。止めたいなら deniedMcpServers

Week 36 whats-new も同趣旨で、「managedMcpServers で HTTP/SSE を全員に渡せる」と書いている。

managedMcpServers エントリの制約（docs）は実務で効く。type は http / sse、url は https://、command / args / env / headersHelper 不可、${VAR} 展開なし。ヘッダに秘密を書くなら、マシン上で誰でも読める前提で考える。

このバージョン範囲での運用修正

  • 2.1.257: managed allow/deny や strictPluginOnlyCustomization のあとでも /mcp の reconnect / enable で繋がってしまう不具合を修正。release
  • 2.1.271: 読めない / パースできない managed-mcp.json を無視せず、exclusive 制御を維持して起動時に警告。release
  • 2.1.273: MDM / managed-settings.json の allowManagedMcpServersOnly・deniedMcpServers・disableClaudeAiConnectors が、server-managed settings 併用時に無視される不具合を修正。release。docs は「lock と allowlist をソース横断で読むには v2.1.273 以降」と書いている

設定まわりでつまずきやすい点だけ、一次情報から拾う。

  1. 組織に HTTP/SSE MCP を配りたい／全員に足したい → managedMcpServers が入った更新（2.1.259）を追う価値あり。allowlist を権威ある形で効かせたいなら、MDM 併用時に無視される不具合が直ったところ（2.1.273）まで含む更新が効く
  2. 以前 allowedMcpServers だけで managed-mcp.json を間引いていた → allowlist の対象がユーザー追加分だけになったので、denylist か別ファイルに移す
  3. exclusive（固定セットのファイル）と「足すだけ」（managed settings）を混同しない

/diff: fullscreen の横パネル

v2.1.260 で、fullscreen の会話横に uncommitted changes のパネルが追加された。changelog:

Added a diff panel that opens beside the conversation in fullscreen mode and shows your uncommitted changes as Claude edits; toggle it with /diff

whats-new w36 の前提は次のとおり。

  • fullscreen rendering がオン
  • git リポジトリ内
  • 端末幅 110 カラム以上
  • ファイル編集やシェル実行のたびに更新
  • マウスで行選択して次のプロンプトへ添付できる

その後の磨き込み:

版内容
2.1.267「0 files changed」フラッシュをやめ、空状態を中央寄せ
2.1.268/diff の選択がプロンプト入力内に見える
2.1.269開いた瞬間にフル描画（ローディング待ちを短縮）

混同しやすいが、設定の diffTool（提案編集を IDE / 端末のどちらで見るか）は別物。この記事の /diff は fullscreen のライブパネルの話。

auto-compact: 1M と長時間セッション

同じく 2.1.260 で、1M コンテキスト向けの改善が入った。

Improved auto-compact for 1M-context models: Opus and Fable sessions now compact shortly before the 1M-token limit, and recovery compaction on very large contexts no longer times out at 10 minutes

挙動の一般説明は model-config と settings-reference の autoCompactEnabled / autoCompactWindow。版固有の「いつ発火するか」の数値は、changelog の文言以上には踏み込まない。

同じバージョン範囲での信頼性修正:

版内容
2.1.268/compact・auto-compact の要約が $ を含むテキストを壊す不具合を修正
2.1.269要約できる earlier exchange がなく「Prompt is too long」に永久スタックする問題を修正（主に巨大プロンプトの Agent SDK）
2.1.269compaction 後に Claude が見る git status を「セッション開始時」ではなく「現在」に
2.1.271compaction 後も動いていた background command の二重起動を修正
2.1.273context meter / auto-compact が advisor-tool ターンを約2倍カウントし、コンテキストの半分くらいで早期発火していた問題を修正

advisor を併用した長時間セッションで、コンテキストの半分くらいで早く compact するなら、advisor 二重カウント修正（2.1.273）を含む更新が効く。

今日上げるなら

実務では latest へまとめて上げる前提で、症状ごとに「直った／使えるようになった版」を書く。版番号はピン留め用ではなく、いつ直ったかの根拠。

Managed MCP

  • allowlist で弾いていたサーバが upgrade 後に載る → 2.1.259 で allowlist はユーザー追加分だけ。止めたいなら denylist
  • /mcp の reconnect / enable で、ブロックすべきサーバに繋がる → 2.1.257
  • 壊れた managed-mcp.json で exclusive 制御が外れる → 2.1.271
  • MDM の managed MCP 制限が server-managed settings 併用で効かない → 2.1.273
  • 組織に HTTP/SSE MCP を配りたい → managedMcpServers（2.1.259）

/diff

  • fullscreen で未コミット差分を横で見たい → 2.1.260
  • 「0 files changed」フラッシュや、開いたときの loading が気になる → 磨き込み 2.1.267〜2.1.269

auto-compact

  • 1M 付近で compact が遅い／timeout → 2.1.260
  • compact 要約で $ が壊れる → 2.1.268
  • 「Prompt is too long」で詰まる → 2.1.269
  • compact 後に同じ background command が二重起動 → 2.1.271
  • advisor 併用で auto-compact が早すぎる（コンテキストの半分くらい） → 2.1.273

同じバージョン範囲で触っておくとよい隣接項目

短くだけ。

  • 2.1.269: claude plugin eval、CLAUDE_CODE_WORKFLOW_MAX_CONCURRENT_AGENTS（1–256）
  • 2.1.260: Fable 5.1 関連と /cost の prompt cache 診断（whats-new / changelog）
  • 2.1.268: gateway の pricing: を managed settings 経由で /cost と揃える

入れないこと（未確認 / 対象バージョン外）

  • ${VAR} の allowlist/denylist 環境ピン変更は changelog 2.1.219（この記事の対象バージョンではない）
  • 「raw git blob」系の /diff 変更は 2.1.222
  • 二次ブログの手順書や、VS Code 拡張が同じ日に同じビルド番号を載せるかは、ここでは未確認

出典