Skip to content
EasyCodex 标识
Local-first Codex operations
EasyCodex

Codex 在电脑上运行,控制权交给手机。

EasyCodex 把你的电脑变成本地 Codex 中继,并给 Android 手机提供一个真正可用的控制台:实时任务、审批、diff、附件、CLI 窗口和完成通知都能在手机上处理。

Android 控制端Electron 桌面中继Node Agent RelayCodex app-server
EasyCodex 桌面中继和 Android 控制端界面
为坚持本地代码工作流的开发者而设计WindowsmacOSLinuxAndroidCodex CLI

不只是聊天壳,而是 Codex 控制平面

产品能力

原本必须回到电脑上处理的关键动作,现在可以在手机上完成。

EasyCodex 让 Codex 进程继续运行在你的工作站上,同时把任务状态、审批、文件变更和运行时控制暴露给移动端。手机可以跟进长任务,在 Codex 忙碌时排队追问,处理审批,查看 Git 输出,并接收完成通知。

会话控制创建、恢复、中断、停止、归档并重新打开 Codex 线程。
审查闭环查看计划、命令、文件改动、Git 状态、完整 diff 和单文件预览。
上下文输入发送文本、图片和文件;附件保存在所选工作区内。
移动 CLI打开独立 `codex exec` 窗口,并控制 cwd、模型、推理强度和沙盒。

EasyCodex 如何运作

EasyCodex 运行时架构图
1. 配对客户端

桌面中继显示二维码和 `easycodex://connect` 深链接。Android 应用保存 relay URL 和 API key,并通过认证 WebSocket 连接。

2. 选择可信工作区

文件、Git、CLI 和 agent cwd 操作只允许发生在已知工作区根目录或显式信任的目录内。

3. 启动或恢复 Codex

智能体会话由中继启动 `codex app-server`,初始化线程,并把 Codex JSON-RPC 事件转成稳定的移动端/桌面端消息。

4. 保持任务推进

审批、用户输入、计划审查、命令输出、文件变化和排队追问会持续流式回传到手机和桌面工作台。

适合什么场景

远程监督离开电脑也不丢控制权。

Codex 继续在工作站上运行,到了决策点时你可以用手机审批或调整方向。

本地安全边界不需要托管项目副本。

手机不会拿到仓库副本,它只连接你自己的中继,由中继执行工作区边界校验。

智能体工作流看到的不只是聊天文本。

EasyCodex 会呈现计划、子代理活动、命令输出、diff、Git 状态、CLI 窗口和未读完成状态。

安全模型

API key 保护的中继

WebSocket 客户端和健康检查都需要 relay API key。

工作区绑定操作

文件、Git、CLI 和 agent runtime 动作都会校验是否位于允许的根目录内。

本地运行时状态

Relay 状态位于 `~/.easycodex/`,Codex 状态仍保留在 `~/.codex/`。

开始使用

下载桌面中继,并配对你的 Android 控制端。

安装桌面中继,扫描二维码,选择工作区,然后开始用手机控制 Codex 会话。

Local-first control for Codex agents.