确认 Unknown parameter: service_tier 报错
Codex CLI 在对话、上下文压缩、兼容网关请求或某些插件路径里失败，并出现 `Unknown parameter: 'service_tier'`，先按这篇排查。
这个错误不像模型不可用，更像请求里多带了后端不认识的参数。不要先重置账号、Key 或模型名，先看本地 `config.toml`。
Unknown parameter: 'service_tier'检查 Codex CLI 版本
先确认当前 Codex CLI 版本。OpenAI Codex GitHub issue 里有过 `0.129.0` 执行 `/compact` 时因为 `service_tier` 触发 unknown parameter 的回归记录；原文场景里也提到 `0.130.0-alpha.5`。
如果你正在使用 alpha 版本，先把版本号记下来，后面验证时要对比。
codex --version在 Windows 查 config.toml
Windows 上优先检查用户目录下的 `.codex/config.toml`。只要能看到 `service_tier = "default"`，它就是第一优先排查点。
这一步只查配置，不修改文件。
Select-String -Path "$env:USERPROFILE\.codex\config.toml" -Pattern "service_tier"在 macOS 或 Linux 查 config.toml
macOS 和 Linux 通常从 `~/.codex/config.toml` 查。看到 `service_tier = "default"` 时，先按后面的步骤删掉这一行。
如果你同时有项目级配置，也要检查当前项目里是否有覆盖配置。
grep -n "service_tier" ~/.codex/config.toml删除 service_tier default
最推荐的修复是删除 `service_tier = "default"`。默认服务层级不需要显式写出来，让 Codex 和后端自己走默认值。
OpenAI Codex 配置参考把 `service_tier` 标为可选项；Fast 文档里给出的持久化示例是 `service_tier = "fast"`，不是为了默认速度写 `default`。
| 删除这一行 | service_tier = "default" |
| 保留模型配置 | model = "gpt-5.5" |
| 默认服务层级 | 省略 service_tier |
Windows 先备份再编辑
在 Windows 上，先备份一份配置文件，再用记事本打开。删除 `service_tier = "default"` 后保存，关闭当前 Codex 会话，重新打开终端。
不要把整个 `.codex` 目录删掉。这里只需要改一行。
Copy-Item "$env:USERPROFILE\.codex\config.toml" "$env:USERPROFILE\.codex\config.toml.bak"
notepad "$env:USERPROFILE\.codex\config.toml"macOS 或 Linux 编辑配置
macOS 或 Linux 可以直接编辑 `~/.codex/config.toml`。删除 `service_tier = "default"` 后保存，再重新启动 Codex。
如果你不确定配置是否还有其它问题，先保留最小配置，只留下模型名和必要的 provider 信息。
nano ~/.codex/config.toml重新启动 Codex 验证
保存配置后重新打开 Codex。成功标准不是命令能启动，而是最小请求能返回，且不再出现 `service_tier` unknown parameter。
如果最小请求通过，再回到原来的项目会话或 `/compact` 场景验证。
codex exec "Reply with OK only."升级到当前稳定版
如果你正在用 `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` 被占用，可以先结束进程再安装。
npm install -g @openai/codex@latest
codex --version
codex doctorWindows 升级前关闭 codex.exe
Windows 上如果 npm 替换全局 `codex.exe` 时失败，通常是旧进程还在运行。先关闭 Codex，再执行安装。
这一步只处理正在运行的 Codex 进程，不会修改你的项目文件。
taskkill /IM codex.exe /FFast 模式确认支持再打开
如果你的账号、模型和当前登录方式确认支持 Fast mode，再写 `service_tier = "fast"`。OpenAI Codex Speed 文档说明，CLI 可以用 `/fast on`、`/fast off`、`/fast status` 切换，也可以通过配置文件持久化。
不要为了默认速度写 `service_tier = "default"`。这类默认值更安全的写法是省略。
service_tier = "fast"
[features]
fast_mode = true接兼容网关先用最小配置
如果你接的是 OpenAI-compatible API、Azure 网关、OneAPI、LiteLLM、OpenRouter 或公司内部转发层，先不要传 `service_tier`。
很多兼容层只实现核心字段，不一定支持 Codex 的扩展参数。先用最小配置跑通，再逐个加回 provider、base_url、wire_api、reasoning、tools 等配置。
model = "gpt-5.5"仍然报错时按路径判断
删除 `service_tier = "default"` 后，如果错误还在，继续按失败路径判断。不要把所有 unknown parameter 都归到同一行配置。
记录修复后的可用配置
修好以后记录 Codex 版本、配置文件路径、是否删除 `service_tier`、使用的 provider 和验证结果。下次 Codex 再报 unknown parameter，先对比这份记录。
不要记录 API Key。只记录能帮助排查的版本和配置字段。
日期：2026-06-05
Codex CLI：填当前版本
配置文件：~/.codex/config.toml
service_tier：已删除 / fast
Provider：OpenAI 官方 / Azure / OpenAI-compatible 网关
验证命令：codex exec "Reply with OK only."
结果：成功 / 仍失败的错误片段