novaferry01 创建 Novaferry 令牌
在 Novaferry 控制台打开「令牌管理」，创建令牌，分组选 codex-pro。令牌以 sk- 开头；下文的 sk-你的令牌 仅是占位符。
02 在终端设置环境变量
在 Bash 或 Zsh 终端执行下面的命令，按提示粘贴真实令牌（输入不回显），再按回车。这种方式不会把令牌原文写进 shell 命令历史。
printf 'Novaferry API key: '
IFS= read -r -s NOVAFERRY_API_KEY
export NOVAFERRY_API_KEY
printf '\n'变量只对当前终端及其后续启动的子进程有效。关闭终端后需重新设置。不要在终端里打印令牌来检查是否设置成功。
03 新建一个独立 CLI 配置
先用 codex --version 检查版本。按照当前官方文档，Codex CLI 0.134.0 及以上的命名 profile 使用独立文件：~/.codex/novaferry.config.toml。已有同名文件时先备份，再合并修改。
如果目录还不存在，先执行 mkdir -p ~/.codex。然后用文本编辑器创建上述文件，粘贴以下内容。这里不需要填写真实令牌。
model = "gpt-6-astra"
model_provider = "novaferry"
model_reasoning_effort = "high"
[model_providers.novaferry]
name = "Novaferry"
base_url = "https://api.novaferry.com/v1"
env_key = "NOVAFERRY_API_KEY"
wire_api = "responses"保持 wire_api = "responses"。env_key 填环境变量名称；不要填 sk- 令牌。high 适合复杂任务，日常可按模型支持情况选 low 或 medium。
.codex/config.toml 的 provider 相关字段。旧版 CLI 的 profile 语法可能不同，请先核对版本及对应文档。04 从同一终端启动
进入你的项目目录，在刚才设置环境变量的终端运行：
codex --profile novaferry先在会话状态中确认 provider 和模型，再发一条短请求，例如“仅回复：连接成功”。这会产生一次实际 API 请求和相应费用。到 Novaferry 控制台核对请求记录、模型、用量和计费。
未选择这个 profile 时，CLI 继续使用原有的默认配置。profile 文件不要写成旧式的 [profiles.novaferry] 嵌套表。
05 在 Codex 桌面端使用
桌面端使用用户级 ~/.codex/config.toml。先备份现有文件，再将步骤 03 的字段合并进去：顶层的 model、model_provider 和 model_reasoning_effort 应位于 TOML 表定义之前；provider 表只保留一份。保留你原有的其他配置。
让桌面应用进程可以读取 NOVAFERRY_API_KEY，然后重启应用并新建会话。只在终端里 export，不保证从 Dock / Finder 启动的应用能继承该变量。可从已设置变量的终端启动应用的可执行文件，或按系统方式设置应用环境变量。
CLI 的 --profile novaferry 不会自动替桌面应用切换 profile。受组织托管策略限制时，管理员策略可能覆盖本地 provider 设置。
06 把“可验证”落到结果上
核对参数
分别用 low 和 high 发同类任务，查看上游回显的推理强度和 usage 中的推理 token。数量有差异是辅助证据，不能仅凭某次长短判断是否使用指定模型。
核对缓存与账单
重复使用稳定的长前缀，检查 usage 中的 cached tokens 和账单缓存读取项。缓存写入与缓存命中读取分开统计。账单计算使用对应官方 token 类型的美元价格数值 × 0.8，单位为人民币。
做同题对照
对本站和官方 API 使用相同模型 ID、题目、推理强度、输出上限和接口协议，分别保存请求成功率、编程题通过率、平均请求耗时及输出长度。多个独立轮次比单次结果更有参考价值。
遇到问题，先检查这些。
提示 NOVAFERRY_API_KEY 未设置
在启动 Codex 的同一终端重新执行步骤 02。桌面应用需另行确认它的进程环境。不要把环境变量名换成令牌原文。
401、403 或模型不可用
检查令牌是否完整、有效、额度充足，以及分组是否为 codex-pro。模型 ID 必须与控制台提供的一致。分享错误时移除 Authorization、令牌和业务提示词。
404、协议错误，或请求去了错误地址
base URL 应为 https://api.novaferry.com/v1，配置里不要再追加 /responses 或重复 /v1。wire_api 使用 responses，并检查实际生效的用户配置、profile 及组织策略。
缓存率很低，是不是配置失效？
缓存不是每次都会命中。先检查提示词前缀是否稳定、上下文是否足够长、间隔是否合适，再读 usage 和站内日志。不要把缺失的缓存字段直接当作零命中。