Claude Code ガイド

Appearance

ブリッジセッションのWebSocket切断後のリカバリ修正 ​

原文（日本語に翻訳） ​

長時間のWebSocket切断後にブリッジセッションが回復に失敗する問題を修正

原文（英語） ​

Fixed bridge sessions failing to recover after extended WebSocket disconnects

概要 ​

Claude Code v2.1.76で、ブリッジセッション（ローカル環境とclaude.ai/codeやモバイルアプリを接続するセッション）が長時間のWebSocket切断後に正常に回復できないバグが修正されました。ネットワーク障害、ノートPCのスリープ、Wi-Fiの切り替えなどで接続が一時的に途切れた場合、以前のバージョンではセッションの再接続に失敗し、手動での再起動が必要でした。この修正により、接続が回復した際に自動的にセッションが再確立されるようになりました。

基本的な使い方 ​

この修正は自動的に適用されます。v2.1.76にアップデートするだけで恩恵を受けられます。

bash
# Claude Codeを最新版にアップデート
claude update

ブリッジセッションを使用する場面：

bash
# Remote Controlでブリッジセッションを開始
claude remote-control --name "開発作業"

# claude.ai/codeやClaudeアプリから接続
# ネットワーク切断が発生しても自動リカバリ

実践例 ​

ノートPCスリープからの復帰 ​

外出先でノートPCを閉じてスリープ状態にし、後で再開する場合：

bash
# 自宅でRemote Controlセッションを開始
claude remote-control --name "フロントエンド開発"

# claude.ai/codeから接続して作業中...
# ノートPCを閉じてスリープ（WebSocket切断）

# 後でノートPCを開く
# → v2.1.75以前：ブリッジセッションが復旧せず、再起動が必要
# → v2.1.76：自動的にWebSocket接続が再確立され、作業を継続できる

Wi-Fiネットワークの切り替え ​

オフィスやカフェでWi-Fiネットワークを切り替える場合：

bash
# Remote Controlセッションを実行中
claude --remote-control "API開発"

# オフィスWi-Fiからカフェのフリーwi-Fiに移動
# ネットワーク切り替え中にWebSocket切断が発生

# 新しいネットワークに接続後
# → v2.1.76：ブリッジセッションが自動的にリカバリ
# → スマートフォンのClaudeアプリからも引き続き操作可能

不安定なネットワーク環境での作業 ​

テザリングやVPNなど、接続が不安定な環境での長時間作業：

bash
# VPN接続環境でRemote Controlを起動
claude remote-control --name "本番デバッグ"

# VPN接続が一時的に途切れる場合
# → v2.1.75以前：数分の切断でセッションが復旧不能に
# → v2.1.76：接続が戻れば自動的にセッションを再確立

# 別デバイスのClaudeアプリから状態を確認しながら作業を継続

注意点 ​

  • タイムアウトの上限: ネットワーク切断が約10分以上続くとセッション自体がタイムアウトします。この動作は変わっていません
  • 自動リカバリの範囲: WebSocket接続の再確立は自動ですが、タイムアウト後は claude remote-control を再実行する必要があります
  • 進行中のタスク: 切断中にClaudeが処理を行っていた場合、再接続後に結果を確認できます。ただし、切断中に新しい指示を送ることはできません
  • ブリッジセッション vs Remote Control: ブリッジセッションは、Remote Control機能の基盤となるWebSocket接続を指します。この修正はRemote Controlを利用するすべてのユーザーに影響します

関連情報 ​