Claude Code v2.1.311、起動時のフリーズ、長い行の編集、コンテキストオーバーフローによる停止を修正

Claude Code v2.1.311 がリリースされ、セルフホストランナー向けの新フラグ2つと、開発者の実際の課題である起動時のフリーズ、コンテキストのオーバーフロー、大きなファイルの編集に関するバグ修正が多数含まれています。

セルフホストランナー向けの新フラグ

このリリースでは、self-hosted-runner に --hold-idle-file と --max-hold-min が追加されました。これらは、ホストが実行したままにしたプロセスを報告している間、アイドルセッションを維持します。生成されたプロセスがエージェントのターンを超えて存続する場合に便利です。

コンテキストオーバーフローは停止ではなく圧縮に

標準コンテキストのセッションでは、リクエストが200Kトークンを超えると Usage credits required for 1M context で停止していました。v2.1.311 では、Claude Code が会話を圧縮して続行します。長い読み取りや編集でセッションが死ぬことはもうありません。

起動時とファイル編集時のフリーズ

• CLAUDE.md ファイルに非常に長いリスト項目がある場合、起動時やファイルの読み取り/編集後に長時間フリーズする問題。
• 数千行を編集する際、Write と Edit が完了後に最大5秒間停止し、変更行数が0と報告される問題。
• MCPサーバーがリソース読み取りに応答していない、またはスキルがまだダウンロード中の場合、タイムアウトまで割り込みが効かない問題。

サブエージェントとMCPの修正

• サブエージェントは、サブエージェントの開始後に接続が完了したサーバーのMCPツールを使用できるようになりました。
• セッションの前半に編集されたファイルがある場合、自動圧縮直後にClaudeが古いMEMORY.mdとCLAUDE.mdの内容を見ることがなくなりました。
• SubagentStopフックは、実行中のサブエージェントごとに約1分に2回ではなく、終了時に1回だけ発火するようになりました。
• サブエージェントの分離されたワークツリーは、それが開始したバックグラウンドサブエージェントがまだ作業中の場合に削除されなくなりました。

セッションとCLIの修正

• claude -p およびSDKセッションで、トランスクリプトメッセージが順不同で保存されたり、取り下げられたメッセージが保持されたりしなくなりました。
• claude mcp add、claude mcp remove、/mcp は、リポジトリルートより下で実行した場合、現在のフォルダではなく ~/.claude.json のプロジェクトエントリを指定するようになりました。
• claude mcp list と claude mcp get でエラーコードが重複しなくなりました（ENOENT: ENOENT:）。
• claude respawn <id> は、IDに一致するセッションがないと報告する前にバックグラウンドサービスを起動しなくなりました。
• 「バックグラウンドサービスが応答しませんでした」エラーは、無効な claude daemon restart ではなく claude daemon stop --any を提案するようになりました。

クラウドとリモートコントロールの修正

• リモートコントロールセッションは、プロキシが起動リクエストをブロックした場合に「接続中」で約2分間ハングしなくなりました。
• Claudeがクラウドまたはリモートコントロールセッションに送信するメッセージが、モバイルアプリで自分のメッセージとして表示されなくなりました。
• 添付ファイルの保存に失敗した場合（例：ディスク容量不足）や、最初の20個を超える添付ファイルが破棄された場合、Claudeに原因が通知されるようになりました。
• CoworkクラウドセッションのWebFetchとWebSearchは、応答が停滞した場合にハングする代わりに300秒後に失敗するようになりました。
• Coworkクラウドセッションは agent 設定を無視するようになり、コネクタとツールが再起動後も維持されます。

UIとツールの詳細

• @ ファイルピッカーは、gitで無視されたファイルを再包含する .ignore/.rgignore の否定ルールを尊重するようになりました。
• Bashツールの説明で、作業ディレクトリが常に呼び出し間で持続するという主張がなくなりました。
• 環境ブロックで、コマンドが実行されないシェル（例：Bashがzshを使用しているのにfish）が指定されなくなりました。
• エージェントチームセッションで、--resume、--continue、/resume、--session-id の際にタスクリストが再表示されるようになりました（/clear やクラッシュ後も含む）。
• 画像パスを含むテキスト（例：! open /tmp/shot.png）を貼り付けても、画像が添付されてプロンプトからパスが削除されなくなりました。

Claude Codeを日常的に使用している場合、このリリースは導入する価値があります。特に200Kトークンでの停止や、大きなファイルでのWrite/Editの停止に遭遇したことがあるならなおさらです。