用 iPhone 指挥 Mac 上的 coding agent。十二个章节，把安装、配对、派活、审批和检查成果串成一个完整流程。
中文讲解 · 约 9 分 37 秒 · 内嵌字幕 · 可按章节跳转
欢迎使用 Runline。这份教程会带你从准备电脑和手机开始，完成配对、发起任务、处理授权，再到检查结果。先理解一件事：你在手机上告诉 agent 做什么、回答问题和验收成果；代码编辑和命令执行发生在你的 Mac 上。
你不需要在手机上输入大量代码，但仍然要决定任务范围和关键操作。新版画面直接录自 Runline 的 HTML 交互原型，保留原有界面和按钮。登录、配对和任务都是演示流程，没有连接真实账号，也不代表真实任务已经完成。
建议先准备一个练习项目，跟着步骤逐项检查。
先在官网下载并打开 Mac 版 Runline。第一次运行，按欢迎流程进入 agent 检测页；已经设置过，可以在设置的 Coding Agent 页面重新检查。Runline 会显示各个工具是否安装、是否可用。
选择你已经熟悉的一个 agent，例如 Claude Code 或 Codex。没有安装时，按页面提示安装；如果工具需要登录或配置模型服务，先完成它自己的设置。Runline 本身不提供模型，所以模型账号和相关费用由你选择的工具或服务决定。
不要在不知道原因时把所有权限一次打开。准备好之后，让 Mac 保持唤醒并连接网络。合上屏幕是否继续运行取决于机器条件，教程不建议依靠默认睡眠行为。
接着设置项目。在 Mac 的首次会话步骤中，选择你希望 agent 操作的项目目录，再选择刚刚准备好的 agent。建议使用一个名叫 runline-demo 的练习仓库，里面放一小段能够测试的代码，不要用正在处理紧急问题的生产项目。
注意选择的是项目根目录，里面应该能看到你的源代码和项目说明。目录名称相同，并不代表是同一个工作副本，所以检查完整路径。如果暂时没有需求，也可以先跳过首次会话，继续完成手机连接。
后续仍然可以新建会话。进入下一步之前，确认自己知道任务最终会在哪台 Mac、哪个目录里运行，这样手机上选择项目时就不会混淆。
现在连接手机。在 Mac 初次引导的连接手机页显示二维码，或者在设置的我的账号中查看配对卡。已经配对的 Mac 会显示已配对状态，不一定还有二维码，不要为录制或练习随意解除现有配对。
打开 iPhone 版，完成应用要求的引导和登录。从会话页底部的 Mac 状态栏进入，选择配对新的 Mac，再用 Runline 内的扫描器扫描电脑上的二维码。手机会显示 Mac 名称和四位码。
核对它们与电脑一致后，再点击确认配对。扫描二维码本身不等于已经授权连接。二维码的提示有效期为两分钟，过期会自动更新；失败时重新生成并扫描。
完成后，检查手机是否看到目标 Mac。
来到手机会话页，先确认底部选中的是正确的 Mac，然后点击右上角的加号。依次选择项目、agent，填写首条消息，最后点击开始。没有选到可用 Mac 时，新建入口可能不可用。
第一次任务建议先只读检查：请检查项目的重试逻辑，告诉我实现在哪个文件，暂时不要修改。等 agent 回答后，核对它看到的项目和文件是否正确。这样做可以在真正写代码之前发现目录选错或工具不可用的问题。
新建会话的首条消息也可以留空，进入会话之后再说需求。不要同时发很多不同目标；先做成一件小事，再扩展任务范围。
一个好的需求，最好包含目标、限制和验收标准。例如：把重试改成指数退避，最多五次；保留现有接口，补充边界测试；修改后运行相关测试，最后说明改了哪些文件，还有什么问题没解决。这比单说修一下更容易得到可以检查的结果。
如果练习项目没有重试逻辑，就换成它实际存在的小功能。你也可以附上报错截图，说明复现步骤和预期行为。任务进行中需要补充背景，继续在同一个会话里发消息。
需要改变整体方向时，先明确告诉 agent 当前方案哪里不对。会话之间不应假定自动共享上下文；换新任务时，把必要的背景再提供一次。
Agent 工作时会出现两类需要你回应的卡片。琥珀色是执行授权，蓝色是方向选择。画面里，agent 要搜索 SyncEngine 的代码。
先看命令原文，确认它是本次任务需要的只读搜索，再点允许这一次。授权卡收起之后，历史里会留下一条允许记录。随后，蓝色卡片问你三处都改，还是只改主路径。
读完每个选项的说明，选择符合需求的一项；选项不够时，也可以自己写一句。授权是在决定能不能执行，追问是在决定怎么做。不同 agent 的选项可能不同，以当前界面为准。
需要停止时，点击停止并等待 Mac 的状态反馈，不能把手机上的点击当作已经停止执行。
想离开应用也能知道任务进展，打开底部设置，再进入灵动岛与小组件。这里有三个实际开关：运行时显示灵动岛、展开后可直接批准，以及显示正在做什么。它们分别控制活动是否出现、是否展示批准操作，以及是否显示任务细节。
页面上方的胶囊是设置示意，不代表当前有一个真实任务正在运行。在支持的 iPhone 上，任务活动可以出现在灵动岛或锁屏；系统权限、设备型号和当前任务状态都会影响显示。桌面组件通过系统添加流程选择 Runline，可以看到运行中、等待决定和空闲等状态。
没有出现时，先检查应用开关和系统实时活动权限，再确认任务是否确实还在运行。
接下来是记忆。你在其他应用看到网页、截图或仓库链接，可以用系统分享，选择 Runline，补上一句备注并保存。回到记忆页，列表不仅有标题，还有摘要、标签和时间。
画面中先打开一条资料，查看摘要和自己的备注，再点拿去干活。这会把资料带回会话，成为输入区的一枚引用。另一条路是在会话里输入 at 符号，从面板中选择记忆，再告诉 agent 应该怎么用它。
例如，参考这份欢迎页资料优化排版，但保留自己的内容。收藏和引用是两个动作；保存过不等于 agent 自动知道。网页读不到全文时，补充关键文本或截图。
任务结束后，先读改动范围、测试命令和实际结果。完成两个字不是验收证据。Agent 发来的文件会留在会话里。
画面用两张 Mac 界面参考图演示：点开图片，可以分享、存到相册，或者存进记忆；保存后会有状态反馈。想查看正在运行的项目，回到会话，点右上角的窗口图标，打开预览中心。这里分成端口、文件和屏幕三个入口，当前都有 Pro 条件。
网页要求 Mac 上的开发服务已经启动，文件要求主机就绪，屏幕还需要 Mac 应用运行和相应权限。预览是临时查看；需要长期保留的成果，要保存或分享。消息的导出成图是 PNG，不是完整会话的 Markdown 文件。
熟悉基本流程后，就可以处理多个项目和会话。每次切换，先核对目标 Mac 与项目，避免把需求发到另一个仓库。不同工作分别建会话，会更容易判断每个 agent 正在做什么。
需要换模型时，打开会话输入区下方的模型入口。当前模型卡可以请求 agent 返回可用模型列表，也可以填写模型名切换，并不是所有 agent 都共享同一个固定下拉菜单。切换后等待主机反馈，确认实际生效。
长期复用的资料放进记忆，再按需引用。设置中的项目权限入口提示在 Mac 上修改；不要把手机端可见列表理解成已经获得对任意目录的访问权限。只给本次工作提供必要的项目和背景。
最后看几个常见问题。扫码不成功，检查二维码有效期、是否完成手机确认，以及两端网络。项目列表为空，检查 Mac 有没有配置项目、是否选中正确设备。
发消息后没有变化，先看消息状态、Mac 是否唤醒，再看有没有待处理审批或 agent 错误。网页预览打不开，确认开发服务正在运行、端口正确，以及账号具备相应功能。没有灵动岛，检查设备支持、系统权限、应用开关和活动任务。
Mac 离线时不能马上执行新工作；不要因为没反应就重复提交。最后记住，修改完成、运行测试、Git 提交、推送和部署是不同步骤。如果你需要后面几步，要明确提出并分别检查结果。
完成一次小而可验证的任务，就掌握了 Runline 最重要的工作方式。