尧图网页设计 
OpenCodex Web仪表盘全攻略供应商管理、OAuth状态与实时请求日志一网打尽【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodexOpenCodexopencodex是一个通用的 LLM 供应商代理让 OpenAI Codex、Claude Code 等客户端可以调用 Claude、Gemini、Grok、DeepSeek、Ollama 等任意大模型。它的核心之一就是内置的Web 仪表盘供应商管理、OAuth 账号状态、实时请求日志、用量统计全部集中在一块屏幕上无需在多个终端之间来回切换。本文用 5 分钟带你完整走一遍这个仪表盘从打开方式到添加供应商、查看 OAuth 健康状态、排查请求日志。一键打开仪表盘ocx start 与 ocx gui安装后只需两条命令npm 全局包Node 18Bun 运行时随安装自动打包npm install -g bitkyc08/opencodex ocx start # 启动代理 仪表盘默认 localhost:10100ocx start前台启动代理并打开仪表盘ocx service以后台服务方式运行macOS launchd / Linux systemd / Windows 计划任务ocx gui任何时候重新打开浏览器里的仪表盘关于登录通过localhost、127.0.0.1等本机地址打开时仪表盘会自动获得一个短期 GUI 会话通常不需要输入任何 token。若从非本机地址公开访问仪表盘则需使用管理员 tokenOPENCODEX_ADMIN_AUTH_TOKEN环境变量或~/.opencodex/admin-api-token文件。仪表盘首页Overview 标签一眼就能看清代理是否Online、版本号、运行时长、活动供应商数以及活动供应商的适配器、Base URL、默认模型与认证状态表格。页面还支持按#dashboard/providers、#dashboard/models直接深链定位到各个标签页刷新和后退都会保留当前位置源码入口见 gui/src/pages/Dashboard.tsx。供应商管理添加、设为默认、限速节奏侧边栏的Providers页面是供应商管理的中心。左侧Account login区块列出所有支持账号登录的供应商及其登录状态下方是每个供应商的配置卡片默认、激活、passthrough 徽章 配额进度条。添加供应商只需四步点击右上角 Add Provider打开目录浏览器内置 40 供应商预设选择认证方式账号登录OAuth、API Key、本地服务器或自定义 endpoint选择模型来源从供应商实时发现或只使用静态配置保存后可随时设为默认、启用/禁用或删除进入单个供应商详情后还有几个新手容易忽略的实用开关Request pacing请求节奏均匀延迟出站请求可设每分钟请求数和最小间隔毫秒还能对单个模型单独覆盖Model overrides。对容易触发限流的免费档供应商特别有用。Discover models from provider打开后自动拉取供应商的实时模型目录。供应商的增删改查都由 gui/src/pages/Providers.tsx 与 gui/src/components/AddProviderModal.tsx 驱动底层走管理 API 的POST /api/providers、PATCH、DELETE路由。删除当前默认供应商时系统会自动切换到剩余的第一个已启用供应商若没有可用供应商则会拒绝删除并保留默认避免把代理拆瘫。OAuth状态账号健康一眼看穿很多供应商xAI、Anthropic、Kimi 等支持 OAuth 登录省去 API Key。登录后账号并不总是健康的——仪表盘会为每个 OAuth 账号打上健康徽章状态来自管理 API 的health字段共四种状态徽章颜色含义healthy绿色凭据正常可路由流量cooldown灰色触发限流/冷却中等待恢复勿立即重试reauth_required琥珀色凭据过期需要重新认证warning琥珀色其他警告如刷新冲突、元数据不匹配状态枚举定义在 gui/src/oauth-health-display.ts账号面板渲染逻辑见 gui/src/components/provider-workspace/ProviderAuthPanel.tsx。Codex Auth 页面则是管理 ChatGPT/Codex 账号池的地方添加多个账号、刷新 5h / 每周 / 30d 配额、启用配额自动切换新会话自动路由到用量最低的可用账号并可为每张账号卡片设置选择顺序最先/较先/默认/较后/最后——把 Codex Desktop 主账号设为最后留作备用是常见做法。需要注意账号池仅用于路由与运维韧性请遵守各供应商的服务条款。 仪表盘界面支持英文、简体中文、繁体中文、日语、韩语等十种语言侧边栏底部的语言切换器即时生效。实时请求日志Token、速度、错误全透明Logs页面是排查问题的主力自动刷新近期经代理路由的请求按时间倒序展示。每行包含Tokens总 token 数 缓存c/ 写入w拆分Model / Effort实际发送的模型与推理强度如gpt-5.6-solfastProvider / Status路由到的供应商与 HTTP 状态码Request请求 ID点击可展开耗时、错误详情与实际的 wire 字段页面顶部可按SurfaceAll / Claude / Codex过滤还支持按供应商、精确状态码或状态类别如 5xx筛选并可按不透明会话 ID 定位某次对话的全部请求。两个重要细节内存中的请求日志环形缓冲上限 200 条磁盘上的~/.opencodex/usage.jsonl才是用量的权威数据源追加式 JSONL文件权限0600写入逻辑在 src/usage/log.ts。Logs 与 Usage 页显示的费用是基于已报告 token 的API 标价折算值不是账单也不证明实际扣费——实际可能计入订阅用量。Usage 页面把usage.jsonl汇总成总请求数、总 token、缓存读取、Coverage用量覆盖率与每日活动热力图再按模型/供应商拆分。缺失的用量绝不会被显示为零是它的核心设计——measured / reported / unreported / unsupported / estimated的分类保证了统计的诚实性。遇到上游响应形状或用量提取异常时可运行ocx debug usage on代理会向~/.opencodex/usage-debug.jsonl写入滚动调试记录含 content-type、body 类型、2KB 采样与提取结果默认关闭不影响生产路径。日志与用量机制的完整架构说明见 structure/05_gui-and-management-api.md。常见问题速查问题去哪看仪表盘打不开、显示无法连接先运行ocx start启动代理某个模型突然不可用Logs 页过滤该供应商看状态码与错误详情OAuth 账号失效Providers / Codex Auth 页找琥珀色reauth_required徽章点击重新登录供应商频繁 429供应商设置的 Request pacing 调低每分钟请求数磁盘占用过大Storage 页查看 CODEX_HOME 占用可预览并归档清理延伸资料官方中文文档docs-site/src/content/docs/zh-cn/guides/web-dashboard.md —— 仪表盘所有管理 API endpoint 的完整对照表GUI 源码说明gui/README.md运行时架构总览structure/00_overview.md仪表盘与代理通信的安全模型loopback 校验、会话 token 绑定structure/05_gui-and-management-api.md掌握以上五个入口Overview → Providers → Codex Auth → Logs → Usage你就拥有了 OpenCodex 的全部日常运维能力——多供应商切换、账号池轮转、请求追踪一个浏览器标签页就够了 【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenCodex Web仪表盘全攻略：供应商管理、OAuth状态与实时请求日志一网打尽
OpenCodex Web仪表盘全攻略供应商管理、OAuth状态与实时请求日志一网打尽【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodexOpenCodexopencodex是一个通用的 LLM 供应商代理让 OpenAI Codex、Claude Code 等客户端可以调用 Claude、Gemini、Grok、DeepSeek、Ollama 等任意大模型。它的核心之一就是内置的Web 仪表盘供应商管理、OAuth 账号状态、实时请求日志、用量统计全部集中在一块屏幕上无需在多个终端之间来回切换。本文用 5 分钟带你完整走一遍这个仪表盘从打开方式到添加供应商、查看 OAuth 健康状态、排查请求日志。一键打开仪表盘ocx start 与 ocx gui安装后只需两条命令npm 全局包Node 18Bun 运行时随安装自动打包npm install -g bitkyc08/opencodex ocx start # 启动代理 仪表盘默认 localhost:10100ocx start前台启动代理并打开仪表盘ocx service以后台服务方式运行macOS launchd / Linux systemd / Windows 计划任务ocx gui任何时候重新打开浏览器里的仪表盘关于登录通过localhost、127.0.0.1等本机地址打开时仪表盘会自动获得一个短期 GUI 会话通常不需要输入任何 token。若从非本机地址公开访问仪表盘则需使用管理员 tokenOPENCODEX_ADMIN_AUTH_TOKEN环境变量或~/.opencodex/admin-api-token文件。仪表盘首页Overview 标签一眼就能看清代理是否Online、版本号、运行时长、活动供应商数以及活动供应商的适配器、Base URL、默认模型与认证状态表格。页面还支持按#dashboard/providers、#dashboard/models直接深链定位到各个标签页刷新和后退都会保留当前位置源码入口见 gui/src/pages/Dashboard.tsx。供应商管理添加、设为默认、限速节奏侧边栏的Providers页面是供应商管理的中心。左侧Account login区块列出所有支持账号登录的供应商及其登录状态下方是每个供应商的配置卡片默认、激活、passthrough 徽章 配额进度条。添加供应商只需四步点击右上角 Add Provider打开目录浏览器内置 40 供应商预设选择认证方式账号登录OAuth、API Key、本地服务器或自定义 endpoint选择模型来源从供应商实时发现或只使用静态配置保存后可随时设为默认、启用/禁用或删除进入单个供应商详情后还有几个新手容易忽略的实用开关Request pacing请求节奏均匀延迟出站请求可设每分钟请求数和最小间隔毫秒还能对单个模型单独覆盖Model overrides。对容易触发限流的免费档供应商特别有用。Discover models from provider打开后自动拉取供应商的实时模型目录。供应商的增删改查都由 gui/src/pages/Providers.tsx 与 gui/src/components/AddProviderModal.tsx 驱动底层走管理 API 的POST /api/providers、PATCH、DELETE路由。删除当前默认供应商时系统会自动切换到剩余的第一个已启用供应商若没有可用供应商则会拒绝删除并保留默认避免把代理拆瘫。OAuth状态账号健康一眼看穿很多供应商xAI、Anthropic、Kimi 等支持 OAuth 登录省去 API Key。登录后账号并不总是健康的——仪表盘会为每个 OAuth 账号打上健康徽章状态来自管理 API 的health字段共四种状态徽章颜色含义healthy绿色凭据正常可路由流量cooldown灰色触发限流/冷却中等待恢复勿立即重试reauth_required琥珀色凭据过期需要重新认证warning琥珀色其他警告如刷新冲突、元数据不匹配状态枚举定义在 gui/src/oauth-health-display.ts账号面板渲染逻辑见 gui/src/components/provider-workspace/ProviderAuthPanel.tsx。Codex Auth 页面则是管理 ChatGPT/Codex 账号池的地方添加多个账号、刷新 5h / 每周 / 30d 配额、启用配额自动切换新会话自动路由到用量最低的可用账号并可为每张账号卡片设置选择顺序最先/较先/默认/较后/最后——把 Codex Desktop 主账号设为最后留作备用是常见做法。需要注意账号池仅用于路由与运维韧性请遵守各供应商的服务条款。 仪表盘界面支持英文、简体中文、繁体中文、日语、韩语等十种语言侧边栏底部的语言切换器即时生效。实时请求日志Token、速度、错误全透明Logs页面是排查问题的主力自动刷新近期经代理路由的请求按时间倒序展示。每行包含Tokens总 token 数 缓存c/ 写入w拆分Model / Effort实际发送的模型与推理强度如gpt-5.6-solfastProvider / Status路由到的供应商与 HTTP 状态码Request请求 ID点击可展开耗时、错误详情与实际的 wire 字段页面顶部可按SurfaceAll / Claude / Codex过滤还支持按供应商、精确状态码或状态类别如 5xx筛选并可按不透明会话 ID 定位某次对话的全部请求。两个重要细节内存中的请求日志环形缓冲上限 200 条磁盘上的~/.opencodex/usage.jsonl才是用量的权威数据源追加式 JSONL文件权限0600写入逻辑在 src/usage/log.ts。Logs 与 Usage 页显示的费用是基于已报告 token 的API 标价折算值不是账单也不证明实际扣费——实际可能计入订阅用量。Usage 页面把usage.jsonl汇总成总请求数、总 token、缓存读取、Coverage用量覆盖率与每日活动热力图再按模型/供应商拆分。缺失的用量绝不会被显示为零是它的核心设计——measured / reported / unreported / unsupported / estimated的分类保证了统计的诚实性。遇到上游响应形状或用量提取异常时可运行ocx debug usage on代理会向~/.opencodex/usage-debug.jsonl写入滚动调试记录含 content-type、body 类型、2KB 采样与提取结果默认关闭不影响生产路径。日志与用量机制的完整架构说明见 structure/05_gui-and-management-api.md。常见问题速查问题去哪看仪表盘打不开、显示无法连接先运行ocx start启动代理某个模型突然不可用Logs 页过滤该供应商看状态码与错误详情OAuth 账号失效Providers / Codex Auth 页找琥珀色reauth_required徽章点击重新登录供应商频繁 429供应商设置的 Request pacing 调低每分钟请求数磁盘占用过大Storage 页查看 CODEX_HOME 占用可预览并归档清理延伸资料官方中文文档docs-site/src/content/docs/zh-cn/guides/web-dashboard.md —— 仪表盘所有管理 API endpoint 的完整对照表GUI 源码说明gui/README.md运行时架构总览structure/00_overview.md仪表盘与代理通信的安全模型loopback 校验、会话 token 绑定structure/05_gui-and-management-api.md掌握以上五个入口Overview → Providers → Codex Auth → Logs → Usage你就拥有了 OpenCodex 的全部日常运维能力——多供应商切换、账号池轮转、请求追踪一个浏览器标签页就够了 【免费下载链接】opencodexUniversal provider proxy for OpenAI Codex Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama…) with Codex CLI, App, SDK, and Claude Code项目地址: https://gitcode.com/gh_mirrors/ope/opencodex创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考