概览
Btelo Coding 是一个 iOS 应用，但在 Apple Silicon Mac（M1、M2、M3、M4） 上，App Store 允许你直接安装这个 iOS 二进制。你获得完全相同的会话、聊天和控制面板 —— 只是运行在桌面窗口中，并且可以使用真正的键盘。
没有单独的 Mac 代码库。Mac 客户端就是 iOS 应用本身。
在 Mac 上你会得到：
- 几乎拥有 iOS 的全部功能。 浏览文件、聊天、控制会话、切换 AI 模型、管理 connector 和定时任务 —— iOS 上的功能在 Mac 上基本都能用。
- 针对桌面输入做了优化。 支持物理键盘快捷键、触控板滚动、窗口自由缩放、复制粘贴行为符合桌面应用的习惯，而不是把手机交互照搬过来。
- 和 iPhone 实时同步。 聊天内容和会话状态通过 relay 实时同步。在 Mac 上发送一条消息，iPhone 上立即同步出现 —— 你可以在两端无缝切换，不会丢失上下文。
- 跨电脑、跨网络远程操作。 Mac 应用可以控制任意一台 relay 能联系上的 agent：家里电脑、VPS、同事的机器，分别处于不同网络甚至不同城市都没问题。会话进行中你可以在 Wi-Fi、有线、手机热点之间切换 —— relay 会自动保持连接。
- 比终端更顺手。 比起直接在终端里跑 Claude / Codex，这里每一条聊天消息都在 Mac 和 iPhone 之间完整实时同步；同时可以把多个工作路径、多个会话分到不同窗口里并排管理，互不打扰。
使用条件
- 搭载 Apple Silicon 的 Mac（Intel Mac 不能从 App Store 安装 iOS 应用）
- macOS 11 Big Sur 或更新版本
- 已登录 Apple ID 的 App Store
四步装好
- 打开 App Store（从 Dock 或 Launchpad）。
- 搜索
Btelo Coding。 - 在搜索结果中切换到 iPhone 与 iPad 应用 标签页 —— iOS 应用在 Mac 上就是放在这里。
- 点击「获取」 并安装。装好后会出现在「应用程序」文件夹和 Launchpad 里。
登录
最简单的方式是粘贴 connector URL：
- 在被控电脑上打开
btelo-codingCLI 的 TUI，切到 Dashboard 标签页。 - 按 r 刷新一下二维码（推荐 —— 二维码很快会过期）。
- 按 y 把二维码 URL 复制到剪贴板。
- 打开 Mac 应用，进入 Connect 页面，把 URL 粘贴进去，就连上了。
会话通过 relay 同步 —— 你可以在 Mac 上开会话，等会儿在手机上接着处理，反过来也可以。
Mac 应用 vs. CLI agent
| 角色 | 是什么 | 在哪里运行 |
|---|---|---|
| 客户端（Mac 应用 / iOS 应用） | 你发起操作的地方 | 你的 Mac 或 iPhone |
| 服务端（CLI agent） | 被控制的一端 | 家里的电脑 / VPS |
两者角色不同。Mac 应用 不能 替代 CLI agent —— 你想控制哪台电脑，就得在那台电脑上跑 CLI agent。
Intel Mac 怎么办
App Store 在 Intel Mac 上不提供 iOS 应用。Intel Mac 请改用 CLI agent（支持 macOS 10.15+ amd64），从 iPhone 连接过去。
局限
- 窗口可以自由缩放，但布局沿用 iPad / iPhone 的设计 —— 不是为 macOS 重新设计的 UI。
- 部分仅 iOS 才有的系统能力（触觉反馈、Live Activities）在 Mac 上不可用。
- 推送通知通过官方 relay 的 APNs 才能送达。自托管 relay 不支持推送。
为什么不做原生 Mac 二进制？
Apple Silicon Mac 原生运行 iOS 应用，没有任何兼容层开销。再维护一份代码纯属浪费。哪怕将来做 Mac 专属的 UI，也是作为补充，不会替代现在这个方案。