Home / Guides / Codex Usage
How to Check Your Codex Usage and Rate Limits
Check Codex subscription usage at chatgpt.com/codex/settings/usage, or run /status for provider-reported percentages and reset times. platform.openai.com/usage is the separate API usage and spend dashboard.
Last updated August 15, 2026 · OpenAI documentation and ccusage support re-verified August 15, 2026 · By Soren Starck, indie dev in Lyon and maker of SessionWatcher
Understanding Codex Usage Limits
OpenAI documents a weekly cap (five-hour window suspended 12 July 2026) for local messages and cloud chats and says additional weekly limits may apply. Exact limits vary by plan and task. The authoritative values are the percentage used and reset time OpenAI reports for your account.
A usage limit can still interrupt active work. Because the limits OpenAI applies vary by account, plan, and task, check the provider-reported percentage and reset time instead of assuming a universal cap.
Method 1: Run /status inside Codex CLI
The fastest free check is the built-in slash command. Inside an active Codex CLI session, type:
/statusYou'll see the provider-reported percentage used and reset time for the limits OpenAI returns, along with session details such as the active model.
Limitations: /status only works while Codex is open and active: it's an on-demand snapshot, not an always-visible watch. You also have to remember to run it.
Method 2: OpenAI usage pages
Use the dashboard that matches what you are checking:
- Open chatgpt.com/codex/settings/usage for Codex subscription limits.
- Use platform.openai.com/usage only for metered API usage and spend.
- Run
/statusfor current limits in an active CLI session.
Important distinction: Codex subscription allowances and API billing are separate surfaces. Do not use the API usage dashboard as a substitute for the Codex usage page.
Method 3: Free CLI trackers such as ccusage
The open-source ccusage CLI supports Codex reports as well as Claude Code and other coding agents. Its current README documents ccusage codex daily.
For free checks, choose between OpenAI's Codex usage page, /status, and a terminal report such as ccusage. A menu-bar app is an optional always-visible interface.
Method 4: SessionWatcher (always-on, in your menu bar)
Here's the friction the free options share: /status requires you to context-switch into Codex and remember to ask, while the usage pages require a browser tab. They are manual checks rather than an always-visible view.
SessionWatcher for Codex is a native macOS menu bar app. It displays OpenAI-reported limit percentages and reset times, local session token totals, and estimated API-equivalent cost; that estimate is not actual ChatGPT subscription spend.
- Provider-reported limits. Percentage used and reset time for each limit OpenAI returns.
- Local token totals. Tokens recorded in local Codex session data.
- Estimated API-equivalent cost. A pricing estimate, not actual subscription spend.
- Optional macOS notifications. An app feature for reported usage; notifications do not control or prevent OpenAI limits.
- All supported tools in one app. Claude Code, Codex, Cursor, Copilot, Gemini CLI, Antigravity, opencode, Z.ai, Grok, OpenRouter, Devin, and Kimi Code.
SessionWatcherStop finding out at 2am.
Just glance up.
Native macOS menu bar app. Track Claude and Codex usage, costs, and rate limits in real-time.
“Fast, simple, and does exactly what it should. Definitely worth it.”
@nicojerome on GitHub
macOS 14+. 7-day Bundle trial. No credit card.
Side-by-side: API usage dashboard vs /status vs ccusage vs SessionWatcher
| Capability | API usage dashboard | /status | ccusage (CLI) | SessionWatcher |
|---|---|---|---|---|
| Tracks Codex subscription limits | No, API usage and spend only | Yes | No, local usage reports | Yes |
| Live weekly cap | N/A, API spend only | On demand | N/A | Always visible |
| Provider-reported limits and resets | N/A, API spend only | On demand | N/A | Always visible |
| Usage notifications | N/A, API spend only | On-demand output | N/A | Optional macOS notifications |
| Multi-tool (Claude, Codex, Cursor, Copilot, Gemini, Antigravity, opencode, Z.ai, Grok, OpenRouter, Devin, Kimi) | API usage only | Codex only | Multiple supported agents | All supported tools |
| Setup | Browser dashboard | Built in | npm + CLI | Install the macOS app |
| Cost | Free | Free | Free | $6.99 one-time |
| Open Dashboard → | Built into Codex CLI | ccusage on GitHub → | Download for Free |
Source note: ccusage's current README documents Codex support and the ccusage codex daily command (verified August 15, 2026).
How Codex reports usage windows
OpenAI's Codex pricing documentation, re-verified August 15, 2026, says local messages and cloud chats shared a five-hour window until it was suspended on 12 July 2026 and that additional weekly limits may apply. It does not document per-token rolling-return mechanics. Use /status or the Codex usage page for the percentage and reset time reported for your account.
Frequently Asked Questions
How do I check my Codex usage?
Run /status for current provider-reported limits, open chatgpt.com/codex/settings/usage for Codex subscription limits, or use SessionWatcher's menu bar Codex tracker for an always-visible view.
What happened to the Codex 5-hour rate limit window?
OpenAI's Codex pricing documentation, re-verified August 15, 2026, says local messages and cloud chats shared a five-hour window until it was suspended on 12 July 2026 and that additional weekly limits may apply. Exact limits vary by plan and task; check the percentage and reset time shown for your account.
Where is the Codex usage dashboard?
The official Codex subscription page is chatgpt.com/codex/settings/usage. platform.openai.com/usage is the separate API usage and spend dashboard.
Why did my Codex stop working mid-session?
If Codex stops mid-session, check /status or the Codex usage page to see whether OpenAI has applied a usage limit to your account. SessionWatcher keeps reported usage visible and offers optional macOS notifications, but it does not control or prevent OpenAI limits.
Is there a free Codex usage monitor?
/status is built into Codex CLI and free. The official Codex usage page is also available, and the open-source ccusage CLI supports Codex reports. For an always-on Codex tracker, SessionWatcher is $6.99 one-time.
Does ccusage work with Codex?
Yes. The current ccusage README documents Codex reports, including ccusage codex daily.
Is there a Codex monitor app for macOS?
Yes. SessionWatcher for Codex is a native macOS menu bar app. $6.99 one-time, or Pro ($59 one-time, or $24/year) covering all supported tools. It shows provider-reported limits, local token totals, and estimated API-equivalent cost.