结论先说
- 防断线的根本办法是把
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 条评论
还没有评论,来抢沙发~