Cmd. /usage
View Codex account token usage and apply available rate-limit resets.
Key takeaways
- View Codex account token usage and apply available rate-limit resets.
- Check the input surface and availability before using the examples below.
Purpose
View Codex account token usage and apply available rate-limit resets.
/usageAvailability
| Field | Value |
|---|---|
| Input surface | Running CLI prompt |
| Kind | Built-in |
| Status | Current reference |
| Aliases | — |
| Documented minimum | Not specified |
| Reviewed against | 2026-09-22 · Codex CLI 0.155.1 |
The installed command menu and account or organization settings determine availability.
Examples
/usageDirect views:
/usage daily
/usage weekly
/usage cumulativeWhen to use it
- Run
/usage weeklybefore a long/goaltask. - Check
/usage dailybefore experimental multi-agent delegation. - Decide whether to redeem an earned reset only after prioritizing the work that needs it.
Choosing related commands
| Command | Difference | Choose It When |
|---|---|---|
/usage | Shows account token activity and reset actions | You need account-level usage information |
/status | Shows current session model, policy, and context | You need session state |
/model | Changes model and reasoning | You need to adjust cost or latency after checking usage |
Effects and persistence
Displays usage, cost, or activity information; viewing it does not authorize a purchase or additional usage.
/usage is an official slash command for viewing account token usage or applying an available
rate-limit reset.
Changes
/usageexposes token activity and rate-limit reset actions.daily,weekly, andcumulativeviews are supported.- Together with rollout token budgets, it becomes the primary TUI entry point for usage checks.
Cautions
/usageis account-level; use/statusfor current-thread context and policy.- Do not redeem earned resets automatically; tie them to explicit task priority.
- Sessions without Codex service account auth show a sign-in requirement first.
Official sources
Complete command list · Verification scope · History for this command