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, and pi-agent, 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, and pi-agent) 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-07-07. Corrections welcome on GitHub.