Claude Code v2.1.307：/claude-apiのバージョン管理、安全イベントテレメトリ、MCPの信頼性修正

Claude Code v2.1.307には、開発者向けの2つの追加機能—Claude APIコードのAPIバージョン固定と、ツール呼び出しごとの安全テレメトリ—に加え、MCP、ランナー、セッション状態に関する多数の修正が含まれています。

新機能：APIバージョン固定と安全イベントテレメトリ

• /claude-api api-versionは、Claude APIコードをAPIバージョン2026-10-21に移行します。生成されたAPI呼び出しを、モデルのデフォルトではなく特定の日付バージョンにターゲットする必要がある場合に便利です。
• 新しいOpenTelemetryイベントclaude_code.safety_eventは、許可ルール、自動モード、安全チェック、フック、またはサンドボックスによって停止、プロンプト、または送り返された各ツール呼び出しに対して発火します。これにより、エージェントループ内のすべての介入の構造化された記録が得られ、トランスクリプトから推測する必要がなくなります。

主な修正

• 1Mコンテキストエイリアス：CLAUDE_CODE_DISABLE_1M_CONTEXTが設定され、モデルが[1m]サフィックス付きのエイリアス（例：opus[1m]）の場合、リクエストがモデル未検出で失敗しなくなりました。
• プロンプトキャッシュ：prompt-caching-scopeベータヘッダーは、効果のなかったカスタムANTHROPIC_BASE_URLゲートウェイやFoundryでは送信されなくなりました。
• macOSでのMCP認証：ログインキーチェーンがロックされている場合、claude -pは「認証が必要」と報告しなくなり、理由を表示します。ロック解除後の次回実行では、再サインインなしで接続します。
• MCPスリープ/タイムアウト：macOSまたはLinuxマシンがスリープ中に接続中だったサーバーが、ヘッドレス実行でタイムアウトおよび失敗として報告されなくなりました。
• HTTP MCPの二重呼び出し：呼び出し中に接続が閉じた場合、ツール呼び出しが二重に送信されなくなりました。再試行されるのは読み取り専用または冪等なツールのみです。
• SDK MCPツール：バックグラウンドタスクの実行中に、SDK MCPサーバーの最新ツールなしでターンが開始されなくなりました。
• Autocompact：多くのPDFページ、画像、または大きなツール結果を読み取るターンでの「Autocompact is thrashing」エラーが減少しました。クラウドセッションの/autocompactも再起動間でウィンドウを維持します。
• /clearの永続性：/clearでクリアされた会話が、クラウドまたはセルフホストランナーセッションの再起動後に再表示されなくなりました。
• Agent SDK setModel()：APIの確認に5秒以上かかる場合でもモデル切り替えが拒否されなくなりました。Claude Codeは最大15秒待機します。
• 権限UI：/permissions > Recently deniedに拒否されたシェルコマンドが表示され、行を承認すると説明ではなくコマンド名が表示されます。自動モードのローカル分類器は、再試行されたコマンドでその承認を尊重するようになりました。
• GitHub MCP書き込みツール：サーバーが直接設定されている場合、デスクトップアプリのCodeタブで何も作成せずに閉じるフォームを修正しました。

その他の改善

• 解析できないツール呼び出しは、ターンがエラーで終了する前に最大2回再試行されます。
• 一緒に起動されたフォークサブエージェントには、それぞれどの起動が自分自身のものかが通知され、クロススタート作業が減少します。
• ブラウザサインインは、アカウントプロファイルを待たずに、サインイン完了と同時に成功ページを表示します。
• クラウドおよびセルフホストランナーセッションでのWeb検索403エラーは、一般的な「認証エラー」ではなくサーバーの理由を表示するようになりました。
• 大きな貼り付け画像やPDF読み取りがあるセッションで、Remote Controlの接続時間が改善されました。
• WebSearchの予算枯渇通知は、ブラウザやコンピュータ使用を介して検索エンジンにクエリを送信しないようにClaudeに指示するようになりました。

セルフホストランナーユーザーには2つの特定の修正があります：--use-anthropic-git-proxyセッションは、以前のセッションによってクローンに残された.claude/settings.local.jsonをコミットしなくなりました。また、チェックアウトフック中にセッションをアーカイブまたは再キューイングしても、フックプロセスが実行されたままランナーのスロットが保持されなくなりました。