Codex subscription to governed API bridge

把 Codex 订阅
变成团队可治理的
API 中转层。

我们做的不是“生成一个官方 API Key”。我们把 Codex 客户端已经合法拿到的 OAuth 会话导入 Router， 再封装成 OpenAI-compatible API、New API channel、SSO 权限和配额治理，给团队稳定使用。

打开 API 中转站 routerctl / OAuth 绑定指南 查看 GitHub Repo 看我们做了什么

上游额度、限流和模型可见性仍由原 Codex subscription 决定。这个项目提供的是企业网关、桥接和治理能力。

Our contribution

核心难点在桥接层，不在拼 Docker Compose。

其它开源项目让控制台、聊天入口和本地客户端更完整。NeuraSea 在这个仓库里补的是最关键的中间层： 如何把 Codex subscription 会话变成团队能审计、能限流、能共享、能接入 OpenAI-compatible 客户端的 API。

01

Codex OAuth credential import

通过 `routerctl codex bind` 触发 Codex 登录，把本地 OAuth token 与模型缓存导入 Router，而不是要求用户手填密钥。

02

OpenAI-compatible bridge

把 `/v1/chat/completions`、`/v1/responses` 和 Anthropic messages 映射到 Codex backend 可接受的 Responses 请求。

03

SSE and protocol translation

Codex 上游返回 SSE。Router 负责解析、转发、补齐 usage，并在不同客户端协议之间做格式翻译。

04

Credential pool governance

支持私有凭证、企业池、并发 lease、429 cooldown、401/403 disabled，让 subscription 不再是散落在个人机器上的黑盒。

05

New API channel sync

导入 credential 后自动创建 New API channel，把 Router bridge 挂成普通 OpenAI-compatible upstream。

06

Enterprise auth and observability

加上 Router SSO、JWT session、用量记录、配额接口和管理员视图，让这条链路能进入团队工作流。

Mechanism

底层原理很直接：代理一个已授权会话。

Codex CLI 登录后本来就能代表用户访问 Codex backend。我们把这个能力从单机 CLI 场景抽出来， 放进一个受控网关里，再提供 OpenAI API 兼容层。

不是破解，不是伪造，不是把订阅兑换成官方 API Key。

这是一个 OAuth session bridge。请求仍然走原 Codex subscription 的权限、额度和风控。 我们增加的是协议适配、凭证池、团队治理和中转站入口。

Request path

Client -> New API -> Router -> Codex backend

New API 负责 token、模型、日志和计费视图。Router 负责拿到对应 credential， 调用 `chatgpt.com/backend-api/codex/responses`，再把结果返回给调用方。

Open-source stack

我们集成开源项目，是为了让方案完整。

这些项目不是我们的核心 claim。它们是成熟组件，负责控制台、聊天入口、身份系统和本地启动体验。 我们的工作是把它们接到 Codex subscription bridge 这条主链路上。

New API
控制台、channel、token、日志、用量和计费视图。
control plane
LibreChat
作为聊天入口，指向 New API 的 OpenAI-compatible endpoint。
chat entrypoint
CC Switch
保留为外部本地工具，用来启动 Claude Code/Codex 和切换模型。
local launcher
Casdoor / OIDC
推荐做统一身份入口，可前接 Feishu、企业 SSO 或微信登录。
identity
Try it

打开 NeuraSea API 中转站。

如果你只想使用 API，直接进入中转站。如果你要看实现，仓库里有 Router、routerctl、New API sync、 nginx、Docker Compose 和真实上游 smoke 脚本。

routerctl / OAuth 绑定指南 GitHub Repo https://ai.neurasea.com