跳转到主要内容
报错原文对照

Codex 报错原文对照:每条报错的原因在哪一侧、怎么修

输入或粘贴你看到的报错来筛选。每条都标明原因在本机、账号、服务端还是中间的网关,再链到完整的修复步骤。
  • 66 条报错
  • 18 篇修复文章
  • 2026年11月15日 核对

登录、账号与验证

  • Error: account/read failed during TUI bootstrap: account/read failed: workspace routing discovery failed (code -32603)

    • 原因:本机或配置
    • CLI

    这篇文章还覆盖

    • workspace routing discovery timed out
    • Sign-in failed: workspace routing discovery timed out
      • 原因:本机或配置
      • 桌面应用
      • VS Code
    • Error running remote compact task: workspace routing discovery failed
    • workspace routing discovery unauthorized (401)
      • 原因:账号或套餐
      • CLI
      • HTTP 401
    • duplicate workspace in routing discovery
      • 原因:账号或套餐
      • CLI

    Codex 启动秒退看后半句:discovery failed/timed out 先重启后台服务;401、requirements 多是令牌失效;plan type 是凭证混用。

  • Phone number is required

    这篇文章还覆盖

    • You've made too many phone verification requests. Please try again later.
    • This phone number is already linked to the maximum number of accounts
      • 原因:账号或套餐
    • Phone number already in use
    • The phone number you entered is invalid
      • 原因:有多种可能
    • unsupported Codex auth method: apikey

    OpenAI 写明在 ChatGPT 桌面应用访问 Codex 时可能要求验证手机号,邮箱和验证器不能替代,Plus、Pro 用户同样会被要求。按报错原文决定换号、等待还是找客服。

  • Couldn't load workspace settings

    这篇文章还覆盖

    • routePattern=/settings/user status=403 errorCode=cloudflare_challenge
    • DeviceCheck registration failed (403)
      • 原因:本机或配置
      • 桌面应用
      • HTTP 403
      • 26.1002.52244 起出现
      • Issue #53333
    • Unable to load organization settings

    Codex 新聊天报「无法加载工作空间设置」,截至 10 月 15 日官方未修。日志是 Cloudflare 403 可试换节点;DeviceCheck 失败先用旧聊天或 CLI。

  • Token exchange failed: token endpoint returned status 403 Forbidden

    • 原因:有多种可能
    • CLI
    • HTTP 403

    这篇文章还覆盖

    • unsupported_country_region_territory
      • 原因:账号或套餐
      • CLI
    • error sending request for url
      • 原因:本机或配置
      • CLI

    Codex 令牌交换 403 没有通用的一键修复:保留完整错误后缀,回调不通时选设备码或 SSH,地区与工作区拒绝时核对资格和权限,最后在原环境验证原认证方式。

  • Enable device code authorization for Codex in ChatGPT Security Settings

    • 原因:账号或套餐
    • 网页版

    这篇文章还覆盖

    • Please contact your workspace admin to enable device code authentication
      • 原因:账号或套餐
    • Your access token could not be refreshed because your refresh token was revoked. Please log out and sign in again.
      • 原因:账号或套餐
      • CLI
    • ChatGPT login is disabled. Use API key login instead.
      • 原因:账号或套餐
      • CLI
    • Port … is already in use
      • 原因:本机或配置
      • CLI

    Codex 无头登录首选 codex login --device-auth;设备码开不了就用 SSH 转发 1455 端口,再不行复制 auth.json,且一份只给一台机器。

  • unexpected status 401 Unauthorized: Incorrect API key provided

    这篇文章还覆盖

    • {"detail":"Unauthorized"}
      • 原因:账号或套餐
      • HTTP 401

    报错里的 key 以 sk-svcac 开头,是 OpenAI 服务端事故,只能等;key 是 dummy 要重新登录,URL 是中转地址或 key 是你自己的才改配置。

模型不存在或不可用

  • The 'gpt-6.1-sol' model is not supported when using Codex with a ChatGPT account.

    这篇文章还覆盖

    • Error: app server is running but is not managed by codex app-server daemon
      • 原因:本机或配置
      • CLI
    • host Job Object prevents daemon detachment
      • 原因:本机或配置
      • CLI
    • warning: Model metadata for `gpt-6.1-sol` not found. Defaulting to fallback metadata; this can degrade performance and cause issues.
      • 原因:本机或配置
      • CLI

    这句 400 不等于套餐不含 GPT-6.1 Sol:同一 Pro 账号上 CLI 0.158.0 被拒、0.159.0 正常。先核对 ID,再更新 CLI 和后台服务。

  • OpenAI base URL is overridden

    • 原因:网关或中转

    这篇文章还覆盖

    • 没用上 Codex 官方模型列表(登录超过 8 天没有刷新),改用自带列表
    • 刷新 Codex 官方模型列表失败: 读取响应失败: error decoding response body

    CC Switch 路由模式下,OpenAI Official 给 Codex 的是空列表,Codex 退回自带列表,0.165.0 前没有 Terra;回直连并彻底重启即可。

  • Model not found

    • 原因:有多种可能
    • 网页版
    • 桌面应用

    这篇文章还覆盖

    • The 'gpt-5.5' model is not supported when using Codex with a ChatGPT account.
      • 原因:服务端
      • CLI
      • HTTP 400
    • unexpected status 404 Not Found: The model `gpt-5.5` does not exist or you do not have access to it.
    • unexpected status 404 Not Found: Model not found gpt-5.5
    • Model metadata for `gpt-5.5` not found. Defaulting to fallback metadata; this can degrade performance and cause issues.
      • 原因:本机或配置
      • CLI

    ChatGPT 聊天显示 Model not found,先用新对话和同账号浏览器对照,再按需要清理站点数据或联系支持;Codex 明确报 gpt-5.5 时,按登录方式核对退役、权限与配置。

限流与容量

  • exceeded retry limit, last status: 429 Too Many Requests

    这篇文章还覆盖

    • stream disconnected before completion
      • 原因:有多种可能
    • Quota exceeded. Check your plan and billing details.
      • 原因:账号或套餐
      • HTTP 429
    • Error running remote compact task: exceeded retry limit, last status: 429 Too Many Requests
    • Automatic approval review failed: exceeded retry limit, last status: 429 Too Many Requests
    • exceeded retry limit, last status: 500 Internal Server Error
      • 原因:有多种可能
      • HTTP 500

    Codex 报 exceeded retry limit, last status: 429 时,这不是套餐用完的提示;先查并行会话、中转和状态页,再决定等待还是停。

  • Selected model is at capacity. Please try a different model.

    • 原因:服务端
    • CLI
    • 桌面应用
    • HTTP 503

    这篇文章还覆盖

    • Reviewer model is at capacity
      • 原因:服务端
    • Error running remote compact task: Selected model is at capacity
      • 原因:服务端

    Codex 报 Selected model is at capacity,指服务端模型容量不足,不是额度用完或限流,额度充足也会出现。查日志确认后再等待、换模型或开新线程。

请求被拒绝

应用、IDE 与启动

  • Codex could not start — The extension could not start its user interface.

    • 原因:有多种可能
    • VS Code
    • 26.1106.51428 已修复
    • Issue #56655

    这篇文章还覆盖

    • The extension couldn't load its resources.
      • 原因:本机或配置
      • VS Code
      • 26.803.x 起出现
      • 26.810.41047 已修复
      • Issue #37458
    • PendingMigrationError: navigator is now a global in nodejs
      • 原因:本机或配置
      • VS Code
    • View containers cannot be contributed to the Secondary Side Bar in Cursor. It is reserved for Cursor's agent UI.
      • 原因:本机或配置

    Codex could not start:插件 26.1021.22027 的报错已在 26.1106.51428 修复,更新插件并重载窗口;其他情况按日志分环境排查。

  • Local browser use is disabled in Work settings

    这篇文章还覆盖

    设置页“已被你的组织停用”先彻底退出重开,仍在就是管理员或地区限制;任务中报 Work settings 错误,先开新对话、重启,再查工作偏好里的使用本地浏览器。

  • Error submitting message

    • 原因:有多种可能
    • 桌面应用
    • VS Code
    • 网页版

    这篇文章还覆盖

    • Error creating task: Timeout
      • 原因:本机或配置
      • 桌面应用
      • VS Code
    • invalid turn/start params: AbsolutePathBuf deserialized without a base path
      • 原因:本机或配置
      • 桌面应用
      • 网页版
    • failed to start turn: internal error; agent loop died unexpectedly
      • 原因:本机或配置
      • 桌面应用
    • Can't find variable: DisposableStack
      • 原因:本机或配置
      • 网页版
      • VS Code
    • no rollout found for thread id
      • 原因:本机或配置
      • 桌面应用
      • VS Code

    Codex「提交消息时出错」看第二行:新会话一发就 Timeout 多半是 MCP 服务器拖住,排队消息失效、AbsolutePathBuf 各有办法。重试前先确认消息是否已发出。

文件、会话与本地状态

这份清单怎么维护

  • 只收录本站已有文章覆盖的报错,原文逐字取自对应文章。
  • 版本号、HTTP 状态码和 GitHub issue 编号都是对应文章引用的;文章没有给出的,这里留空。
  • 原因标签说明先看哪一侧,怎么确认写在文章里。

清单最后核对于 2026年11月15日。