Codex CLI Web

一个运行在本机 localhost 的 Codex CLI Web 管理器：浏览器负责界面，Go 负责项目/会话管理，并通过 codex app-server 连接本地 Codex。

当前版本

• 复用 opencode-go 的聊天工作台界面和 Markdown 渲染资源。
• 一个工作目录可以创建多个 Codex 会话。
• 会话列表、历史消息和恢复动作全部直接来自 Codex App Server，不生成 state.json 或 Web 会话副本。
• 打开历史会话时先调用 thread/resume，再读取真实 transcript，恢复 Codex 的真实上下文。
• 模型列表来自 model/list；模型和思考等级切换调用 thread/settings/update，下一轮直接由 Codex 生效。
• 支持流式回答、命令/文件修改工具块、中断和审批卡片。
• 默认只监听 127.0.0.1:52323，每一轮默认使用 workspaceWrite，网络访问关闭。

运行

需要先确保 codex 已安装并且已经完成登录：

go run ./cmd/codex-web

启动后终端会打开并打印 http://127.0.0.1:52323。如需临时改端口，也可以手动指定：

go run ./cmd/codex-web -addr 127.0.0.1:43212 -no-open

如需使用自定义 Codex 可执行文件，可设置 CODEX_BIN。新会话使用 Codex App Server 的默认模型，打开会话后可在顶部切换模型和思考等级。

网络代理

推荐打开页面右上角“⚙ 设置”，在“Codex 网络”里填写代理地址并点击“保存并应用”。设置会保存到 ~/.codex-cli-web/settings.json，并立即重启 App Server；有会话正在运行时会拒绝重启，避免打断任务。

如果没有配置 UI 代理，启动器会使用当前用户环境里的 HTTP_PROXY、HTTPS_PROXY 或 ALL_PROXY。常见的小写 http_proxy/https_proxy 也会自动规范化后传给 codex app-server。

可以检查代理端口是否可用：

Test-NetConnection 127.0.0.1 -Port 7890

如果直连仍报 os error 10061，通常是代理没有运行或当前启动进程没有继承代理环境变量。

编译 Windows exe

.\build.ps1

产物位于 dist\codex-cli-web.exe。跳过测试可以使用：

.\build.ps1 -SkipTests

架构

浏览器（HTML + SSE）
        │ HTTP / SSE
        ▼
Go Web Server
        │ JSON-RPC over JSONL/stdin/stdout
        ▼
codex app-server
        │
        ▼
本地项目目录 + Codex 会话历史

internal/app 只负责把 Codex 的协议转换成网页事件；未来 App Server 协议变化时，主要修改这一层即可。

许可证

本项目采用 MIT 许可证，详见 LICENSE。