# 在手机上新建 Claude Code / Codex 任务：人在路上也能让 agent 开工

> 通勤、排队时想到一个改动，不必等回到电脑前。这篇讲清楚怎么用 BotBus 在手机上给电脑里的 Claude Code、Codex 新建任务，选项目、模型和 worktree，以及它的前提和边界。

Canonical: https://botbus.io/blog/start-coding-task-from-phone  
Published: 2026-10-01  
Updated: 2026-10-04

## 先说结论

想在手机上让电脑里的 Claude Code 或 Codex 开始干活，关键是电脑上得有一个常驻的程序替你启动 agent，并把对话、审批和结果送回手机。BotBus 就是这样一个常驻电脑的应用：在 iPhone 上选好电脑、agent 和项目，写一句需求，点「开始对话」，电脑上就会起一个新会话，之后的进度、审批请求和回复都能在手机上看。前提是那台电脑开着、在线，并且对应的 agent 支持从手机新建。

## 为什么「新建」比「查看」更难

只看进度相对简单：电脑把任务列表同步出来就行。新建任务则要真的在电脑上执行一件事，需要回答几个问题：

- 在哪台电脑、哪个目录里跑？手机看不到你的文件系统，得由电脑把项目列表报上来。
- 用哪个 agent、什么模型？不同 agent 的启动方式完全不同。
- 跑起来之后，agent 要执行命令或改文件时找谁批准？你人不在电脑前，审批必须能回到手机。
- agent 做出来的截图、文件，你在手机上怎么看？

BotBus 的做法是让电脑端承担这些事：它本来就在观察本机的 agent，知道有哪些项目、哪些 agent 装好了，手机只需要把「在哪、用谁、做什么」发过去。

## 在手机上新建任务的步骤

![BotBus 手机上的新建对话页](https://botbus.io/shots/zh/phone-newtask.webp)

1. **打开新建对话**。电脑页右下角有「新建对话」按钮；最近项目的标题旁边有「+」，可以直接在那个项目里开；配对了两台以上电脑时，首页还有「快速对话」，顶上可以换电脑。
2. **选 agent**。页面上方是一排 agent，比如 Claude Code、Codex。默认选中你在电脑页正在看的那个。
3. **写需求**。在输入框里写这次要做的事。Codex 和 Claude Code 还可以附上图片，比如一张设计稿或报错截图；输入框下方有麦克风，可以用语音输入。
4. **选项目**。项目行里可以选这台电脑上已有的项目、「不在项目中」，或者「新建项目」——后者只在电脑设置了新项目的存放目录时出现，选中后填一个文件夹名，电脑会在那里建好文件夹再让 agent 进去。
5. **按需选模型和审批方式**。电脑报了可选模型的 agent，输入框右下角有「模型 · 强度」按钮，默认是 agent 自己的默认模型。选了项目时，面板里还有「审批」一栏，可以逐条确认，或者对这个项目开自动批准。
6. **点「开始对话」**。发出去后页面原地变成对话页，你可以看着 agent 开始工作。

如果发送失败，比如电脑刚好掉线了，页面会说明原因，「返回修改」后你写的字、选的图和项目都还在。

## 在 worktree 里跑，不碰你手头的改动

在已有项目里新建时，项目行下面默认勾着「在 worktree 中运行」。勾着的时候，电脑会在这个仓库里新建一个 git worktree 和一个 `botbus/` 开头的分支，让 agent 在里面改。这样有两个好处：你电脑上还没提交的改动不会被 agent 碰到，也不会被带进去；同一个仓库里同时开几个任务，彼此不会改到同一份文件。

agent 做完后，手机上「会话的改动」里能看到整个 worktree 相对分出来时的差异，底部有「合并到 <分支> 并结束会话」，会把这次会话压成一个提交合并回原来的分支，再删掉 worktree。有冲突、会话还在跑，或者 git 版本太旧时，合并会失败并说明原因，什么都不会删。不是 git 仓库、还没有提交、新建项目或者选了「不在项目中」时，没有这个开关，agent 直接在目录里跑。OpenClaw 也没有这个开关。

## 跑起来以后

从手机新建的任务，BotBus 会告诉 agent「用户不在电脑前」，并给它一套把截图、文件、链接分享回手机的工具，所以 agent 做出来的东西可以直接在手机上打开。Claude Code 和 Codex 在这一轮里要执行命令、改文件时，审批请求会发到手机，你可以允许或拒绝；agent 用选择题问你时，选项也会显示出来。跑完了，你可以在同一个对话里续聊，也可以中断它。

回到电脑前想接着在终端里干，BotBus 菜单栏里每个 agent 的详情会列出从手机发起的会话，「继续聊」会打开终端，用对应的命令接上，比如 `claude --resume` 或 `codex resume`。这一轮还在跑或在等手机回复时，这个按钮不可用，免得两边同时写同一个会话。

## 限制与边界

- **电脑必须在线**。查看已同步的任务不需要，但新建、续聊、审批和中断都要目标电脑开着并连上网。合上盖子睡眠的电脑收不到命令。
- **不同 agent 能力不同**。图片附件只有 Codex 和 Claude Code 支持。Pi 没有审批，Hermes 现在用的模式没有审批通道，手机上不会出现它们的审批卡片。某个 agent 在电脑上没装好、只能观察时，手机上不能用它新建。
- **自动批准要慎用**。它按项目生效，只作用于从手机发起的那一轮，提问照样会问你；开之前想清楚 agent 在这个项目里能碰到什么。
- **系统权限要在电脑上点**。macOS 的文件夹访问提示、提交签名需要的密码或硬件密钥，手机上都看不到，只能回到电脑处理。
- **内容是加密的，元数据不是**。任务、对话和命令在设备上加密后才经过中转服务器，服务器只见密文，但仍看得到设备编号、在线状态、更新时间和数据大小。开发预览不在端到端加密范围内。详见[端到端加密说明](https://botbus.io/docs/security)。

## 现在能不能用

电脑端有 Mac 版（菜单栏应用，需要 macOS 26 或更新）和 Linux 版（x86_64 / aarch64 的命令行程序，见[安装说明](https://botbus.io/docs/install-linux)），都可以在[官网下载](https://botbus.io/#download)。iPhone 和 Apple Watch 版已在 [App Store](https://apps.apple.com/app/id6815751066) 上架；Windows 与 Android 版在计划中。如果你更关心审批，可以看[在手机上审批 Claude Code](https://botbus.io/blog/approve-claude-code-from-phone)；同时用 Codex 和 Claude Code 的话，可以看[一起管理 Codex 和 Claude Code](https://botbus.io/blog/manage-codex-and-claude-code-together)。

## 常见问题

### 手机新建的任务和我在终端里开的有什么不同？

它就是电脑上一个普通的 agent 会话，跑在你选的目录里，用的是电脑上装好的 agent 和它的配置。区别是 BotBus 会告诉 agent 你不在电脑前，并给它分享文件回手机的工具；审批也会发到手机。

### 能在 Apple Watch 上新建任务吗？

可以。手表上也有新建任务的页面，需求可以口述，听写内容会接在已有内容后面。复杂的需求还是在手机上写更方便。

### 手机能看到我电脑上所有的目录吗？

不能。手机上能选的是电脑报上来的项目，也就是 agent 最近用过的项目，加上「不在项目中」和设置好的新项目目录，不会浏览你的整个硬盘。

### 新建任务会用掉我的订阅额度吗？

会，和你在电脑上直接用 agent 一样。BotBus 只是替你在电脑上启动 agent，用的是你自己的账号和额度，不额外代理模型请求。

### 合并 worktree 失败了怎么办？

合并失败时 BotBus 什么都不删，并说明原因，比如有冲突或会话还在跑。可以让 agent 先处理冲突，再点一次合并；也可以回到电脑上用 git 自己处理。
