Codex Relay

产品简介

Codex Relay 是一款开源的本地 AI 编程伴侣移动端应用，为 OpenAI Codex CLI 提供 iPhone 配套控制界面。它通过本地中继服务器将手机与电脑上的 Codex 会话打通，让开发者离开工位后仍能持续监控与操控 AI 编程进度，实现真正的远程编程控制体验。

核心功能

实时会话同步

手机端实时显示 Codex 正在执行的任务线程，包括生成代码、终端输出、错误提示与执行进度。无需盯着电脑屏幕，在手机上就能掌握 AI 编程的每一个关键节点。

指令响应与提示回复

当 Codex 需要用户输入或确认时，手机端可即时收到通知并直接回复指令，无需回到电脑前操作。这一功能对审批高风险操作（如文件写入、Shell 命令执行）尤为实用。

工作空间预览

支持从手机端预览当前工作空间状态，包括 Git 变更文件、本地 Web 服务输出、代码文件列表与终端界面，实现移动端对开发环境的全面可视化监控。

灵活通知机制

可配置两类推送通知：任务完成通知（Turn Complete）与操作审批通知（Action Required），确保不错过任何需要人工介入的节点，同时避免无意义的频繁打扰。

多平台覆盖

中继服务器支持 macOS、Linux 与 WSL2 环境，手机 App 支持 iOS 17 及以上版本。代码与凭证始终保留在本地机器上，手机仅作为远程操作终端，安全性有保障。

特色优势

安装极为简单：工作区运行一行 npx 命令即可启动本地中继服务器，手机扫码配对后即可使用。无需配置内网穿透、无需云端中继，代码永远不会离开本地机器。支持 Tailscale 等工具实现跨网络远程控制，即便手机与电脑不在同一局域网也能正常工作。

应用场景

• 远程 Code Review：出差或通勤途中随时查看 AI 修改的代码并给出审批意见
• 长时间任务监控：大型重构或测试运行时离开工位，但仍能接收完成通知与错误警报
• 审批安全关卡：高风险操作（如覆盖文件、执行系统命令）通过手机端审批，防止 AI 误操作
• 移动端持续开发：配合远程服务器上的 Codex，在任何地点继续推进开发任务

适用人群

使用 OpenAI Codex CLI 进行日常开发的程序员、AI 编程工具爱好者，以及需要在移动场景下保持对 AI 编码会话控制力的软件工程师与团队。

出品方

Codex Relay 为独立开源项目，非 OpenAI 官方产品，但与 Codex CLI 深度集成。代码与安装包均开源，遵循 MIT 许可证，社区可自由参与贡献与二次开发。