如何用手机运行 Codex 终端：远程 AI 开发新体验
OpenAI Codex 是一个强大的 AI 编程助手，可以直接在终端中使用。但你是否想过，在没有电脑的情况下， 用手机或平板远程运行 Codex？Agent Connect 让这一切成为可能——通过手机浏览器就能启动和控制 Codex 会话， 享受与桌面端一致的编程体验。
什么是 Codex 终端？
OpenAI Codex 是基于 GPT 系列模型的 AI 编程工具，它可以在终端中理解自然语言指令， 生成代码、解释代码逻辑、调试错误、编写测试等。与 Claude Code 类似，Codex 也是运行在终端中的 AI 编程助手。
Codex 的一些典型用途：
- 用自然语言描述需求，Codex 自动生成代码
- 解释复杂的代码逻辑和算法
- 为现有代码编写单元测试
- 调试和修复代码中的 Bug
- 代码重构和优化建议
- 生成文档和代码注释
但 Codex 通常需要在电脑终端中运行，这限制了它的使用场景。Agent Connect 打破了这一限制， 让你可以在任何有浏览器的设备上使用 Codex。
如何用手机远程运行 Codex
第一步：在被控机器上安装并登录 Codex
首先，确保你的电脑上安装了 Codex CLI 并完成了登录：
# 安装 Codex CLI
npm install -g @openai/codex
# 登录 Codex
codex --login
# 验证安装成功
codex --version第二步：在被控机器上运行 Agent Connect Edge Agent
下载并运行 Edge Agent，它将建立从被控机器到云端 Hub 的反向连接：
# 下载 Agent Connect
git clone [项目地址]
cd web && bun install
# 启动 Agent 连接到云端 Hub
bun run agent --hub wss://yanlin-ai.cn/api/agent启动成功后，Agent 会显示注册信息，表明已在线等待控制指令。
第三步：手机浏览器连接并启动 Codex
在手机浏览器中打开控制台：
- 访问
https://yanlin-ai.cn/agentConnect - 登录你的 Agent Connect 账号
- 在机器列表中找到已连接的设备
- 点击"Codex"终端按钮
- 指定工作目录（cwd），启动 Codex 会话
- 等待连接建立，即可在手机上使用 Codex
Agent Connect 中的 Codex 会话机制
Agent Connect 对 Codex 的支持采用了独特的线程复用机制：
- 线程复用：同一个 Codex thread 会顺序排队执行任务，确保代码上下文的连贯性
- 流式事件：Codex 的思考过程、代码生成等事件会实时推送到手机
- 规范化输出：所有事件规范化为统一的
ChatEvent格式，体验一致 - 后台排队：你可以在手机上提交多个任务，它们会在后台依次执行
这意味你可以把 Codex 当作一个"异步编程助手"——在手机上提交任务，关掉浏览器， 过段时间再回来看完成结果。Codex 会在被控机器上持续工作。
手机 Codex 的典型使用场景
💼 商务出行
出差途中在手机上将代码审查任务提交给 Codex，到达酒店时审查结果已经完成。
🏠 居家办公
躺在沙发上用平板电脑浏览 Codex 生成的代码，轻松完成代码审查工作。
🎓 学习编程
用手机向 Codex 提问编程问题，学习新的编程概念和技术，随时随地进行编程学习。
⚡ 快速原型
灵感来临时，用手机快速向 Codex 描述想法，生成代码原型，保存到服务器后续完善。
Codex 远程使用最佳实践
- 指定明确的工作目录：启动 Codex 时指定项目目录（cwd），确保上下文准确
- 利用排队机制：可以一次性提交多个任务，Codex 会按顺序依次处理
- 注意会话保活：关闭浏览器后，会话保活 180 秒，在此期间重进即可续聊
- 配合电脑使用：电脑上准备代码和 Prompt，手机上控制和查看结果
- 多人共享机器：团队成员可以共享一台高性能开发机，各自用手机连接自己的会话
常见问题
手机远程使用 Codex 需要 OpenAI API Key 吗？
不需要。Agent Connect 复用被控机器上已经登录的 Codex CLI 登录态，无需提供 API Key。
Codex 和 Claude Code 能同时使用吗？
可以。Agent Connect 同时支持 Claude Code 和 Codex，你可以在控制台中任意切换，互不干扰。
手机上的 Codex 体验和电脑上一样吗？
核心功能完全一致：流式输出、代码生成、对话交互。唯一的区别是手机屏幕较小，建议使用横屏模式或平板设备。
被控机器关机了怎么办？
被控机器离线后，Agent Connect 控制台会显示该机器已断开连接。重新开机并启动 Edge Agent 后即可恢复。