NewAPI 接入 Codex 的配置方法

数据截至 2026-08，价格与限额以各官网为准。本文只讲计费与接入机制，不列具体价格数字。

把 Codex CLI 指向自建的 NewAPI，本质上只做两件事：在 NewAPI 里拿到接口地址和一个令牌，再让 Codex 的配置文件用这两样东西替换掉默认端点。NewAPI 官方文档为 Codex CLI 单独开了一节，给的路径是「装 Node 环境 → 全局安装 Codex CLI → 跑一条一键改配置的脚本 → 启动 codex 并用斜杠命令选模型」。这里有个容易被忽略的细节：官方那一节把改配置这一步做成了脚本，并没有在文档里逐个列出配置文件里的键名，所以网上流传的那套字段写法不能算官方出处。另外，令牌的完整密钥只在创建时展示一次，错过就得重建；令牌上还挂着模型限制、IP 白名单、分组三个开关，任何一个没配对，表现出来都是「地址填对了却调不通」。

先把这条链路拆成几段

从你在终端敲下 codex 到模型返回内容，中间至少经过三段：Codex CLI 本地进程、NewAPI 网关、NewAPI 背后的上游渠道。三段各有各的配置，出问题时也各有各的症状。

NewAPI 官方文档在渠道那一节挂了一条醒目的告示，大意是上游渠道必须是部署方自己合法拥有或获得授权的账号、API Key、模型服务或企业合约；负载均衡、自动故障转移、加权随机、多密钥管理这些能力，是为高可用和企业多账号管理设计的，使用时需要遵守上游服务条款、平台规则与监管要求。在 Codex 接入这一节，官方又重复了一次同样口径的提醒：修改 API 地址之后，所有模型（包括官方预置的那些）都会走你配置的接入点，因此请使用你自己部署的 New API，或者确认服务方对 New API 服务具备合法的上游授权与合规义务，不要把来源不明的 API 地址和密钥接进生产环境。

这段话不是套话，它决定了这篇文章能写什么、不能写什么。下面所有步骤都默认你接的是自己那一套 NewAPI。

NewAPI 这边先准备两样东西

接口地址

官方文档「Using the API」一节写得很直白：把 OpenAI 的 base_url 换成平台地址，把平台签发的令牌当作 api_key，就可以开始调用。地址从哪儿拿？访问平台首页，页面中部有一块 API Base URL 展示区，点复制按钮把地址拷到剪贴板，拿到的这个地址就是客户端或代码里要填的 base_url。

如果你是在本机跑的 NewAPI，官方在别的客户端接入示例里给过本地地址的写法形如 http://localhost:3000/v1。要注意 NewAPI 的聊天设置里还定义了两个模板变量，{key} 会被替换成密钥，{address} 会被替换成服务器地址且结尾不带 / 和 /v1——这说明「带不带 /v1」在 NewAPI 自己的体系里是两个不同的概念，填到客户端里的时候别把两者搞混。

令牌

令牌在控制台左侧的「令牌」入口，也可以直接访问 /console/token。官方对令牌的定义是「API 凭证」，每个令牌都能单独配置自己的权限范围与额度上限。点右上角的创建按钮，弹出的对话框里有这么几个选项，官方文档列成了一张表（以官方文档为准）：

• 过期时间：设置到期日期，留空或设为 -1 表示不过期
• 剩余额度：限制这个令牌最多能消耗多少额度，超出后自动禁用
• 无限额度：开启后该令牌不再受自身额度限制，但仍受账户总额度约束
• 模型限制：把令牌限定在特定模型上，留空表示不限制
• IP 白名单：限制允许的来源 IP，留空表示不限制
• 分组：指定这个令牌使用的渠道分组

提交之后对话框会显示完整的令牌密钥，官方特意加了警告：密钥只在创建时完整展示这一次，关掉对话框就再也看不到了，必须立刻复制保存；令牌密钥拥有完整的 API 调用权限，不要分享给别人，也不要提交到代码仓库。这条对 Codex 这类会把配置写进本地文件的工具尤其要紧，密钥怎么存、怎么轮换，可以配合API Key 安全管理那篇一起看。

拿到令牌后别急着去改 Codex。NewAPI 自带一个 Playground，在左侧栏或 /console/playground 打开，选模型、输入一句话、点发送就能看到回复。官方给它的定位就是「快速验证令牌是否可用」的内置在线测试工具。在这里能通，说明网关到上游这一段是活的，后面再出问题就只用查客户端那一段。

官方给出的三套安装路径

Codex CLI 本身是 OpenAI 的终端编码代理，官方项目主页是 github.com/openai/codex。NewAPI 文档为 Windows、macOS、Linux 分别写了图文步骤，差别主要在 Node 环境怎么装。

Windows：官方建议先装 WSL2，理由写的是「为了在 Windows 上获得最佳表现」，命令是 wsl --install，装完要重启电脑。文档另附三条注意事项：建议用 PowerShell 而不是 CMD，遇到权限问题试试以管理员身份运行，部分杀毒软件可能误报需要加白名单。Node 环境走 nvm 安装，官方在这里加了一句很实在的话——版本号具有时效性，请按 OpenAI 官网的要求安装对应版本。所以别把文档截图里的版本号当成硬性要求。

macOS：先装 Homebrew，再 brew update 和 brew install node，用 node --version 和 npm --version 能打出版本号就算装好了。文档提醒遇到权限问题可能需要用 sudo，首次运行可能要在系统设置里授权，建议用 Terminal 或 iTerm2。

Linux：从 NodeSource 添加仓库后用包管理器装 Node。文档提示部分发行版需要额外依赖，Ubuntu/Debian 装 build-essential，CentOS/RHEL 装开发工具组。

三个系统装 Codex CLI 的命令是同一条，全局安装 @openai/codex 这个 npm 包，装完用 codex --version 验证。碰到全局目录写权限问题，官方给的两个办法是加 sudo，或者用 npm config set prefix 把 npm 前缀改到用户目录再把对应的 bin 目录加进 PATH。

改配置这一步，官方给的是脚本

这是整个流程里最值得说清楚的一步。NewAPI 文档在「修改配置文件」这一小节没有让你手动编辑任何键值，而是直接给了一条一键脚本：Windows 侧是 PowerShell 里用 irm 拉取再 iex 执行，macOS 与 Linux 侧是 curl -fsSL ... | bash，脚本都托管在 QuantumNous/new-api-docs 仓库的 helper 目录下，文件名分别是 codex-cli-setup.ps1 和 codex-cli-setup.sh。

官方文档没有说明这个脚本具体改写了配置文件里的哪些字段，也没有在这一节给出配置项的键名。 官方文档的 Codex 那一节里没有出现环境变量名，也没有给出配置文件的键名。所以如果你看到某篇教程把一串键值写得像官方规范，那多半是从 Codex 自己的文档或者别人的经验里来的，不是 NewAPI 官方出处。想弄清楚 Codex 端配置文件本身的结构，那属于 Codex 侧的话题，可以看Codex config.toml 全景那一篇。

顺带说一句执行方式：这类「拉一个远程脚本直接执行」的命令，无论出自谁家，稳妥的做法都是先把脚本地址在浏览器里打开看一眼内容再决定跑不跑。脚本路径是公开的，看这一眼的成本很低。

另一条路：从令牌管理页一键导入

官方文档里还写了一个叫 CC Switch 的开源跨平台 AI CLI 管理工具，它支持 Claude Code、Codex、Gemini CLI 的一键切换。NewAPI 对它的集成方式是 Deep Link 协议 ccswitch://：先在系统设置的聊天设置里加一条快捷选项，配置内容是把 CC Switch 映射到 ccswitch；加完之后，在令牌管理页点对应令牌的下拉菜单选 CC Switch，系统会自动拉起应用并打开配置对话框。

对话框里的字段官方也列了：顶部的 Application 可以在 Claude / Codex / Gemini 之间切，选到 Codex 即可；Name 是你给这套配置起的名字，方便以后在 CC Switch 里识别和切换；Main Model 是必填的默认主模型；下面还有轻量快速、均衡、能力最强三档模型可选，未选中的字段会显示提示文案。点确认按钮把配置导进 CC Switch 就算完成。

这条路和上一条是并列关系，不存在哪个更好的问题：脚本那条改的是本机配置文件，Deep Link 这条是把配置交给一个外部管理器托管。你要是只接一套 NewAPI，前者更短；要是同时在几个接入点之间来回切，后者省去反复改文件。按自己的切换频率选就行。

跑起来之后

启动很简单，终端里敲 codex 就进交互界面，想在某个项目里用就先 cd 到项目目录再启动。文档的图注提到启动后要设置 Codex 的权限：一种是允许 Codex 直接改文件，一种是每次改文件都需要手动授权。切换模型用斜杠命令 /model。

Codex CLI 的能力边界，官方文档在特性表里列过（以官方文档为准）：它提供 apply_patch、shell、update_plan、multi_tool_use 这些工具，用专门的补丁格式原子化地增删改文件以便审计和回滚；沙箱策略有 workspace-write、read-only 这类取值，审批模式有 on-request、on-failure、never 三种，用来控制写入与网络访问权限；update_plan 用来列步骤和跟踪状态，同一时刻只保留一个进行中的步骤；还支持通过 multi_tool_use.parallel 并行调用多个工具。这些是 Codex 侧的行为，和 NewAPI 无关，但它们决定了同一段任务会发出多少次请求——这一点直接影响下面的账。

这条链路上的账是怎么算的

NewAPI 把额度当作平台内部的计费单位。官方给出的公式是：

Quota = Group Ratio * Model Ratio * (Prompt Token Count + Completion Token Count * Completion Ratio)

拆开看是三个系数：分组倍率决定了这个令牌所属分组的整体系数，模型倍率决定了不同模型之间的相对贵贱，补全部分的 token 还要再单独乘一个补全倍率。补全倍率单独存在这件事有点反直觉，但它对应的是上游普遍把输出 token 和输入 token 分开定价的现实。官方给了一套与其口径一致的默认倍率，部署方可以在系统设置的运营设置里覆盖它——所以任何转述都以你自己那套部署的实际配置为准。

额度限制是两层的：令牌上的剩余额度管这一个令牌，账户总额度管整个账户。就算令牌开了无限额度，账户总额度这一层依然生效。Codex 这类代理式工具一轮任务里可能连续发多次请求，把它单独绑一个限额令牌，比直接用主令牌更容易控制失控范围。想系统地做这件事，可以参考API 成本监控那篇的思路。

接不通的时候按这个顺序查

先在 Playground 里试同一个模型。Playground 能通、Codex 不通，问题在客户端这一段：检查地址是不是复制完整、结尾的 /v1 有没有多写或少写、令牌有没有粘贴串行。

Playground 也不通，就回到 NewAPI 这一层挨个排：令牌的模型限制里有没有包含你要调的模型，IP 白名单是不是把当前出口 IP 挡了，令牌分组和渠道分组对不对得上，令牌是不是已经过期或者额度用尽被自动禁用。这四项任意一项不匹配，报错都不会直接告诉你是哪一项。

还有一类容易被漏掉的：倍率没配。官方排错说明里出现过这样一句提示，让你检查倍率或价格是否已在「系统设置 - 运营设置 - 模型倍率设置」里配置过。也就是说，一个模型即使渠道通了，只要没给它配倍率，调用照样会失败。新加模型之后调不通，先想想这一条。

至于 Codex 究竟走的是哪个端点，NewAPI 的接入文档那一节没有明说。能确定的是官方支持的端点表里列有 POST /v1/responses（OpenAI Responses 格式），变更日志里也有一条针对 Codex 与 Responses 字段透传的修复记录。剩下的细节，以官方文档当前版本为准。

最后

这套流程真正的坑不在命令，而在两个地方：一是令牌密钥只显示一次，很多人是在改配置的时候才发现自己没存；二是官方那一步是脚本而不是文档化的字段清单，导致后面出问题时你不知道该改哪儿。稳妥的做法是先在 Playground 把令牌验通，再动 Codex；网关本身还没搭起来的话，先看NewAPI 部署教程那一篇，把服务跑起来、把默认密码全换掉，再回来接客户端。