IamV123/codex-android-control

一句话配置，让 Codex 帮你操作安卓手机。 只能操作你勾选的应用，限时授权，随时一键停止。
快速开始 ·
下载手机 App ·
遇到问题 ·
安全说明
它能做什么
| | |
| --- | --- |
| 📱 **替你动手** | 打开 App、点按、长按、输入后直接搜索/提交、上下滑动、返回。比如“打开抖音刷 5 个视频，每个停 2–5 秒”“在微博搜索杭州小吃，打开第二条”。 |
| 🖼️ **截图兜底** | 截图识别默认开启，只在读不到按钮时自动使用，可以在手机上取消勾选。同一界面不重复附图；截图会发送到电脑和 AI 服务。 |
| 🔒 **只碰你允许的** | 你在手机上勾选了哪些应用，就只能操作哪些；没勾选的既读不到、也点不了。默认一个都不授权。 |
| ⏱️ **限时、随时停** | 授权默认 1 天，到期自动结束。在 App、通知栏或电脑网页上都能一键停止；锁屏时自动暂停。 |
| 🔐 **加密直连** | 手机只和你自己的电脑通信，内容端到端加密。不用 VPN，不用连同一个 Wi-Fi，也不用 root 或 ADB。 |
| 🤖 **一句话配置** | 对 Codex 说一句话，电脑端自动装好；手机装好 App 后扫码就能用。 |
> 这是**实验测试版**。默认使用 Cloudflare 临时通道，电脑端重启后要在手机上重新扫码。操作时手机要保持解锁，电脑和手机都要联网。
最简单的用法（3 步）
**你需要**：一台 Windows 10/11 电脑，装好并登录了 Codex；一部 Android 13 或更新的手机，设置了锁屏密码。
**第 1 步 · 电脑**：把下面这句话发给 Codex。
> 按 https://github.com/IamV123/codex-android-control 配置
Codex 运行命令时会请求权限，点同意。几分钟后，电脑会自动打开配对网页 http://127.0.0.1:18765/（每台电脑都是这个地址，只能在本机打开），同时会有一个黑色窗口，**别关它**。然后**完全退出 Codex（包括右下角托盘图标），再重新打开**。
**第 2 步 · 手机**：用手机相机扫配对网页上的“**下载手机 App**”二维码，下载并安装 App。打开 App：
1. 点 **开启通知** → 允许。
2. 点 **开启无障碍服务**，找到“Codex 安卓助手（手动授权）”，打开开关。
3. **开关是灰色、弹出“受限设置”**（大多数手机都会这样）：点“确定” → 回到桌面，长按 Codex 安卓助手图标 → **应用信息** → 右上角 **⋮** → **允许受限制的设置** → 验证锁屏密码 → 再回到第 2 步打开开关。
**第 3 步 · 连接**：用手机相机扫配对网页上的“**配对二维码**”，选择用 Codex 安卓助手打开。勾选允许操作的应用，点 **确认并开始**，验证锁屏密码。看到 **已连接电脑** 就完成了。
**然后就可以用了**：在 Codex 里新建一个任务，直接说要做什么，例如：
- “用手机打开抖音，刷 5 个视频，每个停 2 到 5 秒。”
- “打开快手，进入当前视频作者的主页，打开他的第一个视频。”
- “打开微博，搜索 杭州小吃，打开第二条结果。”
**以后每次使用**：双击桌面上的“**启动 Codex 手机助手**”，手机重新扫一次配对二维码。
卡住了？看遇到问题怎么办，或者照详细教程一步一步对照。
给 Codex 的配置说明
> 用户让你“按本仓库配置”时，照下面做。不需要你操作手机。
1. 在 PowerShell 中运行下面 4 行。需要联网，会写入 %USERPROFILE%\CodexAndroidControl 和 %USERPROFILE%\.codex\config.toml，还会在桌面创建快捷方式。
- 沙盒拦截网络（例如报“不知道这样的主机”）、重定向 TEMP，或不能写用户目录时：申请提升权限（escalated），然后**原样**重新运行这 4 行。
- 不要改安装目录，也不要换下载地址或镜像。
2. 安装大约需要 2–6 分钟，脚本会一直等到手机通道真正就绪才结束。npm 输出的 npm warn Unknown user config 之类警告不影响安装，不用处理。看到“安装完成，电脑端已就绪”后，把输出里“接下来”那几条**原样**告诉用户。
3. 安装会打开一个电脑端窗口，**不要关闭它**。也不要把配对码或二维码内容发到聊天里。
4. 出错时，把错误原文告诉用户，并对照本页“遇到问题怎么办”。重新运行同样的命令是安全的，相当于升级或重装。
5. 用户重新打开 Codex 后，手机工具名都以 phone_ 开头，直接调用即可，不要写脚本。
详细教程（手动安装，或出问题时对照）
不想用 Codex 自动配置，或者自动配置出了问题，就照下面一步一步做。每一步都写了“做对了会看到什么”；看到的不一样，就去遇到问题怎么办查。
- 手机 App：codex-android-control.apk
- 电脑端：最新版本页面，下载名字以 -desktop.zip 结尾的文件
0. 先确认你有这些
- 一台 **Windows 10 或 Windows 11** 电脑，已经装好 **Codex** 并登录。
- 一部 **Android 13 或更新** 的手机。查看方法：手机“设置 → 关于手机”，找“Android 版本”。纯血鸿蒙（HarmonyOS NEXT）不能安装 APK，用不了。
- 手机已经设置了 **锁屏密码**（数字、图案或密码都行）。没设的话：手机“设置 → 安全/密码与安全 → 锁屏密码”先设一个。
- 电脑和手机都能上网。**不需要连同一个 Wi-Fi，不需要 VPN。**
1. 电脑：Node.js（一般可以跳过）
电脑上没有 Node.js 时，第 4 步的 Start-Desktop.cmd 会自动下载一个免安装版，放在电脑端文件夹里，不需要管理员权限。所以这一步一般可以跳过。
想自己装也可以：打开 ，下载带 **LTS** 字样的 Windows 安装包（.msi），一路点 **Next → Install → Finish**。
2. 电脑：下载并解压电脑端（只做一次）
1. 打开最新版本页面，下载名字以 -desktop.zip 结尾的文件。浏览器提示“不常下载”时，选“保留”。
2. 找到下载好的 zip 文件，**右键 → 全部解压缩**，解压到一个固定的位置，例如 D:\CodexAndroid。
- 一定要先解压，**不要在 zip 里面直接双击运行**。
- 文件夹路径里不要有英文单引号 '。
- 解压后不要再移动这个文件夹。如果移动了，要重新做第 3 步。
3. **做对了**：打开解压后的文件夹，能看到 Start-Desktop、Connect-Codex、src 等文件。电脑如果不显示扩展名，Start-Desktop.cmd 会显示成 Start-Desktop，类型是“Windows 命令脚本”，这是正常的。
3. 电脑：把手机工具接入 Codex（只做一次）
1. 在解压后的文件夹里双击 **Connect-Codex.cmd**（不是 .ps1，.ps1 双击只会用记事本打开）。
- 弹出“Windows 已保护你的电脑”：点 **更多信息 → 仍要运行**。
- 弹出“是否要运行此文件”：点 **运行**。
2. **做对了**：黑色窗口显示 完成：已把手机工具加入 Codex。请完全退出 Codex（包括右下角托盘图标）后重新打开。（如果显示 已配置过，无需重复运行。 也是对的）。按任意键关闭窗口。
3. **完全退出 Codex**：关掉 Codex 窗口，再到屏幕右下角托盘（时间旁边的 ^）找到 Codex 图标，右键退出。然后重新打开 Codex。
4. 电脑：启动电脑端（每次开电脑后都要做）
1. 双击 **Start-Desktop.cmd**。第一次运行会自动下载需要的组件，可能要几分钟，窗口里滚动文字是正常的。
2. 窗口显示 正在连接手机通道，约需 1–3 分钟，请不要关闭此窗口…，耐心等。
3. **做对了**：窗口显示 已就绪：配对网页 http://127.0.0.1:18765/ …，浏览器自动打开“Codex 安卓助手”网页，上面有两个二维码：**配对二维码**（手机 App 装好后扫这个）和 **下载手机 App** 的二维码，还有一段配对码和一行“连接地址：https://….trycloudflare.com”。浏览器没自动打开，就自己在浏览器地址栏输入 http://127.0.0.1:18765/。
4. **这个黑色窗口一直开着，不要关**。关了手机就断开。使用期间也不要让电脑睡眠（“设置 → 系统 → 电源”里把睡眠改成“从不”）。
5. 网页上的“新配对有效期”默认 **1 天**，一般不用改。
6. **配对码和二维码等于密码**，不要截图发给别人，不要发到群里。
5. 手机：安装 App（只做一次）