中文 | English
Remote Codex 是原生 Codex CLI 的 Linux 桌面外壳，同时支持通过飞书远程操控。
仅支持 Linux。 发行版支持
x86_64和arm64架构。 使用 Remote Codex 前，请先安装原生 Codex CLI并完成登录。
- 只做外壳，不替代原生 Codex。 TUI、命令、权限和会话仍由原生 Codex CLI 提供。
- 随时随地开发。 从飞书发送任务，在一张持续更新的卡片中查看进度，告别零散消息刷屏。
- 快速连接飞书。 在桌面端设置中通过内置授权流程即可连接机器人。
- 技术内容清晰易读。 自动识别并在本地渲染 LaTeX，也支持文本与行内公式混排的短行。
- 内置文件传输。 报告、补丁、图片及其他工作区文件可直接返回当前飞书会话。
远程任务的进度、操作和最终回答都会呈现在同一张实时更新的卡片中。
公式区域会在本地自动识别并渲染，再以清晰的图片嵌入飞书卡片。
部分原生 Codex 页面会映射为可交互的飞书卡片。卡片操作仍然驱动同一个可见的 Codex TUI，不会替代或重新实现底层工作流。
| 权限模式 | 恢复会话 | 会话状态 |
|---|---|---|
 |
 |
 |
/permission |
/resume |
/status |
环境要求：
- 使用 glibc 2.31 或更高版本的 Linux 发行版，例如 Ubuntu 20.04 及以上版本。
PATH中已存在原生codex命令，并且已完成登录。
根据 dpkg --print-architecture 的结果下载对应软件包：
| 架构 | 下载 |
|---|---|
amd64 |
remote-codex-linux-amd64.deb |
arm64 |
remote-codex-linux-arm64.deb |
安装下载的软件包；ARM64 设备请替换为对应文件名：
sudo apt install ./remote-codex-linux-amd64.deb在项目目录中启动 Remote Codex：
cd /path/to/project
remote-codex可在 设置 → 软件更新 中检查并安装更新。
卸载：
sudo apt remove remote-codex所有软件包可在 GitHub Releases 页面查看。
- 打开 Remote Codex 的 设置。
- 选择 连接飞书。
- 打开或扫描授权链接。
- 将创建好的机器人加入需要使用的会话。
来自飞书的消息会驱动 Electron 中同一个可见的 Codex 会话。常用远程控制命令包括
/status、/resume、/permission 和 /stop。/delete、/logout、/exit
等具有破坏性的原生命令无法通过远程执行。
默认情况下，在桌面客户端中输入的任务只保留在本地。可在设置中启用 将新桌面任务发送到飞书，将新提交的提示词及其运行回复转发到飞书。即使关闭此选项， 桌面任务仍然可以使用文件传输功能。
Remote Codex 支持同时打开多个桌面窗口。多开时，工具栏会显示 将此窗口连接到飞书。最新打开的窗口默认被选中；选择其他窗口后，唯一的飞书连接会 转移到该窗口及其 Codex 会话。
飞书输入 ──→ RemoteSessionController ──→ 可见的 Codex PTY
│
Codex rollout JSONL ──→ 语义事件 ──→ 一张飞书卡片
远程输入控制的是 Electron 终端使用的同一个原生 PTY。正常进度和最终回答来自当前任务
对应的 Codex rollout JSONL，而非对终端画面进行文本抓取。终端快照只用于 /resume、
/permission 等原生页面和授权提示。
开发环境需要 Node.js 22.12 或更高版本：
npm ci
npm start运行完整测试和语法检查：
npm run check使用 npm run api 可启动可选的本地无头 API。
运行时配置保存在 ~/.remote-codex.json。支持的配置结构请参阅
config.example.json。