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

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

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

如果购买的是网页账号，不能把账号密码、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 不要混为一谈，最终以购买页面实时显示为准。