手机接力
Codux Mobile 与桌面端宿主配对，让你离开电脑也能在手机上接着干。桌面端始终是真正的终端宿主。配对和传输都跑在 Iroh 上：网络允许时走点对点直连，不行就回落到中继。
| 组成 | 作用 | 下载 |
|---|---|---|
| Codux Desktop | 桌面主应用：项目、终端、Git、统计、记忆与远程宿主。 | 桌面端下载 |
| Codux Mobile | Android 与 iOS 伴侣端：配对桌面端、共享分屏终端、浏览和编辑文本文件、上传图片。 | 移动端下载 |
| 中继（可选） | 无法直连时帮两台设备通过 Iroh 连上。在设置里选个节点就行。 | 中继指南 |
在 设置 → 远程 里，中继就是个简单的选择——没有地址要复制：
| 选项 | 何时用 |
|---|---|
| 全球 | 默认。开箱即用，无需配置。 |
| 国内（腾讯云） / 国内（阿里云） | 国内用户更快的路径。内置——选一下就行。 |
| 自定义 | 指向你自己的节点，见中继指南。 |
改完中继后，重新配对一次手机端，让二维码反映新的网络路径。
手机能操作什么
Section titled “手机能操作什么”桌面端宿主对外开放这些远程操作：
- 项目 —— 列表、选择、添加、编辑、删除。
- 终端 —— 列表、创建、输入、resize、中断/Esc、关闭、缓冲区回放。
- Worktree —— 列表、选择、创建、合并、移除。
- 文件 —— 列表、UTF-8 文本读写（最大 2 MB）、新建目录、同目录重命名、删除，以及二进制安全的复制/移动。
- Git —— 状态，以及桌面面板执行的同一套 Git 操作。
- AI —— 所选项目的统计（实时会话、热力图、时间桶、工具与模型拆分）、实时 AI 状态、会话操作。
- SSH —— 管理 SSH 连接配置。
图片上传会写进宿主的临时上传目录，并以文件路径形式插入到当前终端。
传输：直连优先
Section titled “传输：直连优先”Codux Mobile 从桌面端生成的短期配对码开始。配对后，连接优先走 Iroh 的点对点直连；无法直连时，同一套协议继续走你选择的中继。
桌面端生成一个短期配对码和二维码（约 10 分钟有效）。因为出示二维码本身就证明你持有它的一次性 secret，配对是自动确认的——没有操作员弹窗，凭据也不离开主机。
所有流量都跑在 Iroh 加密的 QUIC 连接上，由每台设备的节点身份认证。中继只负责帮两台设备互相找到对方、在无法直连时转发加密后的不透明数据包——它不会变成宿主，也看不到你解密后的内容。
需要私有或区域路径的团队，可以把 Codux 指向自定义中继节点。大多数用户用 全球 节点就行，无需任何配置。