service_tier 报错是什么意思

Codex CLI 在对话、上下文压缩、兼容网关请求或某些插件路径里失败，并出现 Unknown parameter: 'service_tier'，先看本地 config.toml 有没有显式写 service_tier。

这个错误不像模型不可用，更像请求里多带了后端不认识的参数。不要先重置账号、Key 或模型名，先看本地 config.toml。

Text
Unknown parameter: 'service_tier'

哪些 Codex 版本容易遇到

先确认当前 Codex CLI 版本。OpenAI Codex GitHub issue 里有过 0.129.0 执行 /compact 时因为 service_tier 触发 unknown parameter 的回归记录。

如果你正在使用 0.130.0-alpha.5 或其它 alpha 版本，先把版本号记下来。删掉 service_tier = "default" 或升级后，再用同一个命令确认版本和复现结果。

PowerShell
codex --version

Windows 上应该查哪个 config.toml

Windows 上优先检查用户目录下的 .codex/config.toml。只要能看到 service_tier = "default"，它就是第一优先排查点。

这一步只查配置，不修改文件。

PowerShell
Select-String -Path "$env:USERPROFILE\.codex\config.toml" -Pattern "service_tier"

macOS / Linux 上应该查哪里

macOS 和 Linux 通常从 ~/.codex/config.toml 查。看到 service_tier = "default" 时，先按后面的步骤删掉这一行。

如果你同时有项目级配置，也要检查当前项目里是否有覆盖配置。

Bash
grep -n "service_tier" ~/.codex/config.toml

default 什么时候会出问题

最推荐的修复是删除 service_tier = "default"。默认服务层级不需要显式写出来，让 Codex 和后端自己走默认值。

OpenAI Codex 配置参考把 service_tier 标为可选项；Fast 文档里给出的持久化示例是 service_tier = "fast"，不是为了默认速度写 default。

删除这一行service_tier = "default"
保留模型配置model = "gpt-5.5"
默认服务层级省略 service_tier

Windows 上怎么删掉 default

在 Windows 上，先备份一份配置文件，再用记事本打开。删除 service_tier = "default" 后保存，关闭当前 Codex 会话，重新打开终端。

不要把整个 .codex 目录删掉。这个问题通常只需要改一行。

PowerShell
Copy-Item "$env:USERPROFILE\.codex\config.toml" "$env:USERPROFILE\.codex\config.toml.bak"
notepad "$env:USERPROFILE\.codex\config.toml"

macOS / Linux 上怎么删掉 default

macOS 或 Linux 可以直接编辑 ~/.codex/config.toml。删除 service_tier = "default" 后保存，再重新启动 Codex。

如果你不确定配置是否还有其它问题，先保留最小配置，只留下模型名和必要的 provider 信息。

Bash
nano ~/.codex/config.toml

删完后怎么确认生效

保存配置后重新打开 Codex。成功标准不是命令能启动，而是最小请求能返回，且不再出现 service_tier unknown parameter。

如果最小请求通过，再回到原来的项目会话或 /compact 场景验证。

PowerShell
codex exec "Reply with OK only."

什么时候需要升级 Codex CLI

如果你正在用 0.130.0-alpha.5 这类 alpha 版本，不建议长期放在主力环境。根据 npm 元数据，截至 2026-06-05，@openai/codex 的 latest 是 0.137.0，alpha 是 0.138.0-alpha.4。

升级前先退出正在运行的 Codex 进程。Windows 如果 codex.exe 被占用，可以先结束进程再安装。

PowerShell
npm install -g @openai/codex@latest
codex --version
codex doctor

Windows 升级失败先查什么

Windows 上如果 npm 替换全局 codex.exe 时失败，通常是旧进程还在运行。先关闭 Codex，再执行安装。

这一步只处理正在运行的 Codex 进程，不会修改你的项目文件。

cmd
taskkill /IM codex.exe /F

什么时候才应该打开 Fast 模式

如果你的账号、模型和当前登录方式确认支持 Fast mode，再写 service_tier = "fast"。OpenAI Codex Speed 文档说明，CLI 可以用 /fast on、/fast off、/fast status 切换，也可以通过配置文件持久化。

不要为了默认速度写 service_tier = "default"。这类默认值更安全的写法是省略。

toml
service_tier = "fast"

[features]
fast_mode = true

兼容网关更容易卡在哪里

如果你接的是 OpenAI-compatible API、Azure 网关、OneAPI、LiteLLM、OpenRouter 或公司内部转发层，先不要传 service_tier。

很多兼容层只实现核心字段，不一定支持 Codex 的扩展参数。先用最小配置跑通，再逐个加回 provider、base_url、wire_api、reasoning、tools 等配置。

toml
model = "gpt-5.5"

修完后还报错怎么判断

删除 service_tier = "default" 后，如果错误还在，继续按失败路径判断。不要把所有 unknown parameter 都归到同一行配置。

只有 /compact 失败

优先查 Codex 版本和上下文压缩路径。GitHub issue 里曾出现 /compact 专门带出 service_tier 的回归。

只有兼容网关失败

优先查网关是否透传或拒绝扩展字段。OpenAI-compatible 不等于支持所有 Codex 请求参数。

升级后才开始失败

先对比升级前后的 Codex CLI 版本和 config.toml。alpha 版本不要长期放在主力环境。

删除 default 后变成其它 unknown parameter

继续查配置里是否还有网关不支持的扩展字段，例如 compaction、reasoning 或缓存相关字段。

参考来源

Codex Configuration Reference官方文档Codex Speed / Fast mode官方文档0.129.0: /compact fails with unknown service_tier parameterGitHub issue@openai/codex npm packagenpm

相关文章

Codex CLI 一直要确认怎么办：approval_policy 和 sandbox_mode 排查错误日志 / 约 11 分钟Codex 和 Claude Code 必装的 10 个 Skills智能编程 / 约 16 分钟Claude、GPT、Gemini 怎么选：AI Coding 任务分配和验证清单智能编程 / 约 12 分钟Claude Code unsupported parameter / unknown field 怎么排查错误日志 / 约 12 分钟Claude Code Windows 环境变量生效验证开发环境 / 约 13 分钟

作者信息

luowj

关注 AI Coding 工具链、开发环境排障、工程发布和安全边界。文章优先基于官方文档、 真实报错、公开事件和可复现的检查步骤整理。

luowj1998@gmail.com提交文章反馈