The Codex Error Encyclopedia
One page per exact error string. Each entry is mined from the openai/codex issue tracker and community reports, and each carries a tested or community-verified fix with its sources listed.
How are these fixes verified?
Every entry starts from primary sources — the openai/codex issue tracker, official docs, and release notes — plus community reports from places like r/codex. When a fix is confirmed in release notes or official documentation, we say so and link it. When it's a workaround that worked for other reporters, we label it community-reported. Each page lists its sources and shows the date we last verified the facts.
Documented errors
Update the CLI first — bubblewrap sandbox fixes land in the near-daily release cadence. On Windows, use the native Windows sandbox (elevated or unelevated PowerShell modes); the official docs now recommend it by default, with WSL reserved for Linux-native tooling. If you do need WSL, it must be WSL2 — WSL1 support ended when the Linux sandbox moved to bubblewrap in Codex 0.115, having worked through 0.114.
There is no single confirmed fix. Community-reported mitigations, roughly in order of payoff: retry the task (disconnects are often transient), split long-running jobs into shorter tasks so less work is lost mid-stream, check OpenAI's status page for an active incident before debugging your own setup, and update the CLI — releases ship near-daily, and stream-handling fixes land without much fanfare.
Community-reported mitigations, in order: sign out and back in so the CLI refreshes its entitlement state; redo the math against the official rate card, because limits apply per rolling 5-hour window and a full dashboard balance can hide an exhausted window; and if you're genuinely out, buy top-up credits where your plan offers them. There's no official fix for the dashboard/CLI mismatch itself — it's tracked as openai/codex issue #30041.
Hitting an error that isn't documented here? The set churns with every CLI release — they ship near-daily — and we add pages as new strings surface. Theopenai/codex issue trackeris the best first stop for anything not yet listed, and ourusage-limits reference covers the quota side of the house.