service_tier 报错是什么意思
Codex CLI 在对话、上下文压缩、兼容网关请求或某些插件路径里失败，并出现 Unknown parameter: 'service_tier'，先看本地 config.toml 有没有显式写 service_tier。
这个错误不像模型不可用，更像请求里多带了后端不认识的参数。不要先重置账号、Key 或模型名，先看本地 config.toml。
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" 或升级后，再用同一个命令确认版本和复现结果。
codex --versionWindows 上应该查哪个 config.toml
Windows 上优先检查用户目录下的 .codex/config.toml。只要能看到 service_tier = "default"，它就是第一优先排查点。
这一步只查配置，不修改文件。
Select-String -Path "$env:USERPROFILE\.codex\config.toml" -Pattern "service_tier"macOS / Linux 上应该查哪里
macOS 和 Linux 通常从 ~/.codex/config.toml 查。看到 service_tier = "default" 时，先按后面的步骤删掉这一行。
如果你同时有项目级配置，也要检查当前项目里是否有覆盖配置。
grep -n "service_tier" ~/.codex/config.tomldefault 什么时候会出问题
最推荐的修复是删除 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 目录删掉。这个问题通常只需要改一行。
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 信息。
nano ~/.codex/config.toml删完后怎么确认生效
保存配置后重新打开 Codex。成功标准不是命令能启动，而是最小请求能返回，且不再出现 service_tier unknown parameter。
如果最小请求通过，再回到原来的项目会话或 /compact 场景验证。
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 被占用，可以先结束进程再安装。
npm install -g @openai/codex@latest
codex --version
codex doctorWindows 升级失败先查什么
Windows 上如果 npm 替换全局 codex.exe 时失败，通常是旧进程还在运行。先关闭 Codex，再执行安装。
这一步只处理正在运行的 Codex 进程，不会修改你的项目文件。
taskkill /IM codex.exe /F什么时候才应该打开 Fast 模式
如果你的账号、模型和当前登录方式确认支持 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 都归到同一行配置。
只有 /compact 失败
优先查 Codex 版本和上下文压缩路径。GitHub issue 里曾出现 /compact 专门带出 service_tier 的回归。
只有兼容网关失败
优先查网关是否透传或拒绝扩展字段。OpenAI-compatible 不等于支持所有 Codex 请求参数。
升级后才开始失败
先对比升级前后的 Codex CLI 版本和 config.toml。alpha 版本不要长期放在主力环境。
删除 default 后变成其它 unknown parameter
继续查配置里是否还有网关不支持的扩展字段，例如 compaction、reasoning 或缓存相关字段。