Mimi Remote：手机远程控制 AI 编程

项目简介

Mimi Remote 是一款 iPhone / iPad 应用，用来远程控制运行在自己电脑上的 Codex 和 Claude Code。Agent 始终在你的 Mac、Windows 或 Linux 电脑上执行，手机只负责查看进度、回复问题和批准操作。项目开源、可自托管，不需要云端账号。

它通过可信局域网或 Tailscale 连接电脑上的 agentd 网关，把对话、工具步骤、审批请求和代码改动转成原生的 iOS 界面。项目与 OpenAI、Anthropic、DeepSeek、Tailscale 均无关联。

主要功能

• 查看运行过程：实时跟随回复、工具步骤和任务状态；电脑上已开始的会话可以直接在手机接着看，无需重新解释项目背景。
• 随时介入：回答 Agent 的提问，批准或拒绝它想执行的命令，排队下一条指令，或中断正在进行的回合；需要你处理时会推送锁屏通知。
• 完成收尾：使用 Codex 时可以在 App 内查看改动，并使用 Worktree 和 Git 操作。
• 多台电脑：配对多台电脑，每台有独立凭据，在 Devices 中切换当前设备；会话仍留在所属电脑上。
• 多种 Agent：同时支持 Codex 与 Claude Code，可选支持 DeepSeek Harness。
• 两种屏幕布局：iPhone 上是紧凑视图，iPad 上是多列工作区。

安装与使用

准备一台 iOS / iPadOS 18+ 的 iPhone 或 iPad，以及一台连接期间保持唤醒的电脑：macOS 15+、Windows 10/11 x64，或带 systemd 用户会话的 Linux（x86_64 / ARM64）。

1. 在电脑上安装并登录 Codex CLI（Mac 上也可使用 ChatGPT 桌面应用）。
2. 从 Releases 安装主机端：Mac 用 Mimi-Remote-Mac.dmg，Windows 用 Mimi-Remote-Setup 安装包，Linux 用对应的 linux 压缩包。Mac 上将 Mimi Remote Mac 拖入 Applications 并打开，设置窗口会要求选择代码文件夹，随后显示配对二维码。
3. 从 App Store 安装手机端（主屏幕名称为 mimi），或加入 TestFlight、从源码构建。
4. 在 App 中扫描二维码完成配对。之后可以在 Mac 菜单栏或 Windows 通知区域点击 Mimi Remote 图标再次显示；无法扫码时，可复制配对链接粘贴到 App 中。终端里执行 agentd pair --qr-only 可只显示二维码而不打印长期令牌。
5. 连接后选择项目，把它作为工作区打开并开始会话。

如需添加另一台电脑，在目标机器上重复以上步骤。需要 Codex 帮忙安装、升级或诊断主机时，可使用仓库中的 install-mimi-remote Skill。

注意事项

• 会话存储在你自己电脑上，由 Codex、Claude Code 或 DeepSeek Harness 管理；Mimi Remote 不托管会话，也不需要登录 OpenAI 或 Anthropic 账号。
• 电脑必须保持开机、在线且不休眠，Agent 才能持续运行。
• 不在同一网络时，可以用 Tailscale 把手机和电脑放进同一私有网络；Mac、Windows、Linux 主机还提供实验性的 Tailcat 连接（默认关闭）。
• 新会话默认使用 Full File Access 权限模式，Agent 执行命令和修改文件时不会逐次询问；想逐条确认，可在 App 设置中把 Default permissions 改为 Ask for Approval。
• 请把 agentd 放在私有网络中，不要把它的明文 HTTP 端口暴露到公网。
• 它是一个会话客户端，不是远程 Shell，也不会在 iOS 上运行 Agent；Codex Desktop 普通「This Mac」模式下的会话不会共享。
• 手机 App 和电脑端软件均免费开源，无内购或订阅；模型调用计入电脑上的 Codex 或 Claude Code 账号。

本作品整理自 GitHub 开源项目 gaixianggeng/mimi-remote，原作者 @gaixianggeng。中文介绍由 AI 根据项目 README 整理，以原仓库为准。