How to track Codex usage
OpenAI's Codex CLI gets less usage-tooling attention than Claude Code, but the same layers exist: a built-in status command, local session logs, and open-source tools that read them. (Details as of July 2026.)
Built-in: /status
Inside Codex, /status shows your account, model, and current rate-limit state — the equivalent of Claude Code's /usage. If you use Codex through a ChatGPT plan, limits are metered in rolling windows plus a weekly allowance, and heavy use can be topped up with pay-as-you-go credits.
Local session logs
Codex writes JSONL session files under ~/.codex/sessions/, including per-turn token counts and the model used. As with Claude Code's ~/.claude/projects/, these local files are what usage tools parse — nothing needs a network call.
Reports across time: ccusage
ccusage supports Codex alongside Claude Code and other coding CLIs — daily/monthly/per-session tables with costs estimated at public API pricing. Local-only, no uploads.
Codex and Claude Code on one board
Many developers now run both agents and want one picture of usage — or want to compare with friends who use a different agent. ccclub (our project) reads local logs from Codex, Claude Code, OpenCode, Amp, Grok, and Pi, and puts a group on a single leaderboard with each member's agent mix. Set up with npx ccclub init; only numeric summaries are uploaded (no prompts, code, or file paths). If you only want your own numbers, stick with ccusage — see the comparison.
A note on Codex "cost"
Like Claude subscriptions, ChatGPT plans don't bill per token — dollar figures from usage tools are API-equivalent estimates, useful for comparing across time or against a plan price, not an invoice.
FAQ
How do I check my Codex usage?
Run /status inside the Codex CLI for your current rate-limit state. For historical reports, tools like ccusage parse the local session logs in ~/.codex/sessions/.
Where does Codex CLI store its logs?
JSONL session files under ~/.codex/sessions/, with per-turn token counts and model names. Usage tools read these local files directly.
Can I track Codex and Claude Code usage together?
Yes. ccusage reports both locally, and ccclub shows both (plus OpenCode, Amp, Grok, and Pi) on one shared leaderboard, with each person's agent mix.
Does Codex have usage limits on ChatGPT plans?
Yes — usage is metered in rolling windows with a weekly allowance that varies by plan, and can be extended with pay-as-you-go credits. /status shows where you stand.
Last updated 2026-08-04. Corrections welcome on GitHub.