結論先說
- 防斷線的根本辦法是把
claude跑在遠端tmux會話裏:普通 SSH 窗口一旦網絡斷開,系統會向子進程發送掛斷信號終止任務;套一層tmux後,前端斷網完全不影響伺服器後台繼續讀寫和跑測試。 - 記住一條萬能命令
tmux new -A -s cc:會話不存在就新建,已存在就直接無縫接回剛才停下的實時介面。 - 萬一裸跑時已經斷網,重連後先查
git status再執行claude --continue:Claude Code 每輪都會在遠端磁盤落盤對話歷史,恢復後讓它先核對剛才中斷那一刻的文件狀態即可接着做。 - 長任務啟動前先敲
/status確認登入未臨近過期:官方說明若 OAuth 令牌在無人值守期間徹底過期且無法刷新,後台會話會停下等待重新執行/login。 - 長時無人值守重構對配額消耗較大:避免任務跑到一半撞上 5 小時限額停工,國內開發者可通過本站 Claude Code 訂閱專區 或 Claude Max 訂閱服務 免外幣卡升級配額。

圖:本站根據 Claude Code 官方文檔:Common workflows 與遠程終端實踐整理的示意圖
本文根據 Claude Code 官方文檔《Common workflows》《CLI reference》《Authentication》及 Linuxtmux終端複用規範整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 登入雲端 GPU 開發機或公司內網 Linux 伺服器運行 Claude Code,經常因筆記本休眠、切換網絡出現
Broken pipe斷線的開發者; - 派發了耗時十幾分鐘的跨模組重構或全量測試任務,希望關掉本地電腦下班後遠端智能體繼續跑完的人;
- 剛才沒開保活工具直接斷網了,重連伺服器後不知道該怎麼接回剛才那輪對話和半截代碼改動的用戶。
一、標準防斷方案:3 條命令用 tmux 託管 Claude Code
如何首次連上遠程主機並在無瀏覽器環境下完成複製授權碼登入,可先看 Claude Code 怎麼連接遠程伺服器(SSH)。登入遠端伺服器並進入項目目錄後,養成「先進 tmux 再起 claude」的習慣:
bash
# 1. 若伺服器未裝 tmux 先安裝(Ubuntu/Debian 示例)
sudo apt-get update && sudo apt-get install -y tmux
# 2. 創建或自動重連名為 cc 的持久會話(-A 參數最省心)
tmux new -A -s cc
# 3. 在 tmux 內部正常啟動 Claude Code
claude
進入後的日常高頻操作只有三個動作:
- 主動掛起離開(不中斷任務):先按組合鍵
Ctrl+B,鬆開後再按字母D(Detach),即可退回普通 Shell 甚至直接關掉筆記本; - 斷網後重連恢復現場:重新
ssh登上伺服器,再敲同一句tmux new -A -s cc,螢幕立刻回到中斷前的滾動位置; - 解決
tmux裏滑鼠滾輪不能翻看長輸出的問題:在伺服器~/.tmux.conf中寫入下面兩行並執行tmux source ~/.tmux.conf,就能正常用滑鼠滾輪翻看 Claude 的代碼對比:
text
set -g mouse on
set -g history-limit 50000
二、客戶端雙保險:配置本地 SSH 心跳防空閒踢出
有些公司堡壘機或家用路由器在終端幾分鐘沒有鍵盤輸入時(比如 Claude 正在深度思考或跑慢速編譯),會主動掐斷空閒 TCP 連接。在本機電腦的 ~/.ssh/config(Windows 為 %USERPROFILE%\.ssh\config)裏加上心跳保活參數,可大幅減少閃斷次數:
sshconfig
Host my-dev-server
HostName 192.0.2.10
User ubuntu
ServerAliveInterval 30
ServerAliveCountMax 6
這表示每 30 秒由客戶端發一次輕量心跳包,連續 6 次無響應(約 3 分鐘)才判定斷線,足夠撐過短暫的 Wi-Fi 切換。
訂閱與帳號準備提示:在遠端伺服器掛機跑大規模重構、編譯修復或自動化測試套件時,Pro 檔位較容易在半途觸及窗口上限而暫停。若沒有境外信用卡升級套餐,可在本站選購 Claude Pro iOS 免上號自助卡密(無需交出帳號密碼),重度遠程開發推薦直上 Claude Max 訂閱服務。
三、沒開 tmux 已經斷網了:安全搶救與恢復流程

圖:本站根據 Claude Code 官方文檔:CLI reference 會話恢復機制整理的示意圖
如果剛才忘了開 tmux 就直接斷線了,切忌一重連就盲目重新發一遍長提示詞。按官方歷史記錄機制(詳見 Claude Code 怎麼看歷史對話、恢復之前的會話),會話文件儲存在遠端機器的 ~/.claude/projects/ 下,按下面四步搶救最穩妥:
- 檢查是否有殘留殭屍進程:跑
ps aux | grep claude看舊進程是否已退出; - 檢查磁盤半截改動:跑
git status和git diff,確認斷網瞬間有沒有寫到一半的碎文件或殘留鎖文件; - 接回剛才那輪對話:在原項目目錄運行
claude --continue(直接續接最近一次對話)或claude --resume(從列表裏選指定會話); - 讓模型先核對現場再繼續:恢復後發一句「剛才 SSH 斷線中斷了,請先運行
git status和git diff核對上一步改到了哪裏,確認無誤後繼續剩餘步驟」。
如果你出門在外想用手機看一眼遠端進度,也可了解官方移動入口方案:Claude Code 手機端、安卓版怎麼用。
常見問題
問:在 tmux 裏選中複製 Claude 生成的代碼怎麼總把邊框字符一起復制下來?
答:開啟 set -g mouse on 後,按住鍵盤上的 Shift 鍵(macOS iTerm2 按住 Option 鍵)再用滑鼠拖選,即可繞過 tmux 捕獲走終端原生複製,或者讓 Claude 直接把內容寫進文件再複製。
問:macOS 當作遠程伺服器被 SSH 登入時,報 Keychain 鎖定寫不進憑據怎麼辦?
答:官方認證文檔說明,macOS 在 SSH 會話裏若系統鑰匙串處於鎖定狀態拒絕寫入,Claude Code 會回退使用 ~/.claude/.credentials.json 存儲憑據;若遇到報錯,也可執行 claude auth login 按提示粘貼授權碼完成登入。
問:一個項目目錄裏能開兩個 tmux 窗口同時跑兩個 claude 改代碼嗎?
答:不要在同一個工作目錄同時讓兩個會話改代碼,兩邊會互相覆蓋文件。確需並行處理兩個需求時,用 claude --worktree 各自切出獨立的 Git Worktree 目錄再跑。
問:國內沒有外幣卡,或者團隊採購 Claude Code 需要報銷開增值稅發票怎麼辦理?
答:可通過本站 AI 會員充值總覽 或 Claude Code 訂閱頁 辦理,支持支付寶、微信支付及 AlipayHK,提供免交密碼的自助卡密兌換與團隊方案,並支持開具國內報銷用的增值稅發票。實時價格以頁面展示為準;訂閱期內若掉訂閱按剩餘天數折退,因違反官方條款導致的封號不在質保範圍內。
相關教學
- Claude Code 怎麼連接遠程伺服器(SSH):桌面版加 SSH 環境,或登入伺服器後在終端裏直接用
- Claude Code 怎麼看歷史對話、恢復之前的會話:--continue、--resume 與 /resume
- Claude Code 手機端、安卓版怎麼用:沒有獨立 App,用 Claude App 的 Code 標籤接雲端會話或 Remote Control
參考資料
- Claude Code 官方文檔:Common workflows — https://code.claude.com/docs/en/common-workflows
- Claude Code 官方文檔:CLI reference — https://code.claude.com/docs/en/cli-reference
- Claude Code 官方文檔:Authentication — https://code.claude.com/docs/en/authentication
0 條評論
還沒有評論,來搶沙發~