Keji 使用攻略:Claude 只在 Mac 上登录,手机上接着用

u67025155

发布于11天前
还没想好签名

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 官方无关。

iPad 横屏:左边会话列表,右边正在工作的会话

二、准备工作

你需要三样东西:一台懒猫微服、一台装了 Herdr 和 Claude Code 的 Mac、一部装了懒猫客户端的手机。

设备要装什么说明
微服Keji(系统 1.6.0 及以上)Keji 装在这里,一直在后台运行
MacHerdr 桌面 App到 herdr.dev 下载。Claude Code 要在 Herdr 的终端里跑,Keji 才看得到。早期的终端版 herdr(0.9)不支持
MacClaude 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 安装和配对

  1. 安装:在懒猫商店搜索「Keji」并安装。
  2. 打开:第一次打开会先弹出「使用须知」,看完关闭即可。
  3. 复制命令:页面显示「连接你的 Mac」,点「复制」拿到安装命令。小技巧:在 Mac 的懒猫客户端里也打开 Keji,直接在 Mac 上复制,省得从手机传过去。
  4. 在 Mac 上运行:在「终端」里粘贴运行。它依次检查和微服的连接、检查 Herdr、配对、安装开机自启服务;问「加上审批 hook?」时直接回车(默认是)。
  5. 核对配对码:终端里出现 6 位配对码时,手机上的 Keji 会弹出「「你的 Mac 名」请求连接」。两边一致就点「确认配对」,配对码 10 分钟内有效。
  6. 完成:终端最后显示「完成!」,手机上就出现这台 Mac 上 Herdr 里的 Claude Code 会话。

左:第一次打开时的「连接你的 Mac」;右:配对确认

▲ 左:第一次打开时的「连接你的 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 上只改这几处:

  1. 两个文件夹:~/.herdr-mobile 放 bridge 程序和手机发来的图片(图片 7 天后自动删除);~/.config/herdr-mobile 放配对信息。
  2. 一个后台服务:登录自启的 dev.herdrmobile.bridge。它只主动连你的微服,Mac 上不开端口。
  3. 一个审批 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 回复和中断

  1. 发消息:在输入框里打字,点发送。Claude 正忙时发的消息会显示「排队中」,它忙完当前这步就会收到。
  2. 发建议:输入框空着、Claude 给了下一步建议时,发送键变蓝,点一下就把建议发出去。
  3. 叫停:Claude 工作时输入框空着,发送键变成停止键,效果和在 Mac 上按 Esc 一样。它还没开始干活就被叫停时,刚发的消息和图片会放回输入框,改改再发。
  4. 常用命令:输入栏左边的「⌘」里有继续、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

▲ 设置页:外观、通知、已配对的 Mac。

正开着 Keji 时不推送。子 agent 只在等你确认时推送,做完不推(它会向上一级 Claude 汇报)。

六、进阶玩法

除了看和回复,手机上还能开新会话、换模型、翻项目文件、直接操作终端。

6.1 新建一个会话

  1. 列表顶栏点「新会话」。
  2. 选一个项目。这里列的是 Herdr 里已有的空间,默认选你正在看的那个;只能选已有的空间,不能任意指定目录。
  3. 填第一条消息(可不填),需要的话顺便选模型和推理强度,只用于这个会话。
  4. 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. 收不到推送?

  1. 先在「设置」→「通知」里点「测试通知」。
  2. 能收到但锁屏时收不到,就打开懒猫 App →「关于」→「查找设备」。
  3. 检查是不是在免打扰时段里。

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

暂无评论

说点什么呢~
收藏
0
0
0