Troubleshooting

Usage and quota

Why does codex-lb still say rate_limited when Codex Desktop says the window reset? codex-lb refreshes usage on its own schedule and treats upstream samples conservatively. The full policy — refresh cadence, expiry, and why displays can briefly disagree with upstream — is documented in the usage refresh policy context.

Streaming

Codex CLI falls back to POST instead of WebSockets. Run the WebSocket verification steps. If codex-lb sits behind a reverse proxy, make sure it forwards WebSocket upgrades — see Remote Access.

Fast Mode and service tiers

Fast Mode and service-tier behavior is documented in the Responses API compatibility context.

Old Codex sessions missing after migrating

codex resume filters by model_provider — re-tag old sessions with the built-in retag command. See session retagging.

---

Spec: usage-refresh-policy