Codex usage guide

Where to find Codex usage limits and reset information on macOS

The useful answer is not a quota number copied from somebody else. It is the current allowance and reset information for the account, plan, and workspace you are using right now.

AI Usage Ball showing Claude, Codex, and Antigravity usage as liquid gauges

Codex usage is easy to miss when you move between the desktop app, CLI, and other ChatGPT surfaces. Before a long coding task, check the account usage view instead of assuming that every message costs the same amount.

Where to check Codex usage

  1. Open the Codex or ChatGPT usage area for the account you intend to use.
  2. Look for the usage summary, limit banner, or Settings usage view. The exact labels and available options depend on your plan and account.
  3. If you are working in the CLI, try /status in the active session when that command is available.

OpenAI's current guidance says to use the Codex usage page or limit banner when you are near a limit. It also explains that plan limits and credit options vary, so the account-specific view is the source of truth.

What the usage view is telling you

Depending on your account, you may see more than one allowance: a short usage window, a weekly allowance, a monthly or workspace allowance, or a credit balance. Treat these as separate states. One can be available while another is nearly exhausted.

Do not turn a percentage into a fixed number of prompts. Codex work consumes different amounts depending on the size and complexity of the task, the model, the context carried into the task, and where the work runs.

Why the same plan can feel different on different days

A small function and a long-running repository refactor are not equivalent units of usage. A task that reads many files, runs tools, or keeps a large context can use more of the available allowance than a short request. This is why old screenshots and “one message equals X percent” rules are unreliable.

Codex usage can also share an agentic allowance with other supported ChatGPT features. If the remaining amount looks surprising, verify the signed-in account, workspace, and the surface where the usage was generated before concluding that the meter is wrong.

What to do when you are close to the limit

  • Save the current work and check the reset information before starting another long task.
  • Use a smaller scope or a lighter model when that is appropriate for the task.
  • Check whether your account offers credits, an available reset, an upgrade, or only the option to wait.
  • Do not assume reinstalling the client will refresh an account-side limit.

Keep Codex status visible while you work

The official usage page is the right place for account details. A persistent indicator is useful for the moment after you leave that page: before launching a deep task, while switching between coding assistants, or when deciding whether to wait for a reset.

AI Usage Ball is a local macOS widget that brings available Claude, Codex / ChatGPT, and Antigravity usage information into three glanceable liquid gauges. It is designed to keep the next decision visible without opening another dashboard.

Sources

See the remaining allowance before the next task.

A beautiful desktop widget for keeping Claude, Codex / ChatGPT, and Antigravity usage and reset information in sight.

Download free for macOS