Claude Code 只在你的 Mac 上登录,离开电脑后用手机接着操作 Herdr 里的会话:看进度、批准工具调用、回复它,Claude 等你确认或做完时手机收到推送。
https://appstore.lazycat.cloud/#/shop/detail/dev.herdrmobile.hub
目录
- 一、Keji 是什么
- 二、准备工作
- 三、安装 Keji 并连接你的 Mac
- 四、日常使用:看进度、回复、发图片
- 五、审批、提问和推送通知
- 六、进阶玩法
- 七、家里有几个懒猫账号时
- 八、常见问题
- 九、卸载与清理
一、Keji 是什么
- 只登录一次:Claude 只在 Mac 的 Herdr app 登录。手机和微服上都不用登录 Claude,也不保存 Claude 的账号,所有 Claude 请求都从你的 Mac 发出。
- 适合谁:在 Mac 上用 Herdr 跑 Claude Code,经常让它跑着、自己走开的人。(主要是我怕多设备登录被封......)
- 怎么连的:Keji 装在你的微服上,Mac 上一个叫 bridge 的小程序主动连到它。Mac 不开任何端口,全程走懒猫的虚拟网络。
- 非官方:Keji 是 Herdr 的非官方配套应用,和 Herdr 官方无关。

二、准备工作
你需要三样东西:一台懒猫微服、一台装了 Herdr 和 Claude Code 的 Mac、一部装了懒猫客户端的手机。
| 设备 | 要装什么 | 说明 |
|---|
| 微服 | Keji(系统 1.6.0 及以上) | Keji 装在这里,一直在后台运行 |
| Mac | Herdr 桌面 App | 到 herdr.dev 下载。Claude Code 要在 Herdr 的终端里跑,Keji 才看得到。早期的终端版 herdr(0.9)不支持 |
| Mac | Claude Code | 已登录,平时怎么用还怎么用 |
| Mac | 懒猫客户端 | 已登录、处于连接状态,Mac 靠它连到微服 |
| 手机 / iPad | 懒猫客户端 | Keji 在懒猫 App 里打开 |
另外几点:
- 系统:Mac 支持 Apple 芯片和 Intel,不支持 Windows 和 Linux。
- 语言:Keji 的界面是中文。
- 版本:本文按 Keji 0.9.70 写。文中
<盒子名> 换成你自己的微服名称,Keji 的地址是 https://herdr.<盒子名>.heiyu.space。
- 截图:文中截图里的 Mac、项目和会话都是演示数据。
三、安装 Keji 并连接你的 Mac
在 Mac 终端里跑一条命令,再在手机上核对一次配对码,Mac 就连上了。
3.1 安装和配对
- 安装:在懒猫商店搜索「Keji」并安装。
- 打开:第一次打开会先弹出「使用须知」,看完关闭即可。
- 复制命令:页面显示「连接你的 Mac」,点「复制」拿到安装命令。小技巧:在 Mac 的懒猫客户端里也打开 Keji,直接在 Mac 上复制,省得从手机传过去。
- 在 Mac 上运行:在「终端」里粘贴运行。它依次检查和微服的连接、检查 Herdr、配对、安装开机自启服务;问「加上审批 hook?」时直接回车(默认是)。
- 核对配对码:终端里出现 6 位配对码时,手机上的 Keji 会弹出「「你的 Mac 名」请求连接」。两边一致就点「确认配对」,配对码 10 分钟内有效。
- 完成:终端最后显示「完成!」,手机上就出现这台 Mac 上 Herdr 里的 Claude Code 会话。

▲ 左:第一次打开时的「连接你的 Mac」。右:Mac 上跑了安装命令后弹出的配对确认,配对码要和终端里的一样。
3.2 安装命令和终端输出
安装命令如下,Keji 里复制到的已经填好了你的地址:
curl -fsSL https://herdr.<盒子名>.heiyu.space/bridge/install.sh | sh
终端里大致是这样(配对码每次不同,中间审批 hook 的说明省略了):
[1/4] 检查与 hub 的连接
✓ https://herdr.<盒子名>.heiyu.space 可以访问
[2/4] 检查 herdr-core
✓ herdr-core 正在运行(4 个终端,其中 2 个 Claude Code)
[3/4] 配对
配对码:123456
在手机上打开 Keji,核对并确认这个配对码(10 分钟内有效)…
✓ 已配对,名称「MacBook-Pro」
[4/4] 安装开机自启服务
✓ 已安装(日志:~/Library/Logs/herdr-mobile/bridge.log)
加上审批 hook? [Y/n]
✓ 已在 ~/.claude/settings.json 里加上审批 hook
✓ 已连上 hub
完成!在手机上打开 Keji,就能看到这台 Mac 上的 Claude Code 会话。
3.3 它会在 Mac 上改什么
这条命令在 Mac 上只改这几处:
- 两个文件夹:
~/.herdr-mobile 放 bridge 程序和手机发来的图片(图片 7 天后自动删除);~/.config/herdr-mobile 放配对信息。
- 一个后台服务:登录自启的
dev.herdrmobile.bridge。它只主动连你的微服,Mac 上不开端口。
- 一个审批 hook:你同意后,在
~/.claude/settings.json 里加一个审批 hook,其他设置原样保留。不加也能用,手机改为读屏幕来审批。
有几台 Mac 就在每台上各跑一次。以后 Keji 更新时,Mac 上的 bridge 会自己跟着更新,不用重跑命令。
四、日常使用:看进度、回复、发图片
在 Mac 上照常用 Herdr 和 Claude Code,不用改任何习惯;手机上看到的就是这些会话,两边随时切换。
4.1 会话列表
- 分组:按 Herdr 的空间和标签页分组,顺序和电脑上一致。每行一个会话:状态符号 + 标题,第二行是「N 分钟前 · 最后一句回复」。
- 等你处理:顶部收集等你确认的会话,和你上次看过之后又做完的会话。「清除已完成」全部标为已看。
- 筛选:顶部可以只看某个分组;被筛掉的分组里有人等你确认时,它的标签上亮橙点。
- 排序:可选「和电脑上一致」「需要你的优先」「按名称」。
- 子 agent:Claude 开的子 agent 挂在它下面,折成一行「N 个子 agent」,点开展开。

▲ 左:会话列表,顶部是「等你处理」。右:会话页,输入框上方是工作横条。
4.2 会话页
- 对话:和 Mac 上的同步。连续的工具调用合成一行,比如「运行了 2 条命令,读了 1 个文件 ›」,点开看详情;改文件的工具调用单独成卡片,能看到改了哪些地方。
- 工作横条:Claude 工作时,输入框上方写着它在做什么和已经用了多久。横条变橙色「API 出错,正在重试」是 Claude Code 自己在重试,不用管。
- 后台运行中:状态是蓝色「后台运行中」时,Claude 这一轮停了,但还有后台任务在跑,结束后它会接着处理。
4.3 回复和中断
- 发消息:在输入框里打字,点发送。Claude 正忙时发的消息会显示「排队中」,它忙完当前这步就会收到。
- 发建议:输入框空着、Claude 给了下一步建议时,发送键变蓝,点一下就把建议发出去。
- 叫停:Claude 工作时输入框空着,发送键变成停止键,效果和在 Mac 上按 Esc 一样。它还没开始干活就被叫停时,刚发的消息和图片会放回输入框,改改再发。
- 常用命令:输入栏左边的「⌘」里有继续、compact、clear、usage、status。
4.4 发图片
- 选图:点输入栏左边的「+」选图片,和文字一起发给 Claude。超过 1MB 的图会自动压缩。
- 标注:点输入栏里的缩略图可以在图上画线标注(五种颜色、可撤销),圈出要 Claude 看的地方。
- 查看和重发:对话里的图片点开是全屏查看,双指缩放;里面的「标注 / 重发」把它拿回输入栏。
五、审批、提问和推送通知
Claude 要跑命令、改文件需要你同意,或者有问题问你时,手机会收到推送,点进去就能直接回答。
5.1 审批
- 卡片:输入框的位置换成一张「等待你的确认」卡片,写着 Claude 要做什么。
- 选项:「允许」、「允许,并…」(和终端里的「总是允许」一样)、「拒绝」、「拒绝,并告诉 Claude 该怎么做…」。
- 两边都能答:Mac 上的审批框同时还在,哪边先回答算哪边。
5.2 提问
Claude 用选择题问你时,卡片上列出选项,点一个即可;都不合适就在「或者自己写…」里打字。
卡片上只有数字选项和「取消(Esc)」时,是没装审批 hook,手机在读 Mac 的屏幕。也能用,想换成完整版见「八、常见问题」第 5 条。

▲ 左:Claude 要装一个依赖,等你审批。右:Claude 用选择题问你问题。
5.3 推送通知
在 Keji「设置」→「通知」里设置:
| 选项 | 作用 |
|---|
| Claude 等你确认时 | 有审批或提问时推送 |
| Claude 完成时 | 一轮做完时推送,还有后台任务时会写上个数 |
| 免打扰时段 | 这段时间里不推送 |
| 测试通知 | 发一条试试能不能收到 |

▲ 设置页:外观、通知、已配对的 Mac。
正开着 Keji 时不推送。子 agent 只在等你确认时推送,做完不推(它会向上一级 Claude 汇报)。
六、进阶玩法
除了看和回复,手机上还能开新会话、换模型、翻项目文件、直接操作终端。
6.1 新建一个会话
- 列表顶栏点「新会话」。
- 选一个项目。这里列的是 Herdr 里已有的空间,默认选你正在看的那个;只能选已有的空间,不能任意指定目录。
- 填第一条消息(可不填),需要的话顺便选模型和推理强度,只用于这个会话。
- Mac 上 Herdr 的那个空间里会多出一个标签页,跑着新的 Claude Code。

▲ 新会话面板:选项目、填第一条消息,下面是可以继续的旧会话。
6.2 继续以前的会话
- 从新会话面板:在面板下面的「或者继续之前的会话」里选。
- Mac 重启之后:Herdr 的标签页只恢复成普通终端时,打开它的会话页,点顶部「继续 Claude 会话」。
6.3 切换模型和推理强度
输入栏左边的表盘图标显示当前的推理强度,点开可以换模型和强度。
- 和在 Mac 上用
/model、/effort 一样,它也会成为 Mac 上之后新会话的默认(max 除外)。
- Claude 工作中或等你确认时不能切换。
6.4 浏览项目文件
会话页右上角「⋯」→「浏览文件」,只读地浏览这个会话当前的目录。
- 显示:代码带行号和语法高亮,Markdown 可在渲染和源码之间切换,图片直接显示。
- 引用:「引用」把
@文件路径 放进输入框,告诉 Claude 看哪个文件。
- 范围:只能看这个目录里的文件,文本最多显示 1MB。
6.5 看终端、直接打字
- 打开终端:会话页顶栏的终端图标打开 Mac 上这个终端的实时画面。
/usage、/model、/status 这类交互命令会自动打开它。
- 直接打字:点一下画面就能用手机键盘直接打字,用来操作这些交互界面。中文和
? ~ " | 这几个符号打不了,要用下面的输入框。
- 适应宽度:调整字号,让最宽的一行放得下。
- 不是 Claude 时:终端里跑的是普通 shell、Codex 等时,会话页直接就是终端画面,下面一行输入命令。
6.6 其他
- 关闭会话:「⋯」→「关闭会话」,Mac 上对应的标签页也会关掉,对话记录保留在 Claude 里。
- iPad 和宽屏:左边会话列表、右边会话,分栏显示。
- 深浅色:「设置」→「外观」,可选跟随系统、浅色、深色。
七、家里有几个懒猫账号时
一个 Keji 只给一个懒猫账号用:它能操作那个人 Mac 上的终端,所以不和同一台微服的其他账号共享。
| 谁打开 | 看到什么 |
|---|
| 第一个打开的微服管理员 | 成为使用者,正常使用 |
| 还没有使用者时,普通成员先打开 | 「Keji 还没有使用者」,不会占用它 |
| 已有使用者后,其他普通成员 | 「这个 Keji 属于另一位用户」 |
| 已有使用者后,另一位管理员 | 同一页,多一个「改为归我使用…」按钮 |
管理员接管时要点两次(「改为归我使用…」→「确认,改为归我使用」)。接管后:
- 原来的 Mac 断开:原使用者配对的所有 Mac 都会解除配对,那边的 bridge 停下来。要连到新使用者这里,得在 Mac 上重新运行安装命令。
- 设置重置:通知设置恢复默认,原使用者再打开时看到「属于另一位用户」。
八、常见问题
1. Mac 显示「离线」?
多半是 Mac 睡眠了,或者 Mac 上的懒猫客户端没连上。Mac 醒来、客户端连上后会自动恢复。还不行就在 Mac 终端运行 ~/.herdr-mobile/bin/bridge status,看服务状态和最近的日志。
2. 显示「Herdr 未运行」?
在 Mac 上打开 Herdr,手机上会自动恢复。
3. Mac 上开着的某个终端,手机上没有?
手机上只显示 Herdr 窗口里的终端,在后台跑的终端不显示。子 agent 不单独成行,挂在启动它的会话下面。
4. 提示「Claude 还没收到,可能停在 Mac 的输入框里」?
点旁边的「看终端」。消息还在 Claude 的输入框里的话,点终端下面的「Enter」发出去。
5. 审批卡片只有数字选项和「取消(Esc)」?
安装时没加审批 hook。想加的话在 Mac 终端运行:
~/.herdr-mobile/bin/bridge install -hook
6. 列表里提示「这台 Mac 的 bridge 需要更新」?
平时 bridge 会自己更新,出现这个提示说明自动更新没成功。点它进设置页,把里面的安装命令在 Mac 上再运行一次。
7. 顶部提示「已更新,刷新」?
Keji 刚升级过,点一下加载新版。
8. 收不到推送?
- 先在「设置」→「通知」里点「测试通知」。
- 能收到但锁屏时收不到,就打开懒猫 App →「关于」→「查找设备」。
- 检查是不是在免打扰时段里。
9. 在手机上换了模型,Mac 上新开的会话也变了?
是的,和在 Mac 上用 /model 一样会改默认。只想给一个会话用,就在「新会话」里选。
10. 安全吗?
- Keji 只给它的使用者这一个懒猫账号用,访问都要在懒猫的虚拟网络里。
- Mac 不开端口,是 bridge 主动连到你的微服。
- 文件浏览是只读的。
- 注意:能打开你这个 Keji 的人就能操作你 Mac 上的终端,所以它只归一个账号,别把懒猫账号借给别人。
11. 和商店里其他能远程用 Claude Code 的应用有什么不同?
- cc-connect、Claude Code UI 这类:把 Claude Code 装在微服里跑,要在微服里再登录一次 Claude。
- Happy Coder、HAPI:在 Mac 上跑,但要装它们各自的命令行工具,用
happy / hapi 代替 claude 启动,Happy Coder 还要注册它自己的账号。
- Keji:只用你 Mac 上已经登录的 Claude Code,也不改启动方式:在 Herdr 里照常开,手机上就有。代价是只支持 Herdr 里的 Claude Code,不用 Herdr 或主要用 Codex 的话,它们更合适。
九、卸载与清理
在 Mac 上跑一条命令,再在手机上解除配对,就清理干净了。
第 1 步:在 Mac 终端运行下面的命令。它移除自启服务、~/.claude/settings.json 里的审批 hook、配对信息和日志,其他 Claude 设置不动。
~/.herdr-mobile/bin/bridge uninstall -purge
第 2 步:在 Keji「设置」→「已配对的 Mac」里,对这台 Mac 点「解除配对」。
第 3 步:不再用 Keji 的话,再在懒猫里卸载它。
两种特殊情况:
- 只是换一台 Mac:在旧 Mac 上做第 1、2 步,在新 Mac 上重新跑安装命令。
- 只在手机上解除配对、没卸载:Mac 上的 bridge 会停下来等着,重新跑安装命令就能再配对。
致谢
Keji 的远程思路参考了 yetone 的 Alma,感谢。
评论
0暂无评论