常见问题
显示「未连上中继」
Section titled “显示「未连上中继」”当前网络访问不到中继,这时只有和 Mac 在同一网络中的设备能连接。可以在 Mac「设置 › 网络」里填一个能访问的自建中继(iroh-relay,https:// 开头),修改后已配对的手机仍能自动找到这台 Mac。
Mac 菜单栏提示「网络启动失败」时,点「重试」。
手机提示「需要重新配对」
Section titled “手机提示「需要重新配对」”Mac 上移除了这台设备、重置了身份,或是改用扫码配对前留下的旧配置。在 Mac 菜单栏点 Nohup 图标,选「配对新设备…」,用手机重新扫码。
手机提示「版本不兼容」
Section titled “手机提示「版本不兼容」”Mac 和手机上的 Nohup 版本不一致。把两端更新到同一版本后点「更新后重试」。
手机提示「服务端身份已变更」
Section titled “手机提示「服务端身份已变更」”Mac 端重装或重置了密钥。先核对手机上显示的新指纹与 Mac「设置 › 网络」中的服务端指纹一致,再点「信任新身份」,或者直接重新扫码配对。
菜单栏提示「未找到 Claude Code」
Section titled “菜单栏提示「未找到 Claude Code」”点提示旁的「安装方法」按说明安装;安装后在「设置 › Claude」点「重新检测」,或手动指定可执行文件。
如果你的 claude 是一个注入了代理等环境变量的 zsh 函数,Mac 端会自动提取这些变量,也可以在设置里手动覆盖。
离开 App 后收不到完成通知
Section titled “离开 App 后收不到完成通知”iOS 后台唤醒时机由系统决定;在多任务界面上滑关闭 App 后,系统不会再唤醒它。可以在手机「设置 › 诊断 › 后台检查记录」查看。
会话空闲一段时间后怎么样
Section titled “会话空闲一段时间后怎么样”长驻的 claude 进程空闲 10 分钟后会退出(可以配置),下一条消息会自动 --resume,对使用没有影响。
断网了消息会丢吗
Section titled “断网了消息会丢吗”不会。消息先写入手机上的发件箱再投递,重连后自动按顺序重发;服务端按消息 ID 去重,同一条消息只执行一次。Mac 重启时执行到一半的任务不会自动重跑,会提示你确认后再重发。详见 架构。
手机连不上 Mac
Section titled “手机连不上 Mac”- 确认 Mac 上 Nohup 在运行、Mac 没有睡眠。
- 在 Mac「设置 › 网络 › 已配对的设备」中确认这台手机还在列表里;不在的话重新扫码配对。
- Mac 菜单栏提示「未连上中继」时,只有同一网络中的设备能连接,见 显示「未连上中继」。
- 同一网络却连得慢或只能经中继时,检查 iPhone「设置 › 隐私与安全性 › 本地网络」中是否允许了 Nohup。
Mac 菜单栏的「设备」一栏会列出所有已配对的设备:在线的显示直连还是经中继、延迟;离线的显示上次在线时间。
怎么移除一台设备
Section titled “怎么移除一台设备”在 Mac「设置 › 网络 › 已配对的设备」中点「移除」,这台设备会立即断开,要再使用需重新扫码配对。
Mac 睡眠后连接断开
Section titled “Mac 睡眠后连接断开”Nohup 只在有任务执行时阻止系统闲置睡眠,让任务能跑完;合上盖子或手动睡眠仍会断开。需要长时间远程使用时,请让 Mac 保持唤醒并接通电源。
找到了 claude,但任务执行失败
Section titled “找到了 claude,但任务执行失败”先在 Mac 的终端里运行一次 claude,确认已经登录并能正常对话,然后在手机上重新发送。
支持 Intel Mac 吗
Section titled “支持 Intel Mac 吗”目前不支持,Mac 端只提供 Apple Silicon 版本。
中继是谁的,能看到我的内容吗
Section titled “中继是谁的,能看到我的内容吗”默认使用 n0(iroh 的开发团队)的公共中继,只在手机和 Mac 无法直连时转发加密后的数据,看不到内容。也可以在 Mac「设置 › 网络」里改用自建中继。
需要注册账号吗
Section titled “需要注册账号吗”不需要。手机和 Mac 靠扫码配对互相认识,不需要注册 Nohup 或其他任何服务的账号。
为什么叫 Nohup
Section titled “为什么叫 Nohup”名字取自 Unix 的 nohup 命令:让程序在终端挂断后继续运行。Nohup 也是这样,人离开了电脑,Claude Code 照样在 Mac 上跑,拿起手机就能接着看、接着管。
请准备以下信息,便于定位问题:
- Mac 日志:「设置 › 通用 › 诊断 › 日志」点「在 Finder 中显示」(
~/Library/Logs/Nohup/nohup.log)。 - 两端的版本号(Mac:「设置 › 关于」;手机:「设置 › 关于」)。
- 手机「设置 › 诊断 › 后台检查记录」的截图(与通知有关的问题)。