Codex CLI Quota Check: Find Usage and Plan Your Next Session

Check the usage information available in Codex CLI, separate account limits from local errors, and leave a clear next step before you pause or switch assistants.

Updated 5 min read

For a Codex CLI quota check, enter /status inside an active Codex session to inspect the remaining usage information available to your account. Cross-check current limits and reset times through the usage dashboard linked in OpenAI's usage guidance (opens in a new tab). Check before starting a large change so you can choose a manageable stopping point.

Tools like fenbs keep project decisions and a continuation brief outside any one assistant, so another connected AI can read where the work stands if you need to switch. That helps preserve progress; it does not increase your Codex allowance.

How do I check usage from the terminal?

  1. In your normal terminal, run codex login status. Note the authentication method it reports before deciding which usage screen to check.
  2. Open Codex in your project folder with codex, or return to your existing interactive session.
  3. Enter /status in the Codex input area. Read the available limit information separately from session details such as the active model and context usage.
  4. Follow the usage dashboard link in OpenAI's guidance above. Confirm the browser account and workspace, then read the limits and reset times shown there.
  5. Write down which allowance you checked and when. Use that result to choose a small task you can finish and verify, or pause until capacity is available.
Run these in your normal terminal, one command at a time
codex login status
codex
Run this inside the interactive Codex session
/status

The slash belongs in the Codex input area. If you enter /status at a normal shell prompt, the shell error tells you nothing about your account allowance. For other terminal actions, use the Codex CLI commands guide.

If /usage appears in your slash menu, it offers account activity views such as daily, weekly, and cumulative token activity. Tokens are the small units of text a model processes. OpenAI documents that command and its sign-in requirement in the CLI command reference (opens in a new tab); activity totals should not be mistaken for a remaining-quota figure.

Which account and allowance am I looking at?

Start with the sign-in method because it determines where to investigate. OpenAI distinguishes ChatGPT subscription access from API-key access, which is billed through OpenAI Platform. Its authentication guide (opens in a new tab) explains both paths and confirms that codex login status reports the active authentication method.

  • ChatGPT sign-in: check the usage information for the account and workspace you are using in Codex.
  • API-key sign-in: check the relevant OpenAI Platform organization and project, including usage, credits, and limits.
  • A managed company setup: ask the administrator which account or provider supplies your access if the reported method is unfamiliar.

A successful login-status command is evidence about authentication, not proof that another model request will be accepted. Also check that your browser has not opened a different account from the one you intended to inspect.

For API access, OpenAI's rate-limit guide (opens in a new tab) explains that request limits apply at the organization and project levels and vary by model. Those are different from a ChatGPT subscription allowance. For access and billing choices beyond this check, see Codex CLI pricing.

What if no remaining quota appears?

An absent number is not evidence of unlimited access or an exhausted account. Confirm that you used the command inside Codex, check the sign-in method, and use the relevant account dashboard. If the screen cannot load, resolve that failure before drawing a conclusion about your allowance.

Keep context capacity separate from account quota. Context is the material a model can work with in a conversation; account quota controls available service usage. A context indicator therefore cannot tell you how many more coding tasks your account will support.

Record the exact message, CLI version, authentication method, and time when asking for help. Share only the relevant diagnostic details, with credentials removed. A screenshot of a blank usage area is less useful than a description of which command produced it and whether the dashboard worked.

Does the error mean my quota is exhausted?

Read the complete error before changing accounts or settings. OpenAI's API error reference (opens in a new tab) distinguishes temporary throttling, exhausted credits, spend limits, authentication failures, and connection problems. For API errors, the message and error code matter alongside the HTTP status.

Use the reported cause to choose your next check
What you seeWhat to check next
A ChatGPT usage-limit messageRead the account usage dashboard and any reset information shown.
API 429 with a request-rate messageSlow requests down and follow Retry-After when provided.
API 429 naming credits, spend, or usage limitsCheck the specific account limit or balance; repeated retries will not restore access.
Rejected sign-in or invalid credentialsResolve authentication for the intended account.
A connection failure or timeoutInvestigate the connection and service response before assuming quota is depleted.
A local command or file-access errorCheck the command, project location, and local permissions.

Treat a local permission denial as a separate troubleshooting path. For example, if a test command cannot read a project folder, inspect that folder and the command it ran. Changing account limits would not repair the folder access; the Codex CLI on Windows guide covers that environment separately.

How should I plan the next coding session?

Choose a stopping point based on a finished result, rather than an estimate of remaining prompts. For example, ask for one validation fix and its relevant test before starting a larger redesign. A displayed allowance is not a promise that a particular change will fit.

Keep a continuation record while you can still work. Include the objective, current files, what changed, what was checked, unresolved failures, and the next action. If a limit prevents another assistant response, write the missing details yourself instead of relying on a final summary request.

Example continuation record for a fictional invoice app
Goal: reject invoice dates that are not valid.
Changed: src/invoices/validate.ts, not committed.
Checked: one focused validation test passed.
Not checked: full test suite and browser behavior.
Next: add the empty-date test, then run the full suite.
Rule from the owner: do not change invoice numbering.

Replace the example with facts from your own session. Name checks that actually ran and distinguish an observed result from an assumption. The Codex CLI best practices guide covers broader task setup.

A shared record in fenbs gives the next connected assistant the project rules and saved progress without making you reconstruct the work from memory.

How fenbs helps

Keep the next step ready when Codex pauses

Save the task status, checks, and next action in fenbs before you switch assistants. Connect another supported AI to read the same project record and continue from that point. Keep the code available to the next assistant separately; fenbs does not move your local files.

Create a free account

Free for one person · No credit card · Works with Claude, ChatGPT, Cursor and more

How to do this with fenbs

  1. Create a free account, free for one person, no credit card.
  2. Add your project and a task for the change you are making. State the result you need and the files or area involved.
  3. Connect Codex and any other supported assistant you intend to use through the browser sign-in setup.
  4. Record decisions you have made in Decisions and rules, including any limits on what the next assistant may change.
  5. Ask the connected assistant to save progress before stopping: where the task stands, checks completed, unresolved problems, and the next step. At the next session, ask the assistant to read the project context first.

If all you need is a quota display, OpenAI's own usage screens are the better fit. fenbs does not monitor Codex quota, reset limits, or import your chat history. Its role here is keeping a reliable AI handoff when a session ends or the coding tool changes.

For more about the tools that organize coding sessions, explore the agent harness topic hub.

Questions people ask.

Can I type codex status at a normal terminal prompt?

The documented usage check is /status inside an interactive Codex session. The separate shell command codex login status reports your authentication method.

Can I convert the remaining percentage into an exact number of tasks?

No reliable task count follows from a percentage alone. Different tasks require different amounts of work, so choose a small result and check usage again before expanding the scope.

Will starting a fresh chat restore my account allowance?

A new chat changes the conversation you are working in. It is not an account-quota reset; check the account usage information before continuing.

Does switching to API-key access use my ChatGPT allowance?

OpenAI bills API-key usage through OpenAI Platform separately from included ChatGPT plan usage. Confirm the intended account and its limits before choosing that access method.

Can another assistant continue if Codex cannot generate a handoff?

Yes, if you provide the project state, rules, files, and next action it needs. You can write the continuation record yourself, then ask the next connected assistant to read it before editing.

More in Agent harness (for developers)

All Agent harness (for developers) articles

Start with one thing.

Free for one person · No credit card · Works with Claude, ChatGPT, Cursor and more

There is nothing to set up first. Write one line and you’ve started.