启流 AI/ CODEX PILOT
启流 Codex Pilot 下载中心

手机发起,
电脑执行。

用 Android 手机远程管理自己电脑上的 Codex —— 并且能直接看到、直接操作电脑桌面。

连接自己的 Mac 或 Windows 电脑后,可以发送文字、语音或文件,查看任务排队与执行进度;也可以进入实时画面,用手指拖动、缩放、点击和打字,就像坐在这台电脑前面。真正干活的位置仍然是你的桌面端,代码和对话都留在本机。

版本 5.0.78 支持 Mac / Windows 实时画面 硬件解码 电脑端账号 可切换 包名 com.langchao.codexcontrol.external

第一次装建议直接用上面的「一键部署」:引导器自己会下载、校验并装好电脑端服务,界面上有进度条和失败原因。
Windows 若弹出「Windows 已保护你的电脑」,点 更多信息 → 仍要运行(安装包没有买商业代码签名)。
Mac:系统会拦「从网上下载的没签名程序」,弹框里只有「完成」,没有「打开」,右键也不行。最省事的是在「终端」里粘贴这一行,下载、解压、启动一次做完:cd ~/Downloads && curl -fLO https://pilot.qiliuai.com/CodexPilot-Setup-Mac.zip && unzip -oq CodexPilot-Setup-Mac.zip && zsh CodexPilot-Mac/CodexPilot-Setup-Mac.command不想用终端也行:解压后双击 CodexPilot-Setup-Mac.command → 弹框点「完成」 → 打开「系统设置 → 隐私与安全性」,在「安全性」一栏点「仍然允许」 → 回到文件夹再双击一次。包名 com.langchao.codexcontrol.external,不会覆盖内部版。每台电脑会生成独立 token,请勿公开分享。

// 连接方式

手机、启流服务、你的电脑。

手机通过启流中继找到你的电脑,指令在电脑上执行,实时画面和结果回传到手机。手机和电脑不必在同一个 Wi-Fi。

▣手机 App发起指令
≈启流中继转发加密请求
⌘你的电脑Codex 执行
// 远程画面

手指在手机上,操作的是电脑。

底部「远程」里选一台电脑,点「进入桌面」即可看到实时画面并直接操作。画面走专用视频通道、手机端硬件解码,静止画面几乎不产生流量。

单指拖动 = 移动画面任何倍率下单指都只移动画面,不会误碰电脑。
双指捏合 / 双指轻点捏合缩放并以两指中心为缩放中心;双指轻点一键把画面复位居中。
长按后拖动 = 按住鼠标长按约 0.4 秒再拖,等于按住电脑上的左键拖动,用于框选文字、拖窗口。
指针两种模式「隐藏指针(触摸)」手指点哪儿点哪儿;「显示指针(鼠标)」看清光标停在哪里。
键盘自动让位屏幕键盘呼出时画面自动让位,横屏下也能边看画面边打字。
帧率 / 清晰度 / 画面模式「⋯」里可选 30 / 60 / 120 帧,流畅或清晰,匹配铺满或完整显示。

画面目标可在「Codex 窗口」与「整张桌面」之间随时切换,顶栏只留 ‹ / Codex / ⋯ 三颗按钮。macOS 需要先授予“屏幕录制”权限,否则画面里只有桌面壁纸。

// 账号

用启流的服务,或者你自己的 ChatGPT 账号。

电脑端的 Codex 默认走启流,装好就能用。想换成自己的 ChatGPT 账号,在手机上点两颗按钮就行,随时能切回来 —— 不用碰命令行,也不用自己改配置文件。

用我的账号暂停启流守卫,把 config.toml 根部启流选的那几行模型选择收起来(你自己写的配置一律不动,动手前先备份),并把桌面端登录用的那把 API KEY 备份后移走。做完打开电脑上的 ChatGPT 桌面端,用自己的账号登录即可。
改回启流把上面几件事原样倒回去:放回备份的登录凭据、把模型选择写回 config.toml 根部、恢复守卫。手机刷新一下就能照常用,电脑端不用重启。
动手前先给你看状态弹窗会先摆出这台电脑当前的样子(含「桌面端登录:API KEY 模式 / 你自己的 ChatGPT 账号」),确认后才动手;改回启流不会覆盖你自己刚登上的账号。

位置:「电脑与连接」页里逃生通道那两行的第二行。电脑端服务需要是 2.34.56(Mac)/ 2.203(Windows) 或更新;版本偏旧时这一行不会出现(不是灰掉,是不显示),重跑一次安装程序即可。

// 首次安装

四步跑起来。

电脑端先装服务,手机端后装 App。全程大约十分钟,中途需要确认系统权限与 Codex 登录。

01
装好电脑端服务

最省事:回到页顶点「Windows 一键部署」或「Mac 一键部署」,按提示走完即可(点错系统也没关系,引导器会告诉你)。想手动来:下载并解压整套部署包,内含手机 APK、Mac / Windows 服务端、图文教程,以及「专属接入连接器」(需要异地连接时才用)。

02
在电脑上运行安装脚本

Mac 双击 install-mac.command,装完到「系统设置 → 隐私与安全性 → 屏幕录制」授权(不授权手机上看不到真实画面);Windows 以管理员身份运行 install-windows.ps1。

03
安装包内的手机 APK

安装后打开 App,允许通知与网络权限;系统可能提示"未知来源",确认继续即可。

04
扫码或填写地址完成连接

把电脑端显示的地址和 token 填入 App,点"保存并连接"。

 快速自检
Mac     curl -s http://127.0.0.1:8787/api/node-status Windows curl -s http://127.0.0.1:8787/api/node-status 看到 "ok": true 说明电脑端服务已经起来了。
// AI 自部署

把部署交给电脑上的 AI。

把公开提示词交给外部电脑上的 AI,让它自动下载、校验、安装、修复并打开扫码页。系统权限、Codex 登录和扫码仍需要你本人确认。

// 异地连接

不在同一个 Wi-Fi 也能连。

同一个 Wi-Fi 下不用做任何额外设置:手机直接用电脑的局域网地址连就行。人不在同一个网络(出差、用 4G)时,有两条路可选。

A
专属接入地址(推荐,不用装第三方软件)

联系我们开通之后,你会拿到一个专属网址和一串连接器令牌。把这两项填进部署包里的 tunnel/access-info.txt,再运行 tunnel/windows/install.cmd(Windows,以管理员身份)或 tunnel/macos/install.command(Mac)。装完开机自动运行,手机 App 连接页填那个专属网址即可。

B
Tailscale(自备,需要自己注册账号)

在电脑和手机上分别安装 Tailscale 并登录同一账号,再用电脑的 Tailscale 地址连接。以下为官方下载入口,按系统选择。

// 教程与校验

部署、使用、排障。

先看部署教程装好电脑端(Mac 记得授权屏幕录制),再看使用教程熟悉远程画面、工作包、小对话、账号切换、语音和任务中心。遇到问题先查校验信息确认版本。