codexwebui

一个面向 Codex app-server 的本地优先 Web UI，支持局域网访问、多 host 管理和同页分屏。

特性

• npx @nick403/codexwebui 一条命令启动
• 支持 -d 后台常驻运行
• 支持局域网访问和密码保护
• 支持同一前端接入多个局域网内 codexwebui host
• 支持最多 4 个 session 同页分屏
• 支持不同 host 的 session 在同一页面分屏显示
• 支持显示/隐藏思考过程
• 支持长会话分段加载和日期分组

快速开始

本机启动：

npx @nick403/codexwebui

局域网启动：

npx @nick403/codexwebui --host 0.0.0.0

后台运行：

npx @nick403/codexwebui -d --host 0.0.0.0

默认地址：

http://127.0.0.1:5999

多主机使用

如果你希望在同一个 Web 前端里接入多个局域网内的 Codex 节点：

1. 在每台机器上都运行 codexwebui
2. 在主页面左侧 Host 区域添加其他机器的地址和密码
3. 在侧栏选择 session，或使用 Open in new pane
4. 在空白 pane 中直接切换 Target host

推荐启动方式：

npx @nick403/codexwebui -d --host 0.0.0.0 --port 6100

分屏说明

• 顶部 1 / 2 / 3 / 4 可切换布局
• 每个 pane 都有独立的 host + session
• 侧栏 session 菜单支持 Open in new pane
• 空白 pane 可直接指定 Target host
• pane 头部可使用 Browse host 快速切到该 host 的 session 浏览上下文

运行要求

• Node.js 18+
• 可用的 codex CLI
• 已完成 Codex 登录

常用参数

npx @nick403/codexwebui --help

• --port <port>：监听端口，默认 5999
• --host <host>：监听地址，默认 127.0.0.1
• --password <pass>：指定访问密码
• --no-password：关闭密码保护
• --tunnel：启动 cloudflared 隧道
• --no-tunnel：关闭 cloudflared 隧道
• -d, --detach：后台运行 codexwebui

发布后安装

包发布到 npm 后，可直接在其他机器运行：

npx @nick403/codexwebui

或者：

npx @nick403/codexwebui -d --host 0.0.0.0

安全说明

• 默认开启密码保护
• 默认仅监听 127.0.0.1
• 建议只在明确需要远程访问时使用 --host 0.0.0.0