启动电脑端
在你的项目目录运行 Farprompt Bridge，让电脑上的 Agent 保持工作。
QUICK START
扫码连接，控制你的 Agent。
用 Android 手机远程控制 Codex 与 Claude Code：启动电脑端 Farprompt Bridge，扫码配对后，查看会话、发送任务，并处理 Agent 发出的审批请求。
开始前，请在电脑上安装 Node.js，以及已安装并登录的 Codex CLI；使用 Claude Code 时，还需安装并登录 Claude CLI。手机和电脑需要能访问配对信息中的同一个 Relay 地址，电脑上的 Agent 与 Bridge 应保持运行。
扫码配对
打开 Farprompt Android App，扫描电脑端显示的二维码。
开始控制
选择会话，发送第一条任务；需要确认时，直接在手机上审批。
$ cd farprompt-bridge
$ npm install
$ npm start
$ npm install
$ npm start
Bridge 在你的电脑上执行 Agent；Relay 只负责连接手机和电脑。首次配对后，可信设备可以在正常重连时继续使用。
扫码连接与手机审批常见问题
扫码后无法连接怎么办？
先确认 Bridge 正在运行，再检查手机能否访问二维码中的 Relay 地址。二维码里的 127.0.0.1 在手机上指向手机自身；本地联调请使用手机可以访问的电脑局域网地址。
为什么手机里没有 Claude Code？
Bridge 按电脑实际安装情况检测 Agent。在电脑终端运行 claude --version 检查 CLI 是否可用，并确认 Bridge 的启动环境能找到它，再重新启动 Bridge。
为什么没有手机审批提示？
确认 Agent 是否真的发出了审批请求。Claude Code 已允许的工具可能直接执行；手机审批不能覆盖本机的权限模式和工具允许规则。