実運用課題の修正盛りだくさん:セッションハング自動修復、MCP 接続タイムアウト制御、メモリ警告が地味だが効きそう
Claude Code v2.1.274 リリース:メモリ警告と MCP 接続改善
原題: v2.1.274
重要度の根拠: 実運用で報告されていた複数のセッションハング・タイムアウト問題が修正される、Claude Code ユーザー向け安定性向上リリース
要約
Anthropic が Claude Code v2.1.274 をリリース。メモリ使用が危機的な状態になった際の可視警告機能、MCP(Model Context Protocol)サーバー接続のタイムアウト制御、複数の UI 改善とバグ修正が含まれる。特に、セッションが「unexpected tool_use_id」エラーでハングアップする問題の修正、MCP ツール呼び出しのタイムアウト問題、ホック駆動セッション(Goal 機能など)の文脈オーバーフロー時の動作改善など、実運用で報告されていた問題が複数解決されている。
要点
- メモリ危機警告と安全な再起動ガイダンスを追加
- MCP サーバー接続タイムアウト制御で冗長エラー削減
- セッションハング問題を自動修復で解決
- HTTP MCP サーバー認証エラーを明確化
開発者向け技術解説(API・実装詳細・破壊的変更)を見る
v2.1.274 は Claude Code ツール実行層の堅牢性向上に重点。`CLAUDE_CODE_MCP_STARTUP_WAIT_MS` パラメータで初回非対話ターンの MCP 接続待機時間をバウンド可能に(0=待機なし)。OpenTelemetry トレース span に `effort` 属性を追加し `api_request` と統一。`store.connect_timeout_seconds` で Postgres 接続タイムアウト(デフォルト 5 秒)を延長可能。HTTP+SSE MCP サーバーの 422/4xx エラー時のハンドリング改善、StreamableHTTP ツール呼び出しの 5 分タイムアウトバグ修正。管理設定に `enduser.sub`(IdP subject)追加。セッションハング問題は tool_use_id 不一致の自動修復と `/rewind` ヒント付きエラー表示で解決。
本文の日本語訳(全文)を見る
## 変更内容
- メモリ使用が危機的な状態になった際の可視警告を追加。メモリ解放またはセーフな再起動のステップを表示
- `CLAUDE_CODE_MCP_STARTUP_WAIT_MS` を追加。初回非対話ターンの MCP サーバー接続待機時間をバウンド(0=待機なし)
- `claude_code.llm_request` OpenTelemetry トレース span に `effort` 属性を追加。`api_request` イベントに統一
- `claude_code.managed_settings_resolved` OTel イベント追加:管理設定のソースとポリシーヘルパー状態を送信。`OTEL_LOG_MANAGED_SETTINGS=1` で設定とダイジェストをロギング
- Claude apps gateway 設定に `store.connect_timeout_seconds` を追加。Postgres 接続タイムアウト(デフォルト 5 秒)を延長可能。データベース到達不可時のブート エラーメッセージ改善、`store.postgres_url` と設定タイムアウトを指摘
- Claude Desktop と Cowork が Claude apps gateway 経由で送信するテレメトリに `enduser.sub`(IdP subject)を追加
- レプリカが一度にアップストリームに送信する 256 件を超えるリクエストが開いている場合、Claude apps gateway に警告を追加。起動ログ行にそのリミットを表示
- フルスクリーンモードで折りたたまれたチームメイトとエージェントメッセージ にクリック展開機能を追加
- セッションが 「unexpected tool_use_id」の 400 エラーで無限リトライしてハングアップする問題を修正。破損したトランスクリプトは自動修復され、修復不可の場合は明確なエラー(`/rewind` ヒント付き)でループを終了
- `http` として設定された MCP サーバーで、レガシー HTTP+SSE のみをサポートする場合、初回リクエストで 422 またはその他の 4xx エラーで応答しても接続に失敗する問題を修正
- Streamable HTTP MCP ツール呼び出しが、サーバーごとの長い `timeout` が設定されていても約 5 分後にタイムアウトする問題を修正
- MCP プロンプトとリソースが、サーバーが `listChanged` を宣言せずに list-changed 通知を送信した場合にリフレッシュされない問題を修正
- MCP ツール呼び出しが 403 insufficient_scope で拒否された場合、期限切れのサインインとして報告される問題を修正。エラーは不足しているパーミッションを明記し、`/mcp` 再認証へ指摘するように改善
- ホック駆動セッション(active `/goal` など)が、反応型コンパクション後に文脈が再度オーバーフローしてコンパクトできず「Prompt is too long」で終了する問題を修正
- セッションを再開(`--continue` / `--resume`)した際、コンパクション後に active `/goal` が喪失する問題を修正
- 自動更新による再起動後、`claude agents` コマンドが `--model`、`--effort`、`--permission-mode`、`--allow-dangerously-skip-permissions`、`--agent` を喪失する問題を修正
- 言語サーバーが数千ファイルのプロジェクト全体診断を公開する際のターンごとのスローダウン問題を修正
- Bedrock、Vertex、Foundry 上で `model: "opus"` を持つサブエージェントが、セッションのモデルを喪失する問題を修正(ID にモデルファミリーが認識可能な場合、`ANTHROPIC_DEFAULT_OPUS_MODEL` が設定されていない場合)
- セルフホスト型ランナーセッションが、複数回のトークンリフレッシュ失敗後に毎ターン 401 で失敗し、次のスケジュール済みリフレッシュまで続く問題を修正。ランナーが継続してリトライし、401 後に新しいトークンをフェッチするように改善
- ローカルファイルパスへのクリック可能なリンクが VS Code およびその他の `file://` URI を必要とするターミナルで何もしない問題を修正
- トランスクリプトが自分のメッセージ内の番号付きリストを再番号付けする問題を修正(「3. 2. 1.」と入力したら「3. 4. 5.」と表示される)。数字と「N)」マーカーは入力したとおりに表示される
- AskUserQuestion プレビューノートが、以前選択されたオプションではなく、ハイライトされたオプションに添付される問題を修正
- AskUserQuestion プレビューモードで、Enter でノートを送信する際にハイライトされたオプションが削除される問題を修正
- 再開されたバックグラウンドエージェントが、メッセージで承認された呼び出しの 1 つが中断されたツールバッチの半分を保持する問題を修正
- `CLAUDE_CODE_RESUME_INTERRUPTED_TURN` で開始されたローカル `claude -p --resume` が、前のプロセスが残した未完了のバックグラウンドタスクを報告しない問題を修正
- クラウドセッションの初回ターンが、まだ接続中だった SDK ホスト型 MCP サーバーのツールなしで開始する場合がある問題を修正
- バックグラウンドエージェント通知が、エージェントが独自のバックグラウンドタスク上で待機中でかつ再開される場合に、ライブバックグラウンド作業がないと主張する問題を修正
- Claude デスクトップのエラーヒントを修正
出典: https://github.com/anthropics/claude-code/releases/tag/v2.1.274
媒体: Claude Code Releases
※本記事は Anthropic / Claude 関連の公開情報を基に AI (OpenAI GPT-4o-mini) が日本語で要約・分類した二次的著作物です。著作権法第32条の引用要件に基づき出典 URL を必ず併記しています。要約は AI 生成のため誤訳・誤解釈を含む可能性があります。詳細・正確な情報は必ず出典元の原文をご確認ください。