Codex「Selected model is at capacity」报错:原因与解决方法
区分 Codex 服务端容量错误与使用额度耗尽,更新发生问题的客户端,测试其他模型,并排查单账号持续失败的情况。了解 OpenAI 在 Retry-After 机制上的改动,以及如何通过有限次数的重试、任务检查点和独立计费的备用 API,保护长时间运行的开发任务与 CI 流程。
本文内容

Codex 出现 Selected model is at capacity. Please try a different model.,表示模型处理容量出现问题,并不能证明你的使用额度已经耗尽。如果 CLI、桌面应用或 IDE 扩展因此无法继续工作,先更新发生问题的客户端,再尝试其他可用模型。如果 Codex 已经按照服务器指示等待重试,先让这次等待结束,不要急着提交新的请求。
这是容量错误,还是使用额度耗尽?
Codex 将这条错误归类为 ServerOverloaded。API 错误映射代码会把 server_is_overloaded 映射到这个错误。与之不同,UsageLimitReached 会在面向客户端的协议中转换为 UsageLimitExceeded。
错误定义中还包含 PolicyCapacityUnavailable,对应的提示是 Policy-restricted capacity is unavailable. Please try again later.。它使用与普通容量错误相同的重试策略,但属于另一种错误。这两条消息都不能单独证明你的账号遭到了封禁。
先打开 Codex 使用情况面板,检查剩余使用额度。如果实际错误明确表示额度耗尽,再参考 Codex 使用限额与重置时间指南。遇到容量错误时,不应该把购买额外额度作为第一步排查措施。
应该先尝试哪些修复方法?
更新实际发生错误的客户端
截至 2026-11-17,OpenAI 的最新稳定版 Codex CLI是 0.169.0。如果当前安装版本较旧,先完成更新,再检查重试行为。
如果通过 npm 安装了 CLI,在 Bash 中执行:
codex --version
npm install -g @openai/codex
codex --version
最后一条命令应显示更新后的版本。使用其他安装方式时,请参考对应的官方更新说明。如果通过 Remote SSH 工作,也要检查远程主机上的 CLI 版本。
如果错误发生在桌面应用或 IDE 扩展中,需要单独更新对应客户端,然后重新启动。如果桌面应用由组织统一管理,更新可能需要管理员批准并部署。可以参考 Codex CLI、桌面应用和 IDE 扩展对比,确定需要检查哪个客户端。
尝试其他可用模型,或者等待自动重试结束
在 CLI 中使用 /model,从列表里选择另一个模型。然后按照命令参考文档的说明,使用 /status 确认当前选择。恢复原任务之前,先发送一个简单请求,例如 Reply with OK.。
如果收到了完整回复,说明这个模型和当前连接路径至少成功处理了这次请求。但这不代表原来的模型已经恢复。如果多个模型都失败,就不要继续反复切换,转而检查账号和认证状态。
如果客户端已经在自动重试,应遵守服务器给出的等待时间。不要反复重新启动同一个请求,也不要同时运行多个重复任务。可以查看 OpenAI 状态页面是否存在服务故障,但要注意,该页面显示的是整体服务状态,不能据此确认某个账号一定能够正常使用。
如果等待结束后错误再次出现,立即提交 /feedback。保存错误发生时间、选择的模型、客户端版本,以及系统提供的反馈标识,方便后续向支持团队说明问题。
容量恢复期间,应该选择哪种访问方式?
如果等待时间不会影响任务截止期限,可以继续使用当前访问方式。如果本地开发工作需要备用方案,可以考虑单独计费的 API 路径。
| 方案 | 所需条件与计费方式 | 适用情况 |
|---|---|---|
| 等待后重试 | 使用现有账号和访问权限,不需要配置新的付款方式。遵守服务器提供的等待时间。 | 必须使用当前模型,而且等待时间可以接受。 |
| 切换其他模型 | /model 中为当前账号和工作空间提供的模型,仍受现有访问权限限制。 | 简单测试成功,而且替代模型能够完成当前任务。 |
| OpenAI API | 需要 API Key、API 计费设置,以及从支持的国家或地区访问服务。本地 Codex 使用量按照 API Token 价格计费。 | 需要直接使用按量付费的 API,而不是依赖订阅访问权限。 |
| BetterToken API | 需要自己的 BetterToken 账号、API Key,以及通过控制台提供的付款方式充值的余额。官方文档中的 Codex 自定义 Provider使用 Responses。费用按照所选模型的 Token 计费规则计算。 | 希望使用按量付费的 API 网关,并且能够在正式依赖它之前完成配置和测试。 |
API 费用与 ChatGPT 订阅使用额度相互独立。切换 API 不会恢复或补充订阅额度。为备用方案充值之前,先根据实际工作量核对 BetterToken API 当前价格。
上述 API 方案针对本地 Codex 工作流。OpenAI 认证文档说明,Codex Cloud 需要通过 ChatGPT 登录。不要认为更换本地 Provider 就能把已经运行的云端任务迁移过去。
配置方法可以参考 Codex 自定义 Provider 接入指南。在把尚未完成的仓库任务交给新 Provider 之前,先向选定的 Endpoint 发送一个简单请求,确认连接正常。
OpenAI 在 11 月做了哪些改动?为什么等待时间可能变长?
目前公布的改善是遇到容量错误的日活用户占比下降,并不意味着每次请求都能立即获得服务。
在 Tibo 11 月 16 日发布的帖子中,@thsottiaux 表示,团队可能已经修复了反复出现的容量错误。配图统计的是每日活跃用户中,至少有一个响应轮次以容量错误结束的用户比例。
根据图表,在 2026 年 10 月 15 日至 11 月 12 日(UTC)的统计区间内,这一比例从 10 月 19 日的 6.82% 降至 11 月 12 日的 0.085%。这个指标不是全部请求中的失败请求比例。
图表标出了六项与 Retry-After 有关的改动。Retry-After 用于传递服务器建议的下一次重试时间。
- 10 月 15 日: 桌面版本加入 WebSocket 重试修复。
- 10 月 22 日: Responses 为普通过载情况增加等待时间。
- 10 月 23 日: 服务等级过载情况开始提供重试时间。
- 10 月 24 日: Codex 开始转发重试和停止指令。
- 10 月 30 日: Responses 为
NO_MORE_RETRY增加等待时间。 - 11 月 6 日: Responses 在 WebSocket 错误中保留该等待时间。
当前源码将 ServerOverloaded、PolicyCapacityUnavailable 和 RetryLimit 分配给 RetryPolicy::ServerDirected。已经发布的 0.169.0 版本代码也会针对这些错误使用服务器提供的等待时间。当存在重试指示时,请求可以先等待,而不是立即以错误结束。
遇到容量错误的日活用户占比下降,可以与等待时间变长同时发生。
图表没有提供响应轮次耗时的 p95 数据。p95 表示 95% 的响应轮次能够在该时间以内完成。图表也没有统计整个开发任务是否最终完成。
Codex 的重试处理代码仍然保留重试次数限制。服务器指示只控制等待时间,并不意味着可以无限重试,也不保证最终一定成功。
如果只有一个账号持续报错,应该怎么排查?
检查账号和认证路径,但不要直接认定账号受到了限制。
截至 2026-11-17,GitHub issue #60767仍处于开放状态。报告者 xiaogu12138 描述了一个 Plus 账号在仍有剩余使用额度的情况下,CLI 和 VS Code Remote SSH 都持续发生故障。报告还指出,同一台服务器上的另一个 Plus 账号可以正常工作。
该报告中的自动重试等待时间约为 314–317 seconds。报告还提到,之后出现了一次 401 Unauthorized 响应,以及另一条独立的 token_revoked 错误。
目前没有证据证明这些认证错误导致了容量错误。检查过的日志也无法独立确认相关记录确实属于发生问题的账号。
可以参考这个案例组织自己的排查过程,但不要直接假设原因相同:
- 保持对比条件一致。 私下记录账号和工作空间、客户端版本、模型、主机,以及包含时区的错误时间。在 CLI 和 IDE 扩展中使用相同的简单提示词进行测试。获得授权的同事可以独立测试自己的账号,但不要互相交换登录凭据。
- 只有出现认证错误证据时才重新登录。 如果保存的 ChatGPT 登录状态出现
401或token_revoked,执行codex logout,然后执行codex login。之后重新发送同一个简单请求。仅仅出现容量错误,不构成删除认证文件的理由。 - 反复失败时向支持团队提交报告。 再次发生错误后立即运行
/feedback。向 OpenAI Support提供反馈标识、复现步骤、重试等待时间,以及能够获取的 Request ID。
不要在 GitHub issue 中公开账号凭据、认证文件或私有仓库内容。一次重试成功可以作为排查证据,但对于间歇性故障,还需要记录多次错误发生的时间。
如何避免容量错误毁掉一次长时间运行的任务?
把任务拆分成可以检查的阶段,并在响应轮次失败时保存当前状态。部署、付款和其他会产生外部副作用的操作,不要放进不加判断的自动重试循环。
下面的 Bash 示例用于只读诊断。它会记录事件,并保留 CLI 的退出状态。请在专门为该任务准备的仓库工作副本中运行:
umask 077
status=0
codex exec --json --sandbox read-only \
"Inspect the repository and report the next unfinished step. Do not edit files." \
>codex-events.jsonl 2>codex-stderr.log || status=$?
printf '%s\n' "$status" >codex-exit-code.txt
exit "$status"
配置 CI,使步骤失败时也能保留这些文件。非交互式接口文档说明,该接口会输出 thread.started、turn.completed、turn.failed 和 error 事件。
在允许后续步骤执行之前,至少检查三个条件:
- 进程正常退出。
- 响应轮次已经完成。
- 当前任务要求的检查全部通过。
同时保存仓库工作副本和 Codex 的私有会话存储目录。事件日志本身并不等于保存下来的会话。对于需要恢复执行的任务,不要使用 --ephemeral。也不要把包含认证凭据的整个 Codex Home 目录上传为公开构建产物。
等待时间结束或根本问题解决后,应该恢复之前记录的会话,而不是随便选择最近运行的任务。如果已经安装 jq,可以在原始仓库工作副本中执行以下 Bash 命令:
session_id=$(jq -ers \
'[.[] | select(.type == "thread.started") | .thread_id] | first // empty' \
codex-events.jsonl) &&
codex exec --sandbox read-only resume "$session_id" \
"Inspect the existing work and report the next unfinished step. Do not edit files."
在 CI 任务执行器中设置整个任务的最长运行时间,并限制恢复尝试的次数。只有确认错误属于暂时性故障时才重试,同时遵守服务器提供的等待时间。
遇到认证、权限或使用额度耗尽错误时,应停止重试,不要反复提交相同请求。
如果任务截止时间迫使你切换到其他 Provider,应从已经保存的检查点继续,并提供清楚的交接说明,列出已完成的工作和剩余检查项。继续之前先检查现有 diff,避免备用 Provider 重复执行已经完成的外部操作。