Troubleshooting
Quick fixes for the most common CodexUse issues.
| Issue | Fix |
|---|---|
| Can’t log in / auth loop | Retry login in your browser. If headless, use device auth. Check system clock skew. |
| CodexUse CLI not found | Reinstall from Settings → CLI, then restart your terminal. |
| Rate limit data missing | Codex CLI must be installed and reachable. Use --no-usage if you just need profiles. |
| Duplicate account warning | Multiple profiles share the same OpenAI account. Merge or rename to avoid splitting usage. |
| MCP server fails to start | Check protocol (stdio/http/sse) and run the command manually to confirm. |
| Auto-roll not switching | Auto-roll triggers only when idle and usage crosses your threshold. |