想要原生 Mac 应用？ 如果你想在这台 Mac 上运行 agent，请下载原生桌面应用 — 那是推荐选项。本页介绍的是在 Mac 上使用 iOS 客户端来控制运行在另一台电脑上的 agent。
概览
Btelo Coding iOS app 可以在 Apple Silicon Mac（M1、M2、M3、M4） 上运行 — App Store 允许你直接安装同一个 iOS 二进制文件。你获得与 iPhone 完全相同的会话、聊天和操控体验 — 运行在桌面窗口中，并可使用真正的键盘。它作为客户端使用，指向运行在其他地方的 agent（你的桌面应用、CLI agent 或 VPS）。
该客户端没有单独的 Mac 代码库，Mac 客户端就是 iOS app 本身。
在 Mac 上你将获得：
- 几乎完整的 iOS 功能对等。 浏览文件、聊天、控制会话、切换 AI 提供商、管理连接器和定时任务 — iOS 上几乎所有功能在 Mac 上都相同。
- 针对桌面输入优化。 物理键盘快捷键、触控板滚动、自由窗口缩放以及复制粘贴操作，都符合桌面应用的习惯，而非手机交互方式。
- 与 iPhone 实时同步。 聊天和会话状态通过 relay 实时传输。在 Mac 上发送消息，iPhone 上立即同步 — 在会话中途切换设备也不会丢失上下文。
- 跨机器、跨网络。 Mac app 可以控制 relay 能触达的任何 agent：家里的电脑、VPS、队友的机器，不同网络或不同城市均可。会话进行中可以在 Wi-Fi、有线和热点之间切换 — relay 会保持连接。
- 超越裸终端。 与直接在终端运行 Claude 或 Codex 相比，每条聊天消息都在 Mac 和 iPhone 之间完整实时同步，还可以把多个工作目录和多个会话分到不同窗口并排管理。
使用条件
- 搭载 Apple Silicon 的 Mac（Intel Mac 无法从 App Store 安装 iOS app）
- macOS 11 Big Sur 或更新版本
- 已登录 Apple ID 的 App Store
四步完成安装
- 在 Mac 上打开 App Store（从 Dock 或 Launchpad）。
- 搜索
Btelo Coding。 - 在搜索结果中切换到 iPhone 与 iPad 应用标签页 — iOS app 在 Mac 上就在这里。
- **点击「获取」**并安装。装好后会出现在「应用程序」文件夹和 Launchpad 中。
登录
最简单的方式是扫描或粘贴来自目标 agent 的连接器 URL：
- 在 agent 上打开配对二维码 — 桌面应用中的 Connect 面板，或 CLI TUI 的 Dashboard 标签页（按 r 刷新，按 y 复制 URL）。
- 打开 Mac app，进入 Connect 页面，扫描二维码或粘贴 URL，即可连接。
会话通过 relay 同步 — 你可以在 Mac 上开始会话，然后在手机上接续 — 反之亦然。
客户端 vs. agent
| 角色 | 是什么 | 在哪里运行 |
|---|---|---|
| 客户端（Mac app 或 iOS app） | 你发起操作的地方 | 你的 Mac 或 iPhone |
| Agent（桌面应用或 CLI） | 被控制的一端 | 你的家用电脑 / VPS |
这是不同的角色。iOS-on-Mac 客户端不会运行 agent — 你仍然需要一个 agent（Mac/Windows 上的桌面应用，或CLI agent）运行在你想控制的电脑上。
Intel Mac
App Store 在 Intel Mac 上不提供 iOS app。如需在 Intel Mac 上运行 agent，请使用 CLI agent（支持 macOS 10.15+ amd64），然后从 iPhone 连接过来。
局限
- 窗口可以自由缩放，但布局沿用 iPad/iPhone 的设计 — 不是为 macOS 重新设计的 UI。
- 部分仅 iOS 才有的系统功能（触觉反馈、Live Activities）在 Mac 上不可用。
- 推送通知仅在官方 relay 上通过 APNs 送达，自托管 relay 不支持推送。
原生桌面应用 vs. 此方案
Mac 和 Windows 都有原生桌面应用 — 但它扮演不同的角色。桌面应用负责在这台机器上运行 agent。本页描述的 iOS-on-Mac 客户端负责控制运行在其他地方的 agent。如果你想把这台 Mac 作为被驱动的电脑，请使用桌面应用；如果你想用 Mac 来驱动另一台电脑，请使用此 iOS 客户端。