完整的 Agent 工作流
01
交代任务，继续对话
发送新的要求、补充上下文或附上图片。需要调整方向时，停止当前任务，再继续交代。
02
看清执行过程与结果
阅读回复、展开工具输入与输出，查看测试结果、图片和代码 Diff。工具细节按需展开。
03
安装 Cmux Remote iOS 回答问题，推进下一步
在支持的问题和授权卡片中选择答案、补充说明或确认操作，让等待中的任务继续执行。
Cmux Remote · iOS / AndroidiPhone + Android
Cmux 的 Agent
图形客户端。
在 iPhone 和 Android 上，用图形化会话界面操作 Cmux 中的 Claude Code 与 Codex。发送任务、查看执行过程、检查代码改动、回答问题，继续推进电脑上的开发工作。
观看完整操作演示同一个 Agent，随手继续连接方式示意
Agent 留在电脑，
操作来到手边。
代码与环境在 Mac。
会话与改动在手机。
远端主机
运行 Agent 的 Mac
CmuxCompanion
storefront 代码 · 环境 · Agent
Claude CodeCodex开发环境
会话与工具记录 → 手机文件与 Diff → 手机问题与授权 → 手机
代码、环境与 Agent 继续在这里运行
Claude ~/projects/storefront
❯ 给结算页补上空状态，再跑测试
● 读取 src/checkout.tsx
● 编辑 src/checkout.tsx
已添加空购物车状态。
测试通过，改动等待检查。
已修改 2 个文件 · +24 −6
❯
● 读取 src/checkout.tsx
● 编辑 src/checkout.tsx
已添加空购物车状态。
测试通过，改动等待检查。
已修改 2 个文件 · +24 −6
❯
9:41▥ ▰
‹
结算页面优化remote-mac · Claude
···✳ Claude
已添加空购物车状态，测试已通过。
可以检查改动，或继续补充要求。
回复已完成继续下一步…↑
Mac · 代码、环境与 AgentiPhone · 图形会话
01 / 核心功能从交代任务，
从交代任务，
到检查结果。
在手机上完成一轮 Agent 开发。
对话、工具记录和代码改动，都有适合手机的界面。
‹
结算页面优化remote-mac / storefront
···给结算页补上空状态，再跑测试。
✳ Claude已补上空购物车状态，并完成测试。
修改 2 个文件⌄
购物车为空时，会显示提示和「继续选购」按钮。
测试通过
示例回复 · 已完成src/checkout.tsx+18 −6
+ if (!cart.length) { + return ( + <EmptyCart /> + ); + }
在手机上检查改动，再告诉 Agent 下一步。
等待你的确认
运行项目测试
Agent 请求执行下面的操作。
npm test授权界面示意，不会执行真实操作。继续下一步…↑
会话界面细节示意Claude / Codex
演示待补充
02 / 任务管理从手机开始，
从手机开始，
让电脑执行。
选择已授权的 Mac、工作区和项目目录。
启动新任务，或接着处理已有会话。
新建与恢复
新建任务，或恢复已有会话。
启动 Claude Code 或 Codex，直接交代第一个任务。已有会话结束后，也可以在支持恢复时继续原来的上下文。
新建会话
- 设备
- 开发 Mac
- 工作区
- storefront
- 项目目录
- ~/projects/storefront
- Agent
- Claude Code / Codex
给结算页补上空状态，再跑测试。
界面示意 · 任务在所选 Mac 上执行
会话与后台任务
多个项目，集中查看。
在不同 Mac、工作区和会话之间切换，找到运行中的任务和等待处理的问题，展开查看后台任务的执行记录。
工作区与会话
结算页面优化运行中
API 测试等待回答
文档更新已完成
长对话，接着阅读。
已读取的历史保存在手机上。重新打开时，先呈现已保存的内容，再同步最新进展；向前阅读时，继续加载更早记录。
界面示意 · 多 Mac、工作区与后台任务
03 / 与官方比较选择适合你的
选择适合你的
移动开发方式。
Cmux 官方移动客户端提供终端远程操作体验。
Cmux Remote 围绕 Claude Code 与 Codex 的会话组织界面。
| 比较维度 | Cmux 官方移动客户端 | Cmux Remote |
|---|---|---|
| 主要交互 | 官方页面主打实时终端镜像、工作区切换和完整键盘。 | 以结构化会话、工具卡、问题卡和 Diff 为主要界面。 |
| Agent 范围 | 终端模式适合各种命令行 Agent 和 TUI 程序。 | 重点支持 Claude Code 与 Codex 的结构化操作。 |
| 移动平台 | 公开提供 iPhone / iPad 入口。 | 提供 iOS、Android 客户端。 |
| 配对方式 | 官方 Mac 配对流程提供账号连接等方式。 | 无需项目账号，扫码申请并由 Mac 确认设备权限。 |
| 远程接入 | 提供 Auto-Connect、Tailscale Only 等连接方式。 | 可达网络直连，或使用自行部署的 Cloudflare 中转。 |
官方源码也包含聊天相关接口。此处比较主要交互方式与连接选择，具体能力以所用版本为准。
04 / 连接方式在附近直连，
在附近直连，
在外面接入。
同一局域网中发现并配对你的 Mac。
通过已有网络或自建中转，从外面继续访问。
局域网
发现附近的 Mac。
在支持服务发现的网络中找到 Mac，确认设备身份和工作区权限后连接。
手机Mac
附近发现 · 直接连接VPN / Tailscale
连接可达的远端。
利用已有 VPN 或 Tailscale 网络访问 Mac；未自动发现时，通过地址添加并配对。
手机Mac
已有网络 · 可达直连自建中转
无法直达，也能接入。
Mac 与手机主动连接你部署的 Cloudflare 中转，Mac 无需开放公网入站端口。
手机自建中转Mac
查看中转部署指南 每台设备单独审批，按工作区授权，可单独撤销。自动发现取决于网络配置。中转服务需要自行部署，本项目不提供托管中转。
05 / 开始使用连接你的 Mac，
连接你的 Mac，
打开第一个任务。
准备一次，让手机接入现有的开发环境。
准备 Mac
安装并运行 Cmux 和 Cmux Remote，开启共享，选择允许访问的工作区。
配对手机
安装 iOS 或 Android 客户端，扫描配对码，在 Mac 上确认设备。
开始开发
打开已有会话，或在获准的项目目录中开始新任务。需要外网访问时，再配置网络或自建中转。
Mac：macOS 14 或更高版本 · iPhone：iOS 18 或更高版本 · Android：Android 10 或更高版本。iOS 通过 TestFlight 安装，Android 通过 GitHub Releases 安装 APK。
06 / 开源与独立继续使用你的 Agent
继续使用你的 Agent
和开发环境。
Cmux Remote 与官方 Cmux 独立运行，无需修改或替换官方应用，也不会另建一套模型服务。任务继续由电脑上的 Agent 执行，沿用现有环境与配置。
客户端、Mac Companion 与中转代码开源
无需项目账号，没有分析追踪
代码、环境与 Agent 留在你的 Mac
独立运行，非 Cmux 官方产品
常见问题开始之前，
开始之前，
你可能想知道。
支持哪些 Agent 和操作？
结构化会话重点支持 Claude Code 和 Codex。可以发送要求、查看历史与工具记录、阅读文件和 Diff、停止任务，以及回应支持的问题与授权请求。获准设备还可新建会话或恢复符合条件的会话。
Mac 是否需要保持运行和唤醒？
需要。Agent 在 Mac 上运行，Cmux 与 Cmux Remote 需要保持可用；Mac 休眠、关机或离线时，手机无法继续读取实时状态或操作任务。
在外网使用，必须部署中转吗？
不一定。已有 VPN 或 Tailscale 等网络能访问 Mac 时，可以直连。无法直达时，再配置自己的 Cloudflare 中转。本项目不提供托管中转。
如何授权或撤销手机访问？
手机发起配对后，在 Mac 上批准该设备并选择可访问的工作区。每台设备可单独撤销，新的授权范围需要由 Mac 确认。
手机上的历史与实时状态有什么区别？
已读取的对话会保存在手机上，重新打开时可以先阅读这些内容。实时进展和操作仍需要连接 Mac；已保存的历史不代表任务当前的运行状态。
能否从另一台 Mac 接入？
可以使用 Companion 的工作区镜像接入已授权的远端终端工作区；也可以使用 Cmux 原生的 cmux ssh。两者的能力与手机结构化会话不同。查看 Mac 连接指南