Claude Code v2.1.307:安全性テレメトリイベント、APIバージョン移行、そして多数のMCPとセッションの修正
Claude Code v2.1.307は、ルール・autoモード・hook・sandboxが介入したツール呼び出しごとに発火する claude_code.safety_event OpenTelemetryイベントと /claude-api api-version を追加し、HTTP MCPツール呼び出しの二重送信、キーチェーンロック時のMCP認証、大きなツール結果によるautocompactの繰り返しなどを修正します。
Claude Code v2.1.307の変更履歴は43項目で、修正24件、改善6件、挙動変更5件、追加4件です。MCPの信頼性、クラウドおよびセルフホストrunnerセッション、VS Code拡張に集中しています。Claude Codeを無人で実行している場合や、gateway経由で使っている場合は、更新する価値のあるバージョンです。
新機能
安全性テレメトリイベント。 新しい claude_code.safety_event OpenTelemetryイベントは、permission rule、autoモード、safety check、hook、sandboxが停止・確認・差し戻しを行ったツール呼び出しごとに発火します。すでにClaude CodeからOpenTelemetryをエクスポートしているなら、こうした介入はセッション内に現れるだけでなく、それぞれが個別のイベントとして届くようになります。
/claude-api api-version。 バンドルされた /claude-api skillに、Claude APIのコードをAPIバージョン 2026-10-21 へ移行するサブコマンドが追加されました。migrate、upgrade、managed-agents-onboard、prompt-audit、cost-optimize などと並ぶ位置づけです。
MCPの信頼性
MCPに関わる項目は6件で、修正が5件、レイテンシの改善が1件です。
- 二重呼び出しがなくなりました。 呼び出しの途中で接続が閉じると、HTTP MCPツール呼び出しが2回送られることがありました。現在は読み取り専用または冪等なツールのみ再試行されます。
- macOSのキーチェーンロックがサーバー障害に見えなくなりました。 ログインキーチェーンがロックされている間、
claude -pでMCPサーバーが「needs authentication」と表示されていました。現在は理由が示され、アンロック後の次回実行では再サインインなしで接続します。 - スリープでサーバーが恒久的に失敗しなくなりました。 接続中にmacOSやLinuxのマシンがスリープすると、サーバーはタイムアウトと報告され、headless実行では失敗のままでした。
- バックグラウンドタスクの実行中でも、ターンがSDK MCPサーバーの最新ツールなしで始まらなくなりました。
- 直接設定したGitHub MCPサーバーのwrite tools が、デスクトップアプリのCodeタブでフォームを表示したまま、何も作成せずに閉じていました。
- クラウドセッションの初回応答が速くなりました。デスクトップアプリのMCPサーバーの1つが接続できない場合です。これは修正ではなく改善です。
セッションとcontextの修正
- 多数のPDFページ、画像、その他の大きなツール結果を読むターンでの autocompactの繰り返し。
- クラウドセッションの
/autocompactが再起動後にデフォルトのウィンドウへ戻る問題。 /clearで消した会話が、クラウドやセルフホストrunnerのセッション再起動後に戻ってくることがある問題。CLAUDE_CODE_DISABLE_1M_CONTEXTが設定され、モデルがopus[1m]のように[1m]接尾辞を持つエイリアスの場合に、リクエストがmodel-not-foundで失敗する問題。- 解析できないツール呼び出しは、エラーでターンを終える前に最大2回再試行されるようになりました。
- 同時に起動したfork subagent は、どの起動が自分のものかを伝えられるようになり、互いの作業を始めてしまう可能性が大きく下がりました。
権限とgateway
/permissionsの Recently denied が拒否されたシェルコマンドを表示せず、autoモードのローカル分類器が再試行コマンドの再チェック時にそこでの承認を無視していました。現在は、行を承認するとその説明ではなくコマンド自体が示されます。prompt-caching-scopebetaヘッダーは、効果のないカスタムANTHROPIC_BASE_URLgateway やFoundryへは送られなくなりました。CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSがClaude apps gatewayセッションで無視されていました。- Claude apps gateway経由のデスクトップアプリセッションのテレメトリが、
OTEL_EXPORTER_OTLP_HEADERS設定時に拒否されていました。
注意すべき挙動の変更
axScreenReaderと設定のenvブロック内のCLAUDE_AX_SCREEN_READERは、user、managed、--settingsの設定からのみ適用されます。これはv2.1.305以降の挙動で、今回明文化されました。- セルフホストrunnerのcheckout hook は既定で30分後に停止され、そのセッションのセットアップは失敗します。より長く必要な場合は
--checkout-hook-timeout-minを上げるか0に設定してください。 - WebSearchの予算切れ通知は、ブラウザやcomputer useで検索エンジンに問い合わせないようにも伝えるようになりました。
セルフホストrunnerとCode Review
--use-anthropic-git-proxyを使うセッションが、以前のセッションがcloneに残した.claude/settings.local.jsonをコミットしなくなりました。- checkout hookの実行中にセッションを archive / requeue したり runner を停止したりしても、hookのプロセスが動き続けてrunnerの枠を占有することがなくなりました。
- Anthropic管理のgit用に作られる証明書ファイルは、CLIと同じように信頼済み証明書をフィルタし、除外された数を
[runner:warn]の行で報告します。 - Code Reviewに
@claude review stop(offとpauseも可)が追加され、新しいレビューを開始せずにpull request上の@claude review alwaysの購読を終了できます。
VS Code
- Show more で展開した長いプロンプトは、チャットパネル全体を覆わず、パネルの40%を上限にスクロールするようになりました。
- 音声ディクテーションが自動停止したとき(15秒間音声が認識されない、または2分の上限)に通知が出て、理由とそれまでのテキストが保持されることを伝えます。
- ディクテーションと拡張自身のリクエストが、
CLAUDE_CODE_CERT_STOREおよび環境またはユーザー設定で指定されたNODE_EXTRA_CA_CERTSファイルに従うようになり、TLS検査プロキシ下でのディクテーション失敗が修正されました。 - LaTeX数式を含むリスト項目や表セルの一部を貼り付けたときに、リッチテキストエディタで新しいリストや表が作られなくなりました。
コマンド面は変わっていません
変更履歴は長いものの、取得されたCLI面はv2.1.306から変わっていません。64コマンド、327フラグ、249設定キー、391環境変数名です。新しい api-version アクションは既存の /claude-api skillコマンドの中にあります。本サイトの CLIリファレンス もそれを反映しています。
アップデート方法
- インストール済みのバージョンを確認:
claude --version - その場でアップデート:
claude update