対象読者
Claude Codeを業務・自動化に使っている方を対象とする。特にMCPサーバーを使った環境、無人バッチ・ヘッドレス実行、エンタープライズのガバナンス要件がある環境を想定している。個人開発でも深夜に自動実行を走らせている方には、MCPまわりの修正が直接関係する。
出典：GitHub リリースノート（https://github.com/anthropics/claude-code/releases/tag/v2.1.307 ）。公開は2026-10-21 22:17 JSTだった。
この記事で分かること
v2.1.307では、安全イベントのOpenTelemetryログ追加・HTTP MCPの二重送信修正・スリープ時のMCPタイムアウト修正が主な変更。合計30件以上の変更が含まれている。
新機能は2件、修正は20件超、改善は6件、VSCodeとCloudセッション向けに各数件ある。新機能・修正の半分はMCPサーバーとクラウドセッションに関係する。以下、実務への影響が大きいと思った順に整理する。
追加された2つの機能
今回の「Added」は2件だ。
1つ目は /claude-api api-version コマンドの追加だ。Claude APIを使ったコードを APIバージョン 2026-10-21 に移行するためのコマンドで、コード内のAPIバージョン指定を書き換えてくれる。Claude APIを直接呼び出すコードを持っている場合、このコマンドで一括移行できる。当方では claude -p 経由の無人実行が中心だが、APIバージョンを明示しているコードがあれば今後活用できる。
2つ目が claude_code.safety_event OpenTelemetryイベントの追加だ。ツール呼び出しのたびに、権限ルール・autoモード・安全チェック・フック・サンドボックスのいずれかによって「止まった」「問い合わせた」「差し戻した」という事象が発生した場合に、このイベントが出るようになった。OTLPパイプライン（DatadogやGrafanaなど）と繋いでいる環境なら、これだけで「いつ・どのツール呼び出しが止まったか」の監査ログが取れるようになる。大企業でAIエージェントを動かすとき、何が起きているか見えにくいという問題がある。このイベントはその一端を解決するものだ。当方では現時点でOTLPエンドポイントが設定されているか確認できていない。恩恵を受けるには、まずOTLPの設定から始める必要がある。
MCP信頼性まわりの修正（実務への影響大）
今回のリリースで最も実用的だと感じた修正群だ。
HTTP MCPツール呼び出しの二重送信問題が修正された。 接続が途中で切れたとき、HTTPのMCPツール呼び出しが2回送信されていた。修正後は、読み取り専用または冪等なツールだけがリトライされるようになった。書き込み操作（ファイルの作成・DBへの挿入・外部APIへのPOST）を行うHTTP MCPツールを使っていた場合、接続断のタイミングによっては2回実行されていた可能性がある。当方では現在HTTP MCP経由の書き込みを使っていないが、外部APIをHTTP MCPで繋ぐ予定がある場合は要注意だ。この修正は地味だが、副作用のある操作を持つHTTP MCPサーバーを運用している人には重要な変更だと思う。
MCPサーバーがスリープ時にタイムアウトする問題が修正された。 macOSまたはLinuxのコンピュータがスリープに入ったとき、MCPサーバーが「接続中」のままタイムアウトとして報告され、ヘッドレス実行で失敗状態のまま残るという問題が直った。当方はWSL2上でLinuxの環境を動かしており、Windowsホストがスリープするタイミングによっては同じ問題が起きていた可能性がある。確認できていないが、タスクスケジューラで深夜に実行しているバッチが止まっていたケースがこれだったかもしれない。ヘッドレス実行をしている環境では特に影響が大きい修正だ。
macOSでのMCPサーバー認証表示が改善された。 macOSのログインキーチェーンがロックされているとき claude -p でMCPサーバーが「認証が必要です」とだけ表示されていた問題が修正された。修正後は、なぜ認証が必要かが表示され、次回の実行時にロック解除後は再サインインなしで接続される。これはmacOS環境のみに関係するが、CI環境で発生していた可能性がある。
バックグラウンドタスク実行中にSDK MCPサーバーの最新ツールが反映されないことがあった問題が修正された。 バックグラウンドタスクが動いているとき、ターンが始まる際にSDK MCPサーバーの最新ツール一覧が使われないことがあった。ツール一覧が変わりうる環境や、並列処理を組んでいる環境で影響があったと思われる。
コンテキスト・セッション管理まわりの修正
autocompactのスラッシングエラーが修正された。 PDFのページ・画像など、大きなツール結果を多く読み込むターンで「Autocompact is thrashing」エラーが出ることがあった。PDFを使ったドキュメント処理を自動化している場合に関係する。当方でも長いMarkdownファイルを処理するときに似た動作が出ることがあり、この修正は嬉しい。
/autocompact の設定がクラウドセッション再起動後にリセットされる問題が修正された。 クラウドセッションで /autocompact を設定しても、再起動後にデフォルト設定に戻ってしまっていた。クラウドセッションを使っている場合に影響がある。
/clear した会話がセッション再起動時に戻ってくることがあった問題が修正された。 クラウドまたはセルフホストランナーのセッション再起動時に、/clear でクリアしたはずの会話が戻ってくることがあった。データの分離という観点から見ると問題があるため、重要な修正だ。特に複数の作業を分けて管理している場合に影響があっただろう。
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS が Claude apps ゲートウェイセッションで無視されていた問題が修正された。 タイムアウト設定を環境変数で調整しているユーザーに関係する。カスタムゲートウェイ経由で使っている環境では、この設定が効いていなかったことになる。
権限・UI・その他の修正
/permissions > Recently denied の表示とautoモードの処理が修正された。 否定されたシェルコマンドがRecently deniedに表示されていなかった問題と、autoモードのローカル分類器が再試行されたコマンドを確認するときに、その場で行った承認を無視していた問題が直った。修正後は、承認時に説明文ではなくコマンド自体の名前が表示されるようになった。これはセキュリティ的に重要な動作の修正だ。
setModel() を使ったモデル切り替えがAPIの応答に5秒以上かかると拒否されていた問題が修正された。 修正後は最大15秒待つようになった。Agent SDKで動的にモデルを切り替えるアプリケーションを作っている場合に関係する。ネットワーク遅延がある環境では発生しやすかったと思われる。
WebFetchがCoworkクラウドセッションで4xxステータスやrobots.txt拒否を受けたときにツールエラーを報告していた問題が修正された。 ローカルセッションと同じように通常の結果として扱われるようになった。Coworkセッションでリサーチを行う場合に影響がある。
GitHub MCPサーバーを直接設定した場合、書き込みツールで何も作成されずフォームが閉じてしまう問題が修正された。 デスクトップアプリのCodeタブで発生していた問題だ。GitHub MCPサーバーを使ってPR作成などを自動化している場合に影響があった。
改善（Improved）
ツール呼び出しのパース失敗からの回復が改善された。 解析できないツール呼び出しがあったとき、エラーで終了する前に最大2回リトライするようになった。偶発的な失敗への耐性が上がり、長い自動処理が途中で止まりにくくなる。当方の無人実行でも偶発的なパースエラーが出ることがあり、この改善は実用的だ。
fork subagentsの識別が改善された。 同時に起動したfork subagentsが「自分のlaunchはどれか」を認識できるようになった。以前は互いの仕事を始めようとすることがあった。複数のサブエージェントを並列起動するフローを組んでいる場合に恩恵がある。
ブラウザサインインの改善が行われた。 サインイン成功後すぐに成功ページが表示されるようになった。以前はアカウントプロファイルが読み込まれるまで待っていたため、成功しているのか処理中なのか分かりにくかった。
クラウドセッションでのWebSearchエラー表示が改善された。 理由つきの403拒否を受けたとき、汎用の「Authentication error」ではなく実際の理由が表示されるようになった。エラーの原因が分かりやすくなる。
VSCode向けの変更
音声ディクテーションが自動停止したとき（無音15秒・2分の上限）に、マイクボタン上に理由と「入力済みのテキストは保持されています」という通知が出るようになった。どこで止まったか分からなかった状態が改善された。
長いプロンプトを展開した場合に「Show more」でチャットパネル全体を覆っていた問題が修正された。最大40%のサイズに制限され、スクロール可能になった。
LaTeX数式を含むリスト項目やテーブルセルをリッチテキストエディタに貼り付けると、新しいリストや表として扱われていた問題が修正された。数式を多用するユーザーには重要な修正だ。
NODE_EXTRA_CA_CERTS が ~/.claude/settings.json にのみ設定されているとき、TLS検査プロキシの背後での音声ディクテーションが失敗していた問題が修正された。企業のTLSインスペクションがある環境での音声入力が動くようになる。
Cloud sessions・Self-hosted runner向けの変更
クラウドセッションのリポジトリピッカーで、検索中に「No repositories match」と表示されていた問題が修正された。「Searching…」に変わり、処理中かどうかが分かるようになった。
セルフホストランナーの「Waiting for a runner」ステータスが、最後のメッセージからのカウントアップと失敗試行数を表示するようになった。待機中に何が起きているか見えるようになる。
Code Reviewに @claude review stop（off・pause も可）が追加され、プルリクエストでの @claude review always サブスクリプションを終了できるようになった。
セルフホストランナー向けに、チェックアウトフックがデフォルトで30分後に停止するようになった（--checkout-hook-timeout-min で変更可能。0 を指定すると無制限）。以前は長時間実行するフックがランナーのスロットを占有し続けることがあった。
大企業・無人バッチを運用する立場から
大企業でCopilot Studio・Power Automate・Dify Enterpriseを使いながら、個人でもClaude Codeを使ったAI自動化を動かしている。両方の立場で今回のリリースを見ると、実務に効いてきそうな変更が3点ある。
1点目は claude_code.safety_event の追加だ。企業のガバナンス要件として「AIがどんなツール操作をしたか」の記録が求められる場面が増えている。このイベントをOTLPで受け取れるなら、既存の監視基盤と繋いで監査ログを自動取得できる。当方では設定がまだ整っていないため恩恵を受けられていない。OTLPパイプラインを持っている組織には価値が高い変更だ。
2点目はHTTP MCPの二重送信修正だ。書き込み系の操作が2回実行される可能性があったということは、外部サービスへのPOSTや副作用のある処理を自動化していた場合に問題が起きていた可能性がある。v2.1.307以前のバージョンでHTTP MCP経由の書き込みを運用していた場合は、ログを確認する価値がある。
3点目はスリープ時のMCPタイムアウト修正だ。深夜のバッチ実行をタスクスケジューラで組んでいる場合、ホストのスリープと実行タイミングが重なると失敗していた可能性がある。この修正でヘッドレス実行の安定性が上がることが期待できる。
全体として、v2.1.307は新機能よりも「動作の信頼性向上」が中心のリリースだと感じた。特にMCPの接続まわりとセッションのデータ分離は、無人実行を安定させるために重要な修正だ。
今回分かったこと
-
claude_code.safety_eventOpenTelemetryイベントが追加された。OTLPパイプラインがあれば、どのツール呼び出しが止まったかの監査ログが取れるようになる - HTTP MCPツール呼び出しが接続断で2回送信されていた問題が直った。書き込み系の操作を持つHTTP MCPサーバーを使っていた場合は、過去のログを確認する価値がある
- MCPサーバーがスリープ時にタイムアウトする問題が修正された。深夜のヘッドレス実行で影響していた可能性がある
- fork subagentsが自分のlaunchを認識できるようになった。並列エージェントフローの信頼性が上がる
- VSCode・クラウドセッション・セルフホストランナー向けの修正も多く、合計30件以上の変更が含まれている
出典：Claude Code v2.1.307 リリースノート（https://github.com/anthropics/claude-code/releases/tag/v2.1.307 、2026-10-21）
関連記事