Skip to main content
Exact error text

Codex Error Messages: Exact Text, Where the Cause Sits, and the Fix

Type or paste the message you see to filter the list. Each entry shows whether the cause is on your machine, your account, the service or a gateway in between, then links to the full fix.
  • 62 messages
  • 17 fix guides
  • Checked November 15, 2026

Sign-in, account and verification

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

    • Cause: your machine or config
    • CLI

    Also covered in this guide

    • workspace routing discovery timed out
    • Sign-in failed: workspace routing discovery timed out
      • Cause: your machine or config
      • Desktop app
      • VS Code
    • Error running remote compact task: workspace routing discovery failed
    • workspace routing discovery unauthorized (401)
      • Cause: account or plan
      • CLI
      • HTTP 401
    • duplicate workspace in routing discovery
      • Cause: account or plan
      • CLI

    workspace routing discovery failed or timed out clears in most reports with a background-server restart; unauthorized (401) needs a new sign-in on that host.

  • Phone number is required

    Also covered in this guide

    • You've made too many phone verification requests. Please try again later.
    • This phone number is already linked to the maximum number of accounts
      • Cause: account or plan
    • Phone number already in use
    • The phone number you entered is invalid
      • Cause: several possible
    • unsupported Codex auth method: apikey

    Codex in the ChatGPT desktop app may require phone verification that email or an authenticator app can't replace. What each error means and the safe next step.

  • Token exchange failed: token endpoint returned status 403 Forbidden

    • Cause: several possible
    • CLI
    • HTTP 403

    Also covered in this guide

    • unsupported_country_region_territory
      • Cause: account or plan
      • CLI
    • error sending request for url
      • Cause: your machine or config
      • CLI

    A Codex token-exchange 403 is a refused authentication request. The full error tells you whether to repair callback access, check the client’s network, renew stored credentials, or stop for an access restriction.

  • Enable device code authorization for Codex in ChatGPT Security Settings

    • Cause: account or plan
    • Web

    Also covered in this guide

    • Please contact your workspace admin to enable device code authentication
      • Cause: account or plan
    • Your access token could not be refreshed because your refresh token was revoked. Please log out and sign in again.
      • Cause: account or plan
      • CLI
    • ChatGPT login is disabled. Use API key login instead.
      • Cause: account or plan
      • CLI
    • Port … is already in use
      • Cause: your machine or config
      • CLI

    On a server with no browser, run codex login --device-auth and enter the code on any device. If that is blocked, tunnel port 1455 over SSH or copy auth.json.

Model not found or not available

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

    Also covered in this guide

    • Error: app server is running but is not managed by codex app-server daemon
      • Cause: your machine or config
      • CLI
    • host Job Object prevents daemon detachment
      • Cause: your machine or config
      • CLI
    • warning: Model metadata for `gpt-6.1-sol` not found. Defaulting to fallback metadata; this can degrade performance and cause issues.
      • Cause: your machine or config
      • CLI

    The error doesn't prove your plan is excluded: on one Pro account, Codex CLI 0.158.0 got it and 0.159.0 worked. Check the ID, client, daemon, then the account.

  • OpenAI base URL is overridden

    • Cause: gateway or relay

    Also covered in this guide

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

    In CC Switch Routing mode, Codex gets an empty model list and shows its bundled one, which has GPT-6.1 Terra only from 0.165.0. Go back to Direct and restart.

  • Model not found

    • Cause: several possible
    • Web
    • Desktop app

    Also covered in this guide

    • The 'gpt-5.5' model is not supported when using Codex with a ChatGPT account.
      • Cause: the service
      • 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.
      • Cause: your machine or config
      • CLI

    ChatGPT "Model not found" since Oct 14 has no official cause: try a new chat or browser, then support. In Codex, gpt-5.5 retired; use gpt-6.1-sol.

Rate limits and capacity

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

    Also covered in this guide

    • stream disconnected before completion
      • Cause: several possible
    • Quota exceeded. Check your plan and billing details.
      • Cause: account or plan
      • 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
      • Cause: several possible
      • HTTP 500

    “exceeded retry limit, last status: 429 Too Many Requests” is a 429 Codex couldn't classify, not your usage limit. First stop parallel chats and sub-agents.

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

    • Cause: the service
    • CLI
    • Desktop app
    • HTTP 503

    Also covered in this guide

    • Reviewer model is at capacity
      • Cause: the service
    • Error running remote compact task: Selected model is at capacity
      • Cause: the service

    “Selected model is at capacity” means OpenAI had no room to serve that model, not that you ran out of usage. Wait, try one other model, or start a new chat.

Request rejected

App, IDE and startup

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

    • Cause: several possible
    • VS Code
    • Fixed in 26.1106.51428
    • Issue #56655

    Also covered in this guide

    • The extension couldn't load its resources.
      • Cause: your machine or config
      • VS Code
      • Since 26.803.x
      • Fixed in 26.810.41047
      • Issue #37458
    • PendingMigrationError: navigator is now a global in nodejs
      • Cause: your machine or config
      • VS Code
    • View containers cannot be contributed to the Secondary Side Bar in Cursor. It is reserved for Cursor's agent UI.
      • Cause: your machine or config

    “Codex could not start — The extension could not start its user interface” on build 26.1021.22027: fixed in 26.1106.51428 (Nov 11, 2026). Update and reload.

  • Local browser use is disabled in Work settings

    Also covered in this guide

    Browser on but Codex says it is disabled? Fully quit and reopen the ChatGPT app, continue in a new chat, then check Work preferences → Local browser use.

  • Error submitting message

    • Cause: several possible
    • Desktop app
    • VS Code
    • Web

    Also covered in this guide

    • Error creating task: Timeout
      • Cause: your machine or config
      • Desktop app
      • VS Code
    • invalid turn/start params: AbsolutePathBuf deserialized without a base path
      • Cause: your machine or config
      • Desktop app
      • Web
    • failed to start turn: internal error; agent loop died unexpectedly
      • Cause: your machine or config
      • Desktop app
    • Can't find variable: DisposableStack
      • Cause: your machine or config
      • Web
      • VS Code
    • no rollout found for thread id
      • Cause: your machine or config
      • Desktop app
      • VS Code

    “Error submitting message”, once “Error creating task”, is a Codex client banner: line 2 names the cause. On a new chat, Timeout often means a stuck MCP server.

Files, sessions and local state

How this list is kept

  • A message is listed only when a guide on this site covers it, and the text is copied character for character from that guide.
  • Versions, HTTP statuses and GitHub issue numbers are the ones the linked guide cites. Where a guide gives none, the field is left empty.
  • The cause label says where to look first. The guide explains how to confirm it.

List last checked on November 15, 2026.