iHomeMac

本地电脑断开后，让 Claude Code 留在远端运行

将 Claude Code 放在远程 Mac 的 tmux 会话中，可以断开本地连接，之后再接回同一个终端。前提是远程 Mac 仍在线、进程未退出，且工具的授权和额度正常。

更新于 2026-11-06 · iHomeMac

01 · 先确认环境，再装 tmux

先完成使用教程中的 SSH、Claude Code 登录和项目准备。下面所有命令都在远程 Mac 上执行，使用同一个 macOS 用户。

先检查 tmux -V。尚未安装且机器已有 Homebrew 时，执行 brew install tmux。没有 Homebrew 时先按 brew.sh 官方说明安装，或与交付支持人员确认软件准备方式；不要假定每台机器都预装好了。

hostname
claude --version
tmux -V

# 仅在尚未安装 tmux、且已有 Homebrew 时执行
brew install tmux

先用时间输出验证连接方式，避免第一次就把正式任务放到后台。创建测试会话后，在里面运行循环：

tmux new -s connection-check

# 在新会话中执行，每 10 秒输出一次时间
while true; do date; sleep 10; done

按 Ctrl+b，松开，再按 d，将会话留在后台。此时可以断开本地 SSH，再重新登录同一台 Mac、同一个系统用户，执行 tmux attach -t connection-check。

重新看到持续输出的时间后，按 Ctrl+c 停止测试循环，再输入 exit 结束这个测试会话。不要使用 kill-server，以免影响其他会话。这只是连接测试，不代表机器永不断电或所有 Claude 任务都能自动完成。

创建一个有名字的工作会话，进入远端项目目录，再启动 Claude Code。下面的项目路径需要替换为你自己的目录。

tmux new -s claude-work

# 在新会话中执行
cd ~/Projects/my-project
caffeinate -i claude

caffeinate -i 会在它启动的 Claude 进程运行期间阻止系统空闲休眠，不会阻止关机、重启或网络中断。若当前系统找不到该命令，可在 Mac 终端查阅 man caffeinate，并联系支持人员核对电源配置。

已经有 claude-work 会话时，先用 tmux ls 查看，再 attach 接回；不要为同一个任务反复创建新进程。

离开：在 tmux 内按 Ctrl+b，松开，再按 d。看到 detached 提示后再关闭本地终端或电脑。不要把 Ctrl+d 或 exit 当成脱离，它们可能结束当前 shell。

回来：先按交付方式重新连接远程 Mac，再执行：

tmux ls
tmux attach -t claude-work

接回后先读当前状态：任务是在运行、等待批准、遇到限额，还是已经完成。tmux 保留的是会话，不会替你回答审批问题，也不会增加 Claude 的使用额度。

Claude 网页版并不由 tmux 管理；这里讲的是终端中的 Claude Code。断开远程桌面与退出 macOS 用户也不同。

本地 SSH 断线：远端 tmux 仍运行时，重新登录后 attach 即可。远程网络中断：先恢复到机器的连接，再核对任务是否受到影响。

远程 Mac 重启、关机或用户进程被结束：旧 tmux 进程不能跨重启存活。恢复机器连接后，先检查文件和任务结果，避免重复执行已经完成的外部操作。

原项目中的 Claude 对话历史仍在时，可按官方 CLI 文档用 claude --continue 继续最近对话，或用 claude --resume 选择会话。这是恢复对话上下文，不是恢复重启前的操作系统进程。

提示 no sessions 或找不到会话：先检查是否登录了正确的 Mac、相同系统用户，以及原会话是否已退出。机器重启后的解锁和接入方式，需要按这台机器的交付配置处理。

除了已配置的 SSH 客户端，Claude Code 的 Remote Control 也可从官方网页或手机端连接已有会话。使用条件和启动方法以官方文档为准，承载会话的远程 Mac 仍需在线。它不会替你提供另一台主机或另一条网络。

先用短任务验证，再延长运行时间。保留必要权限确认，检查订阅或 API 用量，把成果同步到自己的存储；遇到等待审批或额度不足时，处理对应问题。

iHomeMac 已说明由团队处理机器与网络故障；具体响应时间、恢复目标和补偿以开通前确认的条件为准。本教程不构成自动重启恢复、不中断运行或任务必定完成的承诺。