Claude Code 遠端斷線排查：六種斷法的症狀、判據和對應解法

遠端跑 Claude Code，最難受的不是連不上，而是連上了又斷，而且每次斷的原因還不一樣。

「斷線」這個詞其實涵蓋了六種完全不同的故障。它們的現象各有特徵，修法也彼此無關——把切網導致的長連線失效當成機器睡眠去處理，關掉休眠也沒用；把半死連線當成網路差去等，等到天亮它也不會自己好。

這篇文章按你實際看到的現象倒推原因：每種斷法給出症狀、怎麼確認是它、以及對應解法。想直接動手的話，跳到最後一節的排查清單。

這篇只講斷線排查。遠端訪問怎麼搭建見《Claude Code 遠端訪問：關掉本機也能隨地操控會話》，手機端怎麼用見《手機連 Claude Code：iOS 上隨時查看會話與審批工具》。

先對症狀：你看到的是哪一種

遠端連線是兩段：跑 Claude Code 的開發機 ←→ 你手上的查看設備。兩段任何一段出問題都表現為「斷了」，但現象有區別：

你看到的現象	大概率是	跳到
會話突然不動了，重連上去發現進度也停在那一刻	開發機睡眠 / 鎖屏	§1
走進電梯、切 4G、換 WiFi 的那一刻斷	長連線被掐	§2
本機終端一關、或本機一睡，遠端立刻跟著斷	投屏式方案的硬約束	§3
顯示在線，但發訊息石沉大海、沒有任何報錯	半死連線	§4
能重連，但連回去是個空會話 / 斷線期間的訊息沒了	重連沒接回原會話	§5
隔了幾小時再連，會話不見了	進程被回收，且沒有冷恢復	§6

最容易誤判的是第四種：它不報錯。連線狀態是綠的，訊息發得出去，只是永遠沒有回應——比直接斷開更難查，因為所有指示燈都告訴你「一切正常」。

1. 開發機睡眠 / 鎖屏 / 闔蓋

症狀：會話在某個時刻整個停住。重連上去，進度還停在斷的那一刻，一步沒往前走。

為什麼：很多人以為「我開發機一直開著」，但系統休眠、闔蓋睡眠、定時鎖屏都會把 Claude Code 進程掛起或直接殺掉。查看端這邊看到的就是「突然不動了」。

怎麼確認：回到開發機上看那個進程還在不在、系統日誌裡有沒有休眠記錄。如果進程還在但時間戳停在斷線時刻，基本就是它。

解法：把開發機的電源計劃設成「不睡眠 / 闔蓋不休眠」。這是唯一能根治的做法——任何遠端方案都救不了一台已經睡過去的機器。

2. 切網導致長連線被掐

症狀：斷在一個很明確的瞬間——走進電梯、WiFi 切 4G、家裡寬頻半夜重撥。

為什麼：遠端實時同步靠一條長連線（WebSocket / SSH）。IP 一變，這條連線當場失效，沒有任何商量餘地。

怎麼確認：斷線時刻和你的網路切換時刻對得上，就是它。

解法：這一類沒法避免，只能靠自動重連 + 退避兜住（1s→2s→5s…，避免一斷就猛打）。裸 SSH 沒有這個能力，斷了就是斷了，得手動敲。選方案時這是硬指標。

3. 投屏式方案：本機必須前台開著

症狀：本機終端一關、或本機一睡，手機這頭立刻斷。不是慢慢逾時，是同步失效。

為什麼：Anthropic 官方的 Remote Control 是把你本機正在跑的會話投射到手機/瀏覽器。它的前提是本機那個 Claude Code 一直前台開著、本機一直在線。本機一掉，遠端這頭沒有獨立的生命週期可依附。

怎麼確認：關掉本機終端視窗，看遠端是不是同一秒就斷。是的話，你用的就是投屏式方案。

解法：換成開發機側常駐守護服務的架構——跑會話的那一端做成開機自啟的後台服務，獨立於你的查看設備活著。查看端關了、換了、斷了，它都照常在開發機上跑。這是「投屏」和「常駐服務」的本質區別，不是參數能調出來的。

4. 半死連線（half-open）：最難發現的一種

症狀：顯示在線，發訊息沒反應，也不報錯。可能卡幾分鐘，也可能一直卡到你手動重連。

為什麼：網路靜默中斷時（NAT 表項逾時、中間設備狀態遺失、訊號弱到只丟包不斷鏈），TCP 兩端可能都以為自己還連著，實際數據再也過不去。沒有心跳的話，雙方會一直保持這個幻覺。

怎麼確認：連線狀態顯示正常，但發出去的訊息既沒有送達回執也沒有報錯；手動斷開重連之後立刻恢復——那就是它。

解法：連線上要跑心跳（keepalive ping）：約定時間內收不到對端任何回應，就判定這是條半死連線，主動斷開重連，而不是傻等。判據必須是「收不到回應」，不能是「沒有報錯」——半死連線從不報錯。

5. 重連接不回原會話 / 丟訊息

症狀：斷了能重連，但連回去要麼是個空會話，要麼斷線期間對方發的訊息全沒了。

為什麼：重連只是重新建了條連線，沒有把這條連線訂閱回原來的會話；斷線期間的訊息也沒有為你快取。

怎麼確認：重連後會話 ID 變了，或者歷史只從重連那一刻開始。

解法：選能重連後自動訂閱回原會話，並回放斷線期間歷史的方案。只能重連、不能接回，等於白連。

6. 會話進程被回收，且沒有冷恢復

症狀：短時間斷開重連都正常，但隔幾個小時再回來，會話就不見了。

為什麼：長時間空閒的會話進程可能被回收，守護進程本身也可能重啟過（升級、崩潰拉起）。記憶體裡的會話狀態隨之消失。

怎麼確認：斷得久才復現，短斷不復現。

解法：需要冷恢復能力——會話狀態寫入磁碟，進程沒了也能從磁碟把上下文恢復回來。理想情況下你發一條訊息它就自動恢復繼續，對你是無感的。

排查清單（任何方案都能照著走）

按順序過，每一步都能獨立證偽：

1. 跑會話那台機器睡眠 / 鎖屏了嗎？ → 關掉自動睡眠、闔蓋不休眠。（§1）
2. 斷線時刻和你切網的時刻重合嗎？ → 需要帶自動重連 + 退避的方案，別靠裸 SSH。（§2）
3. 本機終端一關，遠端是不是立刻就斷？ → 投屏式方案的硬約束，得換常駐守護架構。（§3）
4. 卡在「顯示在線但發訊息沒反應」？ → 半死連線，只有心跳檢測能自動救回來。（§4）
5. 重連後會話空了 / 訊息少了？ → 需要「接回原會話 + 歷史回放」。（§5）
6. 只有斷很久才丟會話？ → 需要寫入磁碟 + 冷恢復。（§6）

落到具體方案上

上面六條裡，只有第 1 條是你自己機器的設定問題，其餘五條全是架構決定的——方案選型時就定死了，出問題之後調參數救不回來。

一個不斷線的遠端方案需要同時具備：開發機側常駐守護進程（對應 §1 剩餘風險和 §3）、自動重連 + 退避（§2）、心跳檢測（§4）、重連接回原會話 + 歷史回放（§5）、寫入磁碟冷恢復（§6）。

PandaNpc + pandapaw 這套是按這六條逐條對著做的：pandapaw 在開發機上註冊成開機自啟的常駐守護進程（不是你得手動開著的終端視窗，崩了會被自動拉起）；查看端斷線自動重連並帶退避；連線上跑心跳，收不到回應就判半死主動重連；重連後自動訂閱回原會話並回放斷線期間的歷史；會話進程即使被回收，發一條訊息就能從磁碟冷恢復繼續。

具體怎麼裝、怎麼連，見《Claude Code 遠端訪問》；手機端的會話查看與工具審批見《手機連 Claude Code》。

一個附帶的坑：遠端跑別踩計費

排查斷線時容易順手換成 claude -p（headless 模式）跑，但 2026 年 6 月 15 日起 Anthropic 調整了計費——headless 不再走訂閱額度，而是吃一筆小額月度 SDK credit，用完按 API 計費，重度用很容易超支。互動模式（claude REPL）仍然走訂閱額度。換方案排查斷線的時候，注意別順手把計費模式也換了。