Claude Code 跑遠程 SSH 斷網後會話中斷怎麼辦:搭配 tmux 保活長時重構任務與重連恢復指南

在遠程 Linux 伺服器跑 Claude Code 長任務時,筆記本合蓋或 Wi-Fi 閃斷會導致 SSH 斷開並殺掉進程。本文整理 tmux 持久會話保活、SSH 心跳防斷、滑鼠滾輪開啟,以及裸跑斷線後用 --resume 安全恢復的步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
10 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Pro 帳號

結論先說

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

SSH 遠程運行 Claude Code 搭配 tmux 保活與重連四步法

圖:本站根據 Claude Code 官方文檔:Common workflows 與遠程終端實踐整理的示意圖

本文根據 Claude Code 官方文檔《Common workflows》《CLI reference》《Authentication》及 Linux tmux 終端複用規範整理,資料核對於 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 已經斷網了:安全搶救與恢復流程

SSH 斷線後按現場狀態安全恢復 Claude Code 決策圖

圖:本站根據 Claude Code 官方文檔:CLI reference 會話恢復機制整理的示意圖

如果剛才忘了開 tmux 就直接斷線了,切忌一重連就盲目重新發一遍長提示詞。按官方歷史記錄機制(詳見 Claude Code 怎麼看歷史對話、恢復之前的會話),會話文件儲存在遠端機器的 ~/.claude/projects/ 下,按下面四步搶救最穩妥:

  1. 檢查是否有殘留殭屍進程:跑 ps aux | grep claude 看舊進程是否已退出;
  2. 檢查磁盤半截改動:跑 git status 和 git diff,確認斷網瞬間有沒有寫到一半的碎文件或殘留鎖文件;
  3. 接回剛才那輪對話:在原項目目錄運行 claude --continue(直接續接最近一次對話)或 claude --resume(從列表裏選指定會話);
  4. 讓模型先核對現場再繼續:恢復後發一句「剛才 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 官方文檔: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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~