Codex analytics for a team, by repository
What OpenAI shows an admin about Codex usage, what the usage dashboard shows one person, and how to see Codex and Claude Code in one table by repository.
Codex analytics for a team lives in OpenAI's Admin Console, on ChatGPT Enterprise: active users, credits and tokens, threads and turns, a user leaderboard and model usage, 120 days back, with an API behind it. A Business workspace gets Workspace analytics, a member table and a link into Codex analytics; one person gets /status and the usage dashboard. None of them has a row per repository, and none shows Codex beside Claude Code. Caprock does both, from the session files on each machine.
Codex analytics for ChatGPT Enterprise: what an admin sees
OpenAI's Codex pricing page lists, under "Admin, security, and analytics", the analytics dashboard, the Analytics API, and the Compliance API with audit logs for Enterprise and Education only. Read on 30 October 2026, what each holds:
- The dashboard. The Global Admin Console added Codex analytics on 21 May 2026 "with active users, credits and tokens, threads and turns, user leaderboards, plugin usage, accepted lines of code, model usage". Since 18 June 2026 it exports "credits used by Codex and ChatGPT, leaderboards for users and agents, and Codex and ChatGPT usage broken down by feature"; since 16 July 2026 it keeps 120 days; since 23 July 2026 leaderboards have a Groups tab with "group-level breakdowns by product, metered item, and model", and "estimated dollar values may appear next to credits in Analytics, Billing, usage-limit editors, the Cost API, and the Codex analytics API. Estimates use the selected workspace’s overage rate and are for planning." The console article gives Codex usage analytics a window of "Up to 120 days", refreshed "Approximately every 1 to 6 hours", and adds: "Codex product access does not automatically include analytics."
- Usage Insights groups the same activity into use cases and tasks, with messages, share of credits and active users per category, model, reasoning and speed breakdowns, and a Code review tab: PRs reviewed, issues found, reactions. OpenAI's own caveats: "A message count doesn’t tell you how much work the team finished." and "A reviewed pull request isn’t necessarily merged or deployed."
- The Codex analytics API. "Codex Enterprise Analytics is available to Enterprise workspaces with Codex enabled." An owner creates a workspace-scoped Admin key under Credentials > Admin keys with
codex.enterprise.analytics.read; the reference lists four calls: Get Codex Turn Insights, Get daily Codex usage, Get daily Codex code review metrics, Get daily Codex code review user responses. A second endpoint, underenterprise.analytics.usage.read, "reports daily ChatGPT, Codex, and Work usage." - The Compliance API is for records, not reporting. "The Compliance Platform is available to ChatGPT Enterprise and Edu workspaces." Codex "usage, including local clients such as the CLI and IDE extension as well as web or cloud-delegated usage, is available in the Compliance API." OpenAI's docs say of it: "It’s not a productivity dashboard. Don’t use it to infer code quality or individual performance."
- Spend controls. "Usage limits control each person's usage through workspace defaults, group defaults, and individual overrides. The amounts are in credits or USD, depending on your billing model."
Every dimension on that list is a person, a group, a model or a feature. The help centre's export schema says the same: the Workspace analytics usage exports are a User report, a GPT report and a Project report, the project being a ChatGPT project; the fourth export is an Impact survey report.
Codex analytics on ChatGPT Business
The Business release notes of 16 April 2026 describe Workspace analytics for Business: "View headline metrics such as active users, total messages sent, and total credits spent across the selected time range." A member table: "See usage by workspace member, including seat type, credits spent, and messages sent." And a link out: "Jump directly to Codex analytics for lightweight insights into credits usage and developer activity." The Codex pricing page, read the same day, marks the analytics dashboard and both APIs for Enterprise and Education only, and gives Business, in that section, "SAML SSO, MFA, and workspace user management", managed configuration and the no-training default, with no analytics row. Read together: Business sees its members and their credits; the API, the 120-day console history and the Compliance API are Enterprise.
Spend controls on Business are "monthly credit usage limits by seat type and per-user overrides", and "By default, all seats and users have no limits specified."
Codex Business and Enterprise pricing, for seats
| Business Standard | Business Premium | Enterprise | |
|---|---|---|---|
| A user a month | $25, or $20 billed annually | $125, or $100 billed annually | Contact sales |
| Minimum | two seats in total, of either kind | two seats in total, of either kind | not published |
| Codex | yes | yes, with higher usage limits | yes |
| Analytics | Workspace analytics | Workspace analytics | Codex analytics, the Analytics API, the Compliance API |
| Spend controls | credit limits by seat type and per user | credit limits by seat type and per user | per user, group and workspace, in credits or USD |
What one person sees
/status in a Codex CLI session, and the usage dashboard at chatgpt.com/codex/settings/usage, show one account's five-hour and weekly windows. On an eligible Enterprise workspace, ChatGPT Desktop's Settings > Usage & billing adds a monthly credit meter, credit and token history grouped by Surface, Model, Reasoning or Speed, and, per chat, "Lifetime credits used by the Work or Codex chat" and "An estimated cost, when available". The plans, the dashboard and what a session costs: Codex usage and cost. The windows by plan: Codex usage limits.
What none of them shows
- By repository. No page read on 30 October 2026 names a repository as a dimension of Codex usage or spend. The console knows users, groups, models and features; the exports know users, GPTs and ChatGPT projects.
- By pull request. The pull requests in Usage Insights are the ones Codex reviewed, counted, with no cost beside them and no link to the sessions that wrote them.
- Beside Claude Code. OpenAI's analytics cover OpenAI's agent. A team running Codex and Claude Code has two consoles and no row that adds them up.
- A session on an API key. Of the workspace's spend controls, OpenAI's docs say: "They don’t cover all Codex usage or govern OpenAI API Platform billing." A developer who switched the CLI to a key is on the Platform bill, not in the workspace.
Codex and Claude Code in one table
Caprock records every session on a machine, whichever agent ran it and wherever it was started, and prices each turn at the vendor's list rate. Thirty days on my Mac, read from its database on 28 October 2026:
| Codex | Claude Code | |
|---|---|---|
| Sessions | 220 | 2,143 |
| Cost at list | $329 | $7,080 |
| A session | $1.50 | $3.30 |
The same 2,363 sessions, by who started them:
- 626
- sessions started from Caprock, $6,619
- 1,737
- started in a terminal or elsewhere, $790
A cockpit lists the sessions it started; the 1,737 others would not be on it. A recorder has both. In Caprock each session sits in its repository's row, the repository's cost is divided by its merged pull requests, and Codex and Claude Code add up in the same row.
How Caprock reads Codex
Codex writes one append-only JSONL transcript per session under $CODEX_HOME/sessions/ (~/.codex by default) and moves archived threads to archived_sessions/. Caprock tails those files, compressed .jsonl.zst included, from the CLI and the desktop app alike: no hook, nothing written into Codex's config, no process signalled, nothing leaving the machine. From each file:
session_metagives the session id, the working directory and the client. The directory is how a session lands in a repository's row.token_countgives input, cached input, output and reasoning tokens per turn, and the plan-limit windows. Deltas come from the cumulative field, which reproduces Codex's own total exactly; cached tokens are taken out of the input count so nothing is priced twice.- The price comes from Caprock's dated table of OpenAI's list rates. Codex itself never writes a cost.
Where the figure stops:
- gpt-6 cache writes. OpenAI's API price for the gpt-6 family bills cache writes above the input rate (1.25× input for a 30-minute cache, 2.5× for 12 hours, read 30 October 2026), but Codex reports no cache-write tokens, so there is nothing to apply the rate to: for those turns the list-price figure can be low by up to a quarter of that unreported share at the rate Caprock's table applies. On a ChatGPT plan the point does not arise: "Codex credit billing has no separate cache-write charge. API-key usage follows API pricing."
- A total with no breakdown is priced as input, an upper bound, and the turn is marked so.
- Above 272K input tokens the API's long-context surcharge is not modelled; no observed turn reached it.
- Codex's background reviewer is counted in tokens on its own line with no price, because OpenAI publishes none.
Across the team
Caprock for Teams is the ledger across agents and machines: every Codex and Claude Code session on every developer's machine, priced the same way, summed per repository, pull request and release on a server you run, with no field for a prompt, a reply or a command's output. It sits beside OpenAI's console, which keeps the credits and the people, and beside Anthropic's. Buying Caprock is one flat price for the team.
Questions people ask
- Does ChatGPT Business have Codex analytics?
- Workspace analytics, since 16 April 2026: active users, messages and credits for the workspace, a member table with seat type, credits spent and messages sent, and a link to Codex analytics. The Codex pricing page lists the analytics dashboard, the Analytics API and the Compliance API for Enterprise and Education only. Read 30 October 2026.
- Is there a Codex usage API?
- For Enterprise workspaces with Codex enabled. An Admin key scoped codex.enterprise.analytics.read, created under Credentials > Admin keys, reads the Codex Enterprise Analytics endpoints: Get Codex Turn Insights, Get daily Codex usage, Get daily Codex code review metrics, Get daily Codex code review user responses. A unified daily usage endpoint reports ChatGPT, Codex and Work usage under a separate scope.
- Can an admin see Codex usage by repository?
- Not on any OpenAI page read on 30 October 2026: the console reports by user, group, model and feature, and the exports by user, GPT and ChatGPT project. Caprock reads the working directory from each Codex session file on the machine and sums cost per repository and per merged pull request, beside Claude Code.
- How much does Codex cost for a business?
- A Business Standard seat is $25 a user a month, or $20 billed annually; a Premium seat, with higher usage limits, $125 or $100; a workspace needs 2 seats. Enterprise is priced by sales. Usage past the included limits draws on workspace credits. Read 30 October 2026.
- Does the Compliance API show Codex usage?
- On Enterprise and Edu workspaces it carries Codex activity from the CLI, the IDE extension, the web and cloud tasks as audit records. OpenAI's docs say it is not a productivity dashboard and not for inferring code quality or individual performance; adoption reporting is the analytics dashboard and the Analytics API.
- How do I see Codex and Claude Code usage together?
- Caprock, a free desktop app, records every Codex and Claude Code session on the machine from their own transcript files and prices each at list rates, per repository. On one Mac in thirty days: Codex 220 sessions for $329, Claude Code 2,143 for $7,080. Caprock for Teams sums the same across machines.
Sources
- Codex docs — Pricing (the Business and Enterprise cards, the "Admin, security, and analytics" rows, the cache-write line), read 30 October 2026
- OpenAI Help — ChatGPT Business overview (Standard and Premium seat prices, two seats minimum), read 30 October 2026
- OpenAI Help — Managing credits and spend controls in ChatGPT Business, read 30 October 2026
- OpenAI Help — ChatGPT Business release notes (Workspace analytics for Business, 16 April 2026), read 30 October 2026
- OpenAI Help — ChatGPT Enterprise and Edu release notes (Codex analytics in the console, 21 May 2026, and the 18 June 2026, 16 July 2026, 23 July 2026 and 23 October 2026 entries), read 30 October 2026
- OpenAI Help — Global Admin Console (the Analytics table: windows and refresh), read 30 October 2026
- OpenAI Help — Using Codex with your ChatGPT plan (Codex Enterprise Analytics, the Compliance API, the Admin key), read 30 October 2026
- OpenAI Help — Manage usage limits and overages in ChatGPT Enterprise and Edu, read 30 October 2026
- OpenAI Help — Reviewing Work and Codex usage in ChatGPT Desktop (what one member sees), read 30 October 2026
- OpenAI Help — Workspace analytics for ChatGPT Enterprise and Edu (the User, GPT and Project exports), read 30 October 2026
- Codex docs — Workspace analytics (the four reporting surfaces), read 30 October 2026
- Codex docs — Usage Insights (use cases, tasks, Code review), read 30 October 2026
- Codex docs — ChatGPT usage limits and spend controls, read 30 October 2026
- Codex docs — Analytics API (the unified daily endpoint and its scope), read 30 October 2026
- Codex docs — Compliance API and audit events, read 30 October 2026
- OpenAI Help — OpenAI Compliance Platform for Enterprise and Edu customers, read 30 October 2026
- OpenAI Help — Managing Admin keys (the codex.enterprise.analytics.read permission), read 30 October 2026
- ChatGPT Admin API reference — Codex Enterprise Analytics (the four endpoints), read 30 October 2026
- Caprock — Codex support: the rollout files, the token fields, the three measured pitfalls and what is deliberately unpriced
- Caprock — risk register, RISK-07: the gpt-6 cache-write rate has no reported tokens to apply to
- Caprock source — internal/codex/codex.go, the reader
- Caprock's dated price table, OpenAI rows read from developers.openai.com
- Caprock's measured figures: sessions and cost by agent and by who started them, 29 September to 28 October 2026, one developer's Mac at list price; the charts on /teams/ read the same file (src/content/charts.ts)
Try it
The record of every coding agent you run, the sessions it did not start included. Free, open source; nothing leaves your machine.
Notarized by Apple. One file for Apple silicon and Intel, macOS 13 or later.
Or run it yourself:
Paste in Terminal: it installs Caprock and opens it.Or with Homebrew: brew install --cask dspv/tap/caprock-app