# 离开电脑后，怎么在 iPhone 上查看 Codex 任务的进度

> Codex 长任务还在电脑上跑，人却要出门？这篇讲清楚怎么在 iPhone 上看到本机 Codex 的进度、对话和改动，什么时候会收到通知，以及哪些情况只能看不能操作。

Canonical: https://botbus.io/blog/monitor-codex-tasks-from-iphone  
Published: 2026-09-28  
Updated: 2026-10-04

## 先说结论

Codex 的长任务动辄跑十几分钟甚至更久，人离开电脑后，最想知道的就三件事：它还在跑吗、卡在哪里了、跑完了没有。BotBus 的做法是在 Mac 上常驻一个菜单栏应用，只读地读取本机 Codex 的会话记录，把任务状态、最近一条输出和按需取回的完整对话同步到 iPhone 和 Apple Watch。你不用改变启动 Codex 的方式，终端里、Codex 桌面 app 里开的会话都会出现在手机上。

这篇说的是跑在你自己电脑上的 Codex。下面分步讲它怎么工作、手机上能看到什么、什么时候会提醒你，以及哪些情况只能看不能操作。

## 为什么“看进度”本身就值得单独解决

很多人第一反应是“我要的是远程控制”。但实际用下来，大部分时候你并不需要插手：agent 在按计划改代码、跑测试，你只是想确认它没有停在某个审批上，也没有在错误的方向上越走越远。如果每次确认都得回到电脑前，要么你一直惦记着，要么任务在你看不见的地方白等了半小时。

所以看进度要做到三点：第一，状态要准，运行中、等审批、等回复、已完成、失败要分得清；第二，内容要够，光有一个“运行中”没用，得能看到它最近在说什么、改了哪些文件；第三，打扰要少，只在需要你的时候提醒，而不是每一步都弹通知。

## BotBus 是怎么拿到 Codex 进度的

### 只读观察本机的 Codex 记录

Codex 会把会话线程记在本机 `~/.codex` 目录下的 SQLite 数据库里。BotBus 大约每 2 秒读一次这些数据库，从里面整理出任务列表：标题取线程名或第一条用户消息的前 80 个字，另外带上最后一条 agent 消息的前 500 个字和当前状态。它**只读不写**：不改 `~/.codex`，不往 Codex 里塞任何东西，所以不会影响你正在用的 Codex。如果你把 Codex 数据放在别的目录，可以在 BotBus 设置里改。

### 同步到手机

整理好的任务按电脑和项目分组，经中转服务器同步到手机。手机端用长轮询拉取最新状态，打开 app 就是当前的样子。多台 Mac 可以配对到同一部手机上，每台电脑的任务分开列出，不会混在一起。

### 按需读完整对话

列表里只放摘要。想知道 agent 这一路具体做了什么，点进任务可以取回完整对话：BotBus 从 Codex 的历史库里读出来，加密后交给手机。这一步只在你点开时发生，不会把所有对话一股脑传上去。对话里你发过的图和 Codex 生成的图也能看到；浏览器、模拟器这类工具截图只保留一行文字说明。

### 看代码改了什么

如果任务所在的项目是 git 仓库，手机上的任务详情还能看到这个项目里还没提交的改动：先是文件清单和增删行数，点进单个文件可以看新旧对照的差异。只有确实有改动时才会出现这个入口。这对判断“它是不是走偏了”非常有用，比只看文字总结直观得多。

## 什么时候会提醒你

BotBus 的通知分四类：有任务等你审批、等你回复、任务完成、任务失败。其余时间它不打扰你，状态变化只在你打开 app 时看到。

几个细节：通知要在手机上允许推送权限才能收到；app 在前台时不会弹横幅，因为你本来就在看；Apple Watch 上会先显示一句固定的提示，打开手表 app 后再解密显示具体内容。点开通知会直接跳到对应的任务。

电脑上也有一个一眼能看的地方：菜单栏图标会随状态变化，任务在跑时眼睛左右扫视，有任务等审批时两盏头灯交替闪，刚跑完时会笑一下，右边还会显示待处理的数量。

## 看完之后还能做什么

看进度是起点。在条件满足时，手机上还可以直接处理：

- **审批**：Codex 要执行命令、改文件或申请权限时，手机上会出现审批卡片，可以允许或拒绝。Codex 通过提问让你选择时，选项也会显示在手机上。
- **续聊**：给这个会话补一句话，比如“测试挂了先别提交”。续聊时还能换模型和思考强度。
- **中断**：发现方向不对，可以直接停下这一轮。

这些操作都要求那台电脑在线，并且由对应的连接器支持。Claude Code 的审批流程有所不同，见[在手机上审批 Claude Code](https://botbus.io/blog/approve-claude-code-from-phone)。

### Codex 桌面 app 里开的会话

Codex 桌面 app 自己会拉起一个进程来管会话。想让手机和桌面同时操作同一个会话，第一次接入时先完成桌面上的当前任务、退出 Codex，然后从 BotBus 菜单栏「本机 Agent」里 Codex 那一行点「启动 Codex」。这样启动的桌面 app 和 BotBus 共用同一条通道，审批以先回答的一端为准，你在手机和电脑上看到的是同一个会话。

如果桌面 app 已经从 Dock 独立打开，BotBus 会在同一位置显示感叹号按钮，说明手机续聊的限制，并提供「立即重启 Codex」。重启会中断正在跑的任务，所以它会先提醒你。

## 限制与边界

- **看不需要电脑在线，操作需要。** 已经同步的任务，电脑离线后仍留在手机上，只是标成离线；审批、续聊、新建和中断都要那台电脑在线。
- **有些任务只能看。** 会话正被另一个 Codex 进程持有时，手机续聊会提示 `already has an active writer`。这时先完成电脑上的任务并退出那个 Codex，再从 BotBus 菜单栏启动它，回到手机上打开原任务继续即可，不用新建会话。
- **不是逐秒直播。** 列表大约每 2 秒刷新一次，标题和最后一条输出都是截断后的摘要，想看全貌要点进对话。
- **通知取决于系统。** 推送能不能到，还取决于手机的通知权限和系统设置。
- **内容端到端加密，但不是什么都藏得住。** 任务标题、对话、改动和通知正文都在设备上加密后才发出，钥匙只经电脑屏幕上的配对二维码交给手机。服务器仍然看得到设备编号、在线状态、更新时间和数据大小，任务编号的前缀也能看出它来自 Codex。细节见[端到端加密说明](https://botbus.io/docs/security)。

## 现在能不能用

电脑端有 Mac 版（菜单栏应用，需要 macOS 26 或更新）和 Linux 版（x86_64 / aarch64 的命令行程序，见[安装说明](https://botbus.io/docs/install-linux)），都可以在[官网下载](https://botbus.io/#download)；上文的菜单栏图标与「启动 Codex」说的是 Mac 版。iPhone 和 Apple Watch 版已在 [App Store](https://apps.apple.com/app/id6815751066) 上架；Windows 与 Android 版在计划中。除了 Codex，BotBus 也接入了 Claude Code、Hermes、Pi、OpenClaw 和 DeepSeek Harness，多种 agent 的任务可以在同一个手机 app 里看。

## 常见问题

### BotBus 会改动我的 Codex 数据吗？

不会。它只读 `~/.codex` 里的数据库来整理任务列表，不写入、不改结构。从手机发起的操作走 Codex 自己的 `codex app-server` 接口，而不是直接改数据库。

### 我在终端里跑的 `codex` 也能在手机上看到吗？

能。只要会话记录写进了本机的 Codex 数据目录，无论从终端还是桌面 app 开的，都会出现在任务列表里。

### 电脑合上盖子睡眠了，手机上还能看到什么？

能看到睡眠前最后同步的状态，电脑会被标成离线。Codex 本身在电脑睡眠时也不会继续跑，醒来后状态会接着同步。

### 能在 Apple Watch 上看 Codex 进度吗？

可以。手表从 iPhone 同步配对信息后自己联网，能看任务列表、处理审批和回复，不用每次都掏手机。

### 手机上会看到别人的任务吗？

不会。只有你用配对二维码配对过的设备才拿得到钥匙，任务只在你自己的这组电脑、手机和手表之间同步。
