Codex の token 使用量は、一つの数字だけで確認できるものではありません。まず、知りたいのが現在の CLI セッションなのか、CLI の下部に出す常時カウンターなのか、ChatGPT/Codex の plan quota や credits なのか、OpenAI API の billing なのか、1回の API response なのか、あるいはこのマシンのローカル履歴なのかを分けます。
Codex CLI の中で作業しているなら、最初に使うのは /status です。作業中にカウンターを見続けたいなら /statusline を設定します。Plan quota や credits を知りたいなら Codex または ChatGPT の usage 設定を見ます。API key の spend なら OpenAI Platform Usage、1回の request の token 数なら completed response の usage object を見ます。
ローカル JSONL 集計や private endpoint のスクリプトから始めないでください。ローカルログは自分のマシンの推定には役立ちますが、公式 billing record ではありません。prompt、ファイルパス、コード、顧客情報を含む可能性もあります。
- 現在の CLI セッション：
/status - CLI の常時 footer：
/statusline - ChatGPT/Codex の quota または credits：Codex/ChatGPT usage 設定
- API key の利用額：OpenAI Platform Usage
- 1回の API request：completed response の
usage - 過去のローカル活動：local Codex logs を推定としてだけ使う
まず正しい使用量メーターを選ぶ
最初の問いは「Codex が合計で何 token 使ったか」ではありません。「この数字は何を証明するためのものか」です。CLI session、subscription quota、API organization usage、1回の response usage、local logs は別々の record です。同じ台帳のように比較すると、ほぼ必ず誤解が起きます。
| 確認したいこと | 最初に見る場所 | 証明できること | 証明できないこと |
|---|---|---|---|
| 現在の Codex CLI セッションの使用量 | CLI で /status | 現在セッションの設定と token 状態 | アカウント全体の履歴や API billing |
| 作業中に counter を見続けたい | /statusline | TUI footer の counters と context | 他デバイスや過去履歴 |
| Plan quota や credits の残量 | Codex または ChatGPT usage 設定 | Subscription 側の quota/credits | API key の spend |
| API key の spend | OpenAI Platform Usage | Organization/project API usage | ChatGPT/Codex の plan quota |
| 1回の request の token 数 | completed response usage | input、cached input、output、reasoning、total など | 月次請求全体 |
| ローカル履歴の推定 | local Codex logs | このマシンに残った活動の概算 | 公式 billing、cloud usage、他デバイス |
2026年5月23日時点では、Codex の plan limits、credits、model availability、UI labels は変わりやすい情報です。Command 名や response usage の考え方は比較的安定していますが、画面上のラベルは現在のアカウントで確認してください。
CLI では /status を最初に使う
Codex CLI の /status は、現在の terminal session を調べるための入口です。Model、configuration、context pressure、token usage など、今開いている作業面の状態を確認できます。ただし、account-wide history ではありません。
text/status
この出力は session evidence として扱います。長い編集で context が重くなっているのか、想定した model が使われているのか、現在の route が合っているのかを判断できます。ChatGPT plan の残量、API key の昨日の spend、別マシンの活動までは証明しません。
/status の内容 | 正しい読み方 | 読み違え |
|---|---|---|
| model や session configuration | 現在の CLI 設定 | 永続的な account policy |
| context や token usage | 今の session state | 月次 invoice |
| limit hint | 現在の Codex surface signal | cross-product quota proof |
実務では、まず /status の出力を保存し、その後で問題が CLI に残るのか、subscription usage や API billing に移るのかを判断します。
/statusline は footer 表示であり billing ではない
/statusline は、作業中に状態を見続けたいときの設定です。Model、context、limits、token counters、git、session、current directory、Codex version などを TUI の下部に置けます。
大事なのは役割の違いです。/status は呼び出す確認です。/statusline は表示面です。長い作業で context pressure を早く見るには便利ですが、過去使用量の公式 dashboard にはなりません。
よい使い方：
- 長い編集で context pressure を見続ける
- project を切り替えたときに model と session を確認する
- 大きな変更前に compact や分割の必要性を見る
/statusを何度も打つ中断を減らす
悪い使い方：
- historical spend を証明する
- ChatGPT quota と API billing を照合する
- 別マシンの Codex activity を推定する
- OpenAI Platform Usage の代わりにする
「この terminal が今どうなっているか」なら CLI に残ります。「account や API key がどれだけ使ったか」なら公式の usage surface に移動します。
ChatGPT/Codex の quota と credits
Subscription 側の数字は API と混同しやすい部分です。Codex plan quota、credits、CLI session、API organization bill は同じ数字ではありません。ChatGPT sign-in、Codex app、cloud task、workspace Codex を使っているなら、最初の確認先は Codex または ChatGPT の usage 設定です。
この surface が答える質問は次のようなものです。
- Codex の included usage はどれだけ残っているか
- plan limit または credit limit に当たったのか
- credits はこの route に適用されるのか
- 現在の session は ChatGPT sign-in か API key か
Plan windows や credits の詳細はここで広げすぎません。現在の quota、credits、after-limit choices は OpenAI Codex usage limits guide が担当します。ここでは、数字を信じる前に meter を選ぶことだけに集中します。
Support に出すなら、account、workspace または plan、Codex route、確認した usage surface、timestamp をセットで残します。数字だけを貼っても、どの契約の数字か判断できません。
API billing と response usage は別の lane
API key、project、organization、service account、SDK、backend integration が関係するなら、問題は API lane です。OpenAI Platform Usage は organization または project の API usage を見ます。Completed response の usage は、1回の request の token accounting を見ます。
| API の問い | Surface | 証拠 |
|---|---|---|
| org/project がどれだけ使ったか | OpenAI Platform Usage | time range、project/org scope、billing period |
| 1 request が何 token か | completed response usage | response id、model、usage fields |
| API cost と Codex CLI が違う理由 | route comparison | API key billing と ChatGPT/Codex plan は別 |
最小のログ例は次のような形です。
json{ "response_id": "resp_...", "model": "gpt-...", "usage": { "input_tokens": 1200, "cached_input_tokens": 800, "output_tokens": 350, "total_tokens": 1550 } }
この情報は request-level accounting、debugging、cost attribution に有効です。ただし ChatGPT subscription の Codex quota 残量は示しません。ChatGPT sign-in から API key に切り替えた時点で、使用量メーターも変わります。
Route そのものが曖昧なら Codex API key vs subscription を先に見てください。Route を決めてから usage を比較します。
ローカル履歴は推定であって公式記録ではない
Local Codex logs は、自分のマシンで何が起きたかを知るには役立ちます。長かった session、昨日の大きな task、特定の directory の活動などです。しかし billing や quota dispute の証拠としては弱いです。
ローカルファイルを読む前に、次の境界を守ります。
| ローカルの問い | 安全な読み方 | リスク |
|---|---|---|
| このマシンの sessions | approximate local activity | 他デバイスと cloud surfaces が欠ける |
| session file の token-like fields | personal estimate | field meaning は version で変わる |
| prompt や transcript | debug context | code、path、secret、customer data を含む可能性 |
| private backend endpoints | normal path にしない | unsupported、fragile、account risk |
Parser を使うなら read-only、private、対象範囲限定にします。Full transcript を外部に貼らないでください。Local JSONL total を official ledger と呼ばないでください。正しい表現は「このマシンに記録された範囲の推定」です。
数字が一致しない理由
Codex と OpenAI の usage numbers が合わないのは、そもそも別の問いに答えているからです。
| 不一致 | よくある理由 | 次の動き |
|---|---|---|
/status は高いが Platform Usage は低い | CLI session tokens は API organization spend ではない | CLI と API を分ける |
| Platform Usage は増えたが Codex quota は変わらない | work が API key 経由 | project key と billing owner を確認 |
| ChatGPT/Codex quota は変わったが API logs はない | subscription Codex を使った | signed-in account と workspace を確認 |
| local logs と dashboard が合わない | logs は incomplete で local-only | account evidence は official dashboard |
per-call usage と invoice が完全に足し合わない | pricing、cached tokens、time range、scope、rounding | API billing lane 内で比較 |
一つの total に無理に寄せないでください。数字を分類し、同じ種類の証拠とだけ比較します。
Support に出す前の証拠
CLI issue：
- active session の
/status出力 - Codex version、model、project directory
- ChatGPT sign-in か API key か
- approximate time window
Subscription quota issue：
- Codex/ChatGPT usage surface の screenshot
- plan または workspace type
- credits の有無
- timezone と time window
- cloud tasks、local messages、code reviews の関与
API billing issue：
- organization と project scope
- API key owner または service account。key 本体は出さない
- Platform Usage time range
- representative completed response
usage - model names と request ids
これで support や admin は正しい meter を見られます。「Codex token usageがおかしい」では広すぎます。「/status、ChatGPT quota、Platform Usage を別 route で比較している」なら診断できます。
よくある質問
Codex CLI で token 使用量を見るには？
Active Codex CLI session で /status を実行します。Current session state 用であり、account-wide history ではありません。
/statusline は何をするものですか？
/statusline は Codex TUI の footer を設定します。Counters と context を表示できますが、billing dashboard ではありません。
Codex plan quota や credits はどこで確認しますか？
Signed-in account の Codex または ChatGPT usage 設定を見ます。UI labels、credits、plan rules は現在のアカウントで確認してください。
OpenAI API token usage はどこで確認しますか？
Organization または project usage は OpenAI Platform Usage。1 request の token 数は completed response usage です。
Codex CLI usage と Platform Usage が合わない理由は？
別のメーターだからです。CLI usage は active session、Platform Usage は API organization/project を表します。
Local Codex logs で過去 token を確認できますか？
このマシンの local estimate には使えます。Official account-wide usage ではなく、sensitive context を含む可能性があります。
Private endpoint scripts を使うべきですか？
Normal path にはしないでください。Supported CLI commands、account usage settings、Platform Usage、completed response usage を先に使います。