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 条评论

登录 后参与评论

还没有评论,来抢沙发~