包月 Codex Plus 怎么接入 New API?OAuth 配置、令牌与验证实录

国内模型已经能覆盖大多数写作、代码和资料整理任务,但遇到特定模型、开发工具或固定接口时,很多人还是会准备一个低成本备用节点。真正值得搭建的,不是一个多人共用的网页账号,而是一个能统一管理模型渠道、访问令牌和调用日志的 API 网关。

这篇以 New API 为例,演示如何在云服务器上搭建统一入口,再说明包月 Codex Plus 场景应该怎样接入。先说结论:只有网页登录权限的 Plus 账号,不能直接当作 New API 的上游 API;只有服务商提供了合规的 OpenAI 兼容接口和独立密钥,才能按下面的方法配置。

一、先分清:Codex Plus 账号和 API 不是一回事

包月 Codex Plus 通常有两种形态:

形态 能否直接填进 New API 正确用法
官方客户端登录的 Plus 账号 不能直接填 在支持账号登录的 Codex 客户端中使用
服务商提供的兼容 API 可以配置 按 Base URL、模型名和 API Key 接入

如果购买的是网页账号,不能把账号密码、Cookie 或登录会话放进 New API,也不建议多人共用。若购买方明确提供了独立 API 地址、模型名称、密钥和调用规则,才把它当作一个上游渠道配置。

二、在云服务器上部署 New API

准备一台 Linux 云服务器,建议至少 1 核 2 GB 内存,开放 SSH 和后续的 Web 端口。测试阶段可以用简化版,正式使用时再换成 PostgreSQL、Redis 和 HTTPS 的完整部署。

mkdir -p /opt/new-api
cd /opt/new-api

创建 docker-compose.yml:

services:
new-api:
image: calciumion/new-api:latest
container_name: new-api
restart: always
ports:
- 3000:3000
environment:
- TZ=Asia/Shanghai
volumes:
- ./data:/data

启动并查看日志:

docker compose up -d
docker compose logs -f new-api

浏览器访问 http://服务器公网IP:3000。第一次登录后修改默认设置,再配置域名和 HTTPS。不要把 3000 端口长期裸露在公网,正式使用建议通过 Nginx 或 Caddy 做反向代理,并在防火墙中只开放必要端口。

三、New API 里添加 Codex Plus 的兼容 API 渠道

进入 New API 的“渠道”页面,选择支持 Codex OAuth 的渠道类型。不同版本名称可能是“OpenAI Codex”“Codex OAuth”或相近名称,重点是认证方式必须显示 OAuth,而不是 API Key。

渠道名称:codex-plus-personal
渠道类型:OpenAI Codex OAuth
认证方式:OAuth
Base URL:按当前渠道默认值
模型:选择当前订阅支持的模型

点击“授权”或“登录”,浏览器会打开 OAuth 页面。使用自己的 Codex Plus 账号完成登录和授权,回到 New API 后确认渠道状态变为正常,再在测试区域发送一条短消息。OAuth 凭据应由 New API 保存在服务端,不能把本地 auth 文件、Cookie 或 refresh token 手工复制给其他人。

如果当前 New API 版本没有 Codex OAuth 渠道,就不要把网页登录账号硬填进普通 API Key 渠道。此时只能使用服务商明确提供的兼容 API,或者升级到支持该渠道的版本。

四、创建下游令牌,不要把上游密钥交给每个人

渠道测试成功后,进入“令牌”页面创建下游 API Key:

令牌名称:codex-desktop
可用模型:只勾选需要的模型
额度:先设置一个小额度
过期时间:按包月周期设置

New API 对外只暴露自己的令牌,上游真实密钥留在服务器里。建议设置每日额度、单次请求上限和可用模型范围。多人可以共同承担服务器费用,但不要共用第三方网页账号;如需多人使用,应给每个人单独的下游令牌,并保留调用记录。

五、在 Codex 中接入 New API

拿到地址、下游令牌和模型别名后,在 Codex 的模型配置中填写:

Provider:OpenAI Compatible
Base URL:https://你的域名/v1
API Key:New API 下游令牌
Model:codex-plus-personal

也可以使用环境变量:

export OPENAI_BASE_URL="https://你的域名/v1"
export OPENAI_API_KEY="你的New-API下游令牌"

如果模型能返回普通文本,但工具调用或代码执行失败,优先检查接口协议、模型能力和客户端版本。第一次验证建议只做只读任务:

请分析当前项目目录,不要修改文件。
先说明你能看到哪些文件,再给出项目入口、运行方式和风险提示。

确认返回、日志和额度统计都正常后,再让 Codex 创建测试文件。这样可以同时验证 New API 的渠道、令牌、模型映射和 Codex 工具权限。

六、普通 IP、家庭 IP 和低价节点怎么选?

机房 IP 价格低、部署方便,适合个人 API 网关和开发测试;家庭 IP 更接近日常家庭网络出口,但不代表一定不会触发平台验证,也不等于可以绕过任何地区或账号规则。

雨云的中文控制台、节点选项和 IP 选择比较直观,适合先租一个月验证 New API。基础资源或普通公网 IP 可以低价起步,但服务器、普通 IP、独立 IP 和家庭 IP 通常不是同一项费用,家庭 IP 的实时价格要以购买页为准。

选购时重点看续费价、IP 类型、流量限制和是否支持独立端口。测试 New API,低配服务器就够;长期多人使用,更应优先考虑内存、带宽、HTTPS、备份和密钥管理。

结语:先把 API 链路跑通,再考虑家庭 IP

New API 解决的是渠道、令牌、额度和日志管理,不是把网页 Plus 账号变成 API。先确认上游提供兼容接口,再完成“渠道测试—创建令牌—Codex 接入—只读验证”,排错会简单很多。

如果需要低成本节点,可以通过雨云推广入口查看当前服务器和 IP 价格。基础资源起步价、普通公网 IP 和家庭 IP 不要混为一谈,最终以购买页面实时显示为准。

This entry was posted in ai and tagged , , , , , , , , . Bookmark the permalink.

发表评论