Claude Code キャッチアップ: 2026-10-14

取得日: 2026-10-14 ソース: changelog / docs / blog

今回の注目ポイント

• v2.1.299・v2.1.300 の2リリースを収録（前回収録は v2.1.296 / 2026-10-09。v2.1.297・v2.1.298 は releases.atom に公開リリースエントリが無いため対象外）。どちらも大量の修正と少量の機能追加を含む。
• アイドルコンパクション（idle compaction）を追加（v2.1.299）。20万トークン超の会話を約54分放置すると、1時間のプロンプトキャッシュ失効前に自動で圧縮し、次のメッセージで全体を再処理させない。CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS で閾値変更、"idleCompaction": false で無効化。
• @ ファイルメンションの扱いを切り替える CLAUDE_CODE_DISABLE_FILE_MENTIONS を追加（v2.1.299）。中身を展開せず「パスだけ」を渡し、Claude 自身にファイルツールで読ませる。
• MCP 許可ルールの厳密化（破壊的変更）（v2.1.300）。mcp__a が a__b や a_ といった別サーバに一致しなくなった。__ を含むサーバは mcp__<正規化名全体>__* と書く必要があり、agent の tools: リストも同様。
• 権限フック updatedInput の検証強化（破壊的変更）（v2.1.300）。PreToolUse / PermissionRequest フックが返す updatedInput が Claude 自身の入力と同様に検証され、未知キーは破棄、ツールが拒否する入力は呼び出しも拒否される。
• AWS 上の Claude Platform に /advisor を追加（v2.1.300）。CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 で無効化。
• セキュリティ／サンドボックス修正が多数。サンドボックスからの --plugin-dir 書き込み（サンドボックス外で実行されるコード）、macOS のシンボリックリンク経由での拒否パス読み書き、UTF-16LE BOM ファイルの文字化け・非 UTF-8 の暗黙変換（拒否化）などを修正（v2.1.299）。
• mod（モッド）API を大きく拡充。virtualText・$.ui.view({ agentId })・prompt.change フック・$.prompt.media・$.session.identity() などを追加。
• OpenTelemetry を拡充。api_request にキャッシュ書き込みを寿命別に分ける cache_creation_5m_tokens／cache_creation_1h_tokens を追加、トレーススパンに GenAI セマンティック規約の属性（gen_ai.provider.name 等）を追加。

新機能・変更（changelog）

対象バージョン: v2.1.299 〜 v2.1.300

v2.1.300（2026-10-14）

• 新機能 / 追加:
  • AWS 上の Claude Platform に /advisor を追加（/advisor・advisorModel・--advisor で選ぶまでアドバイザは動かない。CLAUDE_CODE_DISABLE_ADVISOR_TOOL=1 で無効化）。
  • OpenTelemetry api_request イベントにキャッシュ書き込みを寿命別に分ける cache_creation_5m_tokens／cache_creation_1h_tokens を追加。
  • トレーススパンに OpenTelemetry GenAI セマンティック規約属性（gen_ai.provider.name・gen_ai.conversation.id・gen_ai.tool.name・error.type 等）を追加。
• mod（モッド）:
  • プロンプト装飾に virtualText を追加（プロンプト枠内に描画されるがドラフト／送信プロンプトには入らないテキスト）。
  • $.ui.view({ agentId }) を追加（メインビューに特定エージェントのトランスクリプトを表示、$.ui.view({}) で戻る）。
  • Text に右書き用の dir prop を追加（Windows / VSCode ターミナルで行が右詰め・右向きに）。
  • agent.spawn フックで workflow エージェントの prompt／model を書き換え可能に（従来は拒否のみ）。
  • プロンプト枠のテキストがタイプ以外（履歴呼び出し・クリア・undo・プラグインによる自動入力）で変化したときに発火する prompt.change フックを追加。
• 権限 / セキュリティ / フック:
  • PreToolUse / PermissionRequest フックの updatedInput を Claude 自身の入力と同様に検証（未知キー破棄、ツールが拒否する入力は呼び出し拒否）。
  • Cowork クラウドセッションの PermissionRequest フックで、allow 内の setMode 更新を無視（残りの承認は適用）。
  • CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST セッションが settings 内の CA バンドル・ツールプロキシ・git TLS・SSL_CERT_FILE 等の git 設定変数を無視するよう変更（Claude Desktop 下ではプロジェクト設定のみ）。
• 主な修正（抜粋）:
  • MCP ツールの入力スキーマを API が拒否すると会話が毎ターン 400 で失敗する問題を修正（以降そのツールをパラメータ無しで送る）。
  • 終了時、停止要求から 1.5 秒後も残るバックグラウンドコマンドを強制終了するよう変更（fullscreen で残留していた）。
  • headless / Agent SDK セッションの resume で、出力トークン上限で切れた返信後のコンパクションが保持メッセージ／要約を失う問題を複数修正。
  • エージェントフックが model を無視する問題を修正（haiku 等のエイリアス解決、未提供モデルは呼び出し元にフォールバック）。
  • reftable ref ストレージ利用リポジトリでの --worktree 不具合（.invalid ブランチ表示・再オープン失敗・cherry-pick/revert 競合の差分未検出）を複数修正。
  • Claude がセッションスクラッチパッドのファイルをフルパスでなくベース名／相対パスで示す問題を修正。
  • Cowork クラウドセッションの Write/Edit/NotebookEdit が、自分のマシン上のパスに対しファイルが届いていないのに成功と報告する問題を修正。
  • TLS 検査プロキシ（OS 証明書ストア経由でのみ信頼）下で feature flag・段階的ロールアウトが古いままになる問題を修正。
  • 大きな api.anthropic.com リクエストをテレメトリ無効時も gzip 圧縮（CLAUDE_CODE_GZIP_REQUEST_BODIES=0 で無効化）。
  • ローカルトランスクリプトに各 API リクエストの system prompt・tools・パラメータも記録（共有時にリクエストを正確に再現可能に）。
• 削除: claude remote-control の無効だった --sandbox／--no-sandbox フラグを削除（指定するとエラー終了。sandbox.enabled を使う）。
• [VSCode]: エディタ選択テキストを自動でメッセージに入れない claudeCode.attachSelection を追加。常時思考モデルでの Thinking トグル表示抑止、Windows の Shift+ドラッグで /c:/… が入る問題、WSL/SSH/Dev Container でのファイルドラッグ無反応、Ctrl+Alt+F の誤動作、チャットフォントサイズ追従などを修正。
• [Claude Tag]: Slack Connect チャンネル対応（Owner / Claude Tag 管理者が別組織共有チャンネルでの応答を許可、既定オフ）、コネクタ操作の承認用プライベート Allow once / Deny カード、Slack ボイスクリップのトランスクリプト読み取りを追加。
• [Code Review]: GitHub 組織メンバーシップが非公開の write 権限者からの @claude review を無視する問題を修正、「paused for this repository」コメントの案内先を修正。

v2.1.299（2026-10-14）

• 新機能 / 追加:
  • CLAUDE_CODE_DISABLE_FILE_MENTIONS を追加（@ メンションの中身でなくパスを渡し Claude のファイルツールで読ませる）。
  • アイドルコンパクションを追加（ターミナル）。20万トークン超の会話を約54分放置すると1時間プロンプトキャッシュ失効前に圧縮。CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS で閾値変更、"idleCompaction": false で無効化（ともに v2.1.290 以降が必要）。
  • mod（managed settings 導入）向けに $.prompt.media（添付画像/ドキュメントのバイト読み取り）・$.session.identity()（サインイン方式・組織・email）を追加。
  • mod の Text に size／weight／mono／tabular、Box に名前付き spacing（xs〜xl）を追加（bold は weight 推奨で非推奨化）。
  • claude self-hosted-runner orchestrator に --shutdown-drain-sec を追加（SIGTERM 時に進行中ポーリング/spawn フックの猶予秒数）。
  • claude plugin eval に --disallow-tools／disallowed_tools を追加（Agent 等の組み込みツールを eval から除外）。
  • agent view に /effort・/fast を追加（新規セッションの開始設定）、--safe-mode 背景セッションに「safe mode」行、bypass 利用可時のプラン編集に関する一度きり注記、/usage に max effort・workflows・常時コンテキスト・大きなツール結果の警告を追加。
• MCP / 名前衝突:
  • constructor／prototype 名の MCP サーバが接続されない問題、constructor／toString 名サーバのツールが auto/bypass モードで権限を求める問題を修正。
  • deny/ask ルールが __ を含む正規化名の MCP サーバ（mcp__<server>）に効かない問題を修正。
  • MCP 接続（HTTP）が通知応答のボディを閉じないサーバで30秒ハング後に失敗する問題を修正（#99014）。
• セキュリティ / サンドボックス:
  • サンドボックスのシェルコマンドが --plugin-dir フォルダ（Claude Code がサンドボックス外で再読込・実行するコード）に書き込める問題を修正。
  • macOS でシンボリックリンク経由の実体パスにより拒否パスを読み書きできる問題、サンドボックスの denyRead/allowRead glob のブレース/括弧/バックスラッシュ解釈差などを修正。
  • Read が BOM 付き UTF-16LE を文字化けさせる／Write が BOM 脱落や Windows-1252・Shift-JIS・GBK・UTF-16BE の暗黙 UTF-8 変換を起こす問題を修正（後者は拒否）。
  • plan モードが PreToolUse / mod の tool.check で許可された書き込み（MCP/ファイル/シェル）を実行してしまう問題を修正。
  • サードパーティゲートウェイ（ANTHROPIC_BASE_URL）の API キーが feature flag・起動・プロファイル・サーバ管理設定等のリクエストに乗る問題を複数修正（Anthropic API キーは引き続き送信）。
• 主な修正（抜粋）:
  • ゲートウェイ固有モデル名＋カスタム ANTHROPIC_BASE_URL のセッションが20万トークン付近で「Prompt is too long · automatic compaction failed」になる問題を修正。
  • 毎ターン末尾にプロンプトを送る mod が headless 実行を --max-turns／--max-budget-usd／割り込み超過後も走らせ続ける問題を修正。
  • --debug／--debug-file 時のメモリ増加・ディスク/ネットワークマウント書き込み停止時の終了ハング、stderr デバッグ出力時のメモリ無制限増加を修正。
  • rm を実行しないシェル -c スクリプトでの rm プロンプト誤発火を修正（CLAUDE_CODE_STRICT_INLINE_SHELL_RM_PROMPT=1 で厳格化可）。
  • サブエージェント多数実行後のクラウド/Remote Control セッション resume の高メモリ、深くネストしたツール入力/メッセージでプラグインフックがスキップされる問題を修正。
  • /usage・接近警告・status line が100%超を表示する問題（#92238）、CJK/絵文字と Latin 混在の折り返しで最終行欠落・空行が出る問題を修正。
  • 2.1.296 の回帰（クラウド/headless セッションが restart 後 resume 時に承認済みツール呼び出しを二重実行）を修正。
  • スケジュールタスク/ループが毎ターン後に再発火・DST 終了の重複時間帯で早発火する問題、ScheduleWakeup が背景タスク実行中に発火しない問題を修正。
  • Remote Control のプロンプト/ファイル/写真の欠落（バッチ配信失敗・30〜35MiB ファイル未着・保存失敗時の写真欠落）を複数修正。
• 変更 / 改善（抜粋）:
  • プラグインフック/ワークフロースクリプトが28,000階層（ワークフロースクリプトは100,000）超のネスト値を拒否、ブロック対象アクションは引き渡し/返答不能時に「素通し」でなく「拒否」へ変更。
  • WebFetch のページ読取りが web 検索同様の effort 選択（呼び出し元モデルのレベル／small モデルの設定レベル）に変更。
  • MCP 許可ルールを名指しサーバのみに限定（mcp__a は a__b・a_ に不一致）、agent の tools: も名指し MCP サーバのツールのみに。__ を含む名は mcp__<全体>__*。
  • クラウド/Remote Control の MCP コネクタが既定で MCP プロトコル 2026-07-28 をネゴ（MCP_PROTOCOL_NEGOTIATION=legacy でオプトアウト）。
  • Anthropic 一次 MCP サーバのツール説明/サーバ指示を4,096文字で切らず全文到達に変更。
  • 終了時に表示する resume コマンドをセッション名でなく ID 指定へ変更（セッション名由来のコマンド実行を防止）、worktree セッションでは -w/-r を使用。
  • UserPromptSubmit フックをスキル/カスタムスラッシュコマンド展開前に実行（ブロック時は埋め込みシェルコマンドも停止）、turn.start フックがサブエージェント/teammate のターンも受信（e.agentId で判別）。
• [Windows]: プロセス生存チェックが PowerShell を孤児化しメモリ枯渇まで残す問題、Git for Windows 未導入時にシェル未設定フックが fail-open する問題、Git Bash が起動時に PATH 未報告でセッション全体の Bash が「command not found」になる問題を修正。
• [VSCode]: 未送信プロンプト/添付のセッション切替時消失、未使用空チャットの背景プロセス残留、サインアウト時のマイクボタン内部エラーを修正、Python 環境無しワークスペースの起動高速化。
• [Cloud sessions]: 多数の既存出力ファイル再送によるメモリスパイク/クラッシュ、ルーティン保存時の環境無断移動、自己ホスト環境 admin の Sessions 検索不具合を修正。
• [Claude Tag]: Slack の canvas 削除依頼対応を追加、チャンネル指示で応答すべき未タグ投稿への沈黙、別チャンネルスレッドへの未配信を誤って配信済みと報告する問題を修正、誤りの訂正を取り消し線でなく in-place 編集＋「Edited」注記に変更。
• [Code Review]: 月次 spend-limit コメント/チェックカードの案内先を Usage ページへ修正。

使い方メモ（任意）

• アイドルコンパクション（idle compaction）: 20万トークン超の長い会話を放置していると、1時間のプロンプトキャッシュが切れる前に自動圧縮され、再開時の全体再処理（＝高コストな再トークン化）を避けられる。長時間作業を中断しがちな運用ではデフォルト有効が有利。閾値は CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS、無効化は "idleCompaction": false。
• CLAUDE_CODE_DISABLE_FILE_MENTIONS: @ メンションでファイル中身を一括展開せず、パスだけ渡して Claude に必要箇所だけ読ませる。巨大ファイルを @ する運用のコンテキスト節約に有効。
• MCP 許可ルールの厳密化（要注意・破壊的変更）: mcp__a で複数サーバをまとめて許可していた設定は効かなくなる。__ を含むサーバ名は mcp__<正規化名全体>__* と書き直す必要があり、agent の tools: リストも同様に見直すこと。
• 権限フック updatedInput の検証（破壊的変更）: PreToolUse / PermissionRequest フックで入力を書き換える運用では、未知キーが破棄され、ツールが拒否する入力は呼び出し自体が拒否される。ガードフックで入力整形している場合は挙動確認を。