用 WebMux 远程运行 Codex CLI

1. 安装并认证 Codex CLI

在运行 WebMux 的机器上按 Codex CLI 官方说明（外部链接） 安装，并以运行 WebMux 的服务用户身份完成认证。WebMux 不会自动安装或认证 CLI，也不代管模型密钥。

要使用聊天视图，还需在服务器上另外安装第三方 ACP 连接器 codex-acp：

npm install -g @agentclientprotocol/codex-acp

2. 使用预置启动配置

交互式命令

codex

预置参数

--dangerously-bypass-approvals-and-sandbox

在“新建会话 → 预先输入”选择该启动配置，指定目录或工作树，再创建会话。也可以在服务所在机器的终端里启动，Ctrl+] 分离后到手机上继续：

webmux run -- codex --dangerously-bypass-approvals-and-sandbox

已有安装升级时不会改写 launch-configs.json；列表里缺少该 CLI 时，在“设置 → 启动配置 → 新建启动配置”填写名称和上面的命令。预置命令用“加载 shell 启动文件”包装，以读取 ~/.bashrc 或 ~/.zshrc 中的 PATH。 已有安装

3. 终端、混合会话与提醒

终端

持久 PTY 终端：浏览器断线不会结束进程，可重新连接并回放缓冲；服务重启会结束会话。

混合会话（聊天 ↔ 终端）

支持。预置配置已勾选混合模式，可在终端与聊天视图之间切换同一段对话，历史由 Codex CLI 自己保存。 开启条件

“需要你介入”提醒

0.164.0 及以上无需配置（OSC 7501）；更早版本在 ~/.codex/config.toml 的 [tui] 设置 notifications = true。 提醒配置

4. 已知限制

• 聊天端需要第三方适配器 codex-acp（需要 Node）：npm install -g @agentclientprotocol/codex-acp；WebMux 不会自动安装。
• 预置参数 --dangerously-bypass-approvals-and-sandbox 会自动批准工具调用并关闭 Codex 沙箱；需要逐次授权时在设置页移除。
• 已验证版本为 Codex CLI 0.165.0 与 codex-acp 2.3.0；Codex 拒绝打开被 Codex App、IDE 或外部终端占用的会话。