教程 3：在手机上工作

目标： Claude 需要输入时，你的 iPhone 收到推送；轻点、连接、回复。

ccmux 的窄屏布局适配手机终端，完整 TUI 会切换为专为小屏设计的单列视图。

ccmux — 手机

配置（仅需一次）

ccmux moshi-setup

这会安装 moshi-hook，然后运行 moshi-hook host setup. 终端中会出现二维码。 打开 Moshi iOS 应用，点击 Add Host → Scan QR，用手机扫描终端二维码即可。

向导还会配置 Claude Code 的钩子条目，让通知自动触发。

工作原理

配对之后：

• Moshi 应用列出 Mac 上的所有 tmux 会话
• 当 Claude 暂停（needs_input）时，手机振动并收到 分类推送: approval_required 或 task_complete
• 轻点通知 → Moshi 选择器 → 连接 → 回复 → 划走

BEL 备选方案（非 Moshi）

终端客户端可能支持通过终端响铃触发本地通知。能否收到提醒取决于客户端、通知设置，以及连接是否保持活跃。这与 Moshi 的原生推送通知是不同的机制。

避免重复通知

默认情况下，即使 Moshi 已配对，笔记本仍会响铃（两者互补）。要在 Moshi 已提醒时静音终端响铃：

# ~/.config/ccmux/config.toml
[notifications]
moshi_suppresses_bell = true

无界面 / 脚本化配置

ccmux moshi-setup --token <token>

跳过二维码流程，适用于没有显示器的远程机器。

构建自己的移动客户端

ccmuxd 提供 HTTP API，可列出会话、连接实时终端（通过 WebSocket 桥接的 PTY）、发送按键、订阅事件、读取笔记和用量，还支持配对及推送（APNs/FCM）。 Moshi 应用是当前的移动端方案；同一套 API 也向任何客户端开放。参见 HTTP API 参考.

发现错误或过时内容？ 在 GitHub 上编辑此页.