# Codexのトークン使用量を確認：/status、/usage、context、API費用

> /statusは現在のセッションとcontext、/usageはアカウントのtoken activity、/statuslineは継続表示、Platform UsageはAPI費用を確認します。

- URL: https://blog.laozhang.ai/ja/posts/codex-token-usage
- Published: 2026-05-23
- Updated: 2026-09-02
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: 開発ツールとエージェント
- Tags: OpenAI Codex, Codex 使用量, Codex CLI, OpenAI API usage, AI開発ツール

---
Codex の token と context 使用量は、一つの数字だけで確認できるものではありません。まず、知りたいのが現在の CLI セッションなのか、context pressure なのか、CLI の下部に出す常時カウンターなのか、ChatGPT/Codex の plan quota や credits なのか、OpenAI API の billing なのか、1回の API response なのか、あるいはこのマシンのローカル履歴なのかを分けます。

Codex CLI の中で作業しているなら、最初に使うのは <code>/status</code> です。作業中に context stats、token counters、limits、model を見続けたいなら <code>/statusline</code> を設定します。Plan quota や credits を知りたいなら Codex または ChatGPT の usage 設定を見ます。API key の spend なら OpenAI Platform Usage、1回の request の token 数なら completed response の <code>usage</code> object を見ます。

ローカル JSONL 集計や private endpoint のスクリプトから始めないでください。ローカルログは自分のマシンの推定には役立ちますが、公式 billing record ではありません。prompt、ファイルパス、コード、顧客情報を含む可能性もあります。

- 現在の CLI セッション：<code>/status</code>
- CLI の context と token counters の常時 footer：<code>/statusline</code>
- ChatGPT/Codex の quota または credits：Codex/ChatGPT usage 設定
- API key の利用額：OpenAI Platform Usage
- 1回の API request：completed response の <code>usage</code>
- 過去のローカル活動：local Codex logs を推定としてだけ使う

## まず正しい使用量メーターを選ぶ


最初の問いは「Codex が合計で何 token 使ったか」ではありません。「この数字は何を証明するためのものか」です。CLI session、subscription quota、API organization usage、1回の response usage、local logs は別々の record です。同じ台帳のように比較すると、ほぼ必ず誤解が起きます。

| 確認したいこと | 最初に見る場所 | 証明できること | 証明できないこと |
| --- | --- | --- | --- |
| 現在の Codex CLI セッションの使用量 | CLI で <code>/status</code> | 現在セッションの設定と token 状態 | アカウント全体の履歴や API billing |
| 現在の task の context pressure を見たい | <code>/status</code>、継続表示は <code>/statusline</code> | current session の context と token-counter state | Codex web/app の conversation、task、run 別の完全履歴 |
| 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 <code>usage</code> | input、cached input、output、reasoning、total など | 月次請求全体 |
| ローカル履歴の推定 | local Codex logs | このマシンに残った活動の概算 | 公式 billing、cloud usage、他デバイス |

2026年5月24日時点では、Codex の plan limits、credits、model availability、UI labels は変わりやすい情報です。Command 名、status-line の考え方、response <code>usage</code> は比較的安定していますが、画面上のラベルは現在のアカウントで確認してください。

## アカウントの token activity は /usage

<code>/usage</code>はアカウントのtoken activityと利用可能なreset操作を開きます。<code>/usage daily</code>、<code>/usage weekly</code>、<code>/usage cumulative</code>で日・週・累積を直接確認できます。残りcontextやAPI key請求ではありません。quota、reset、creditsは[Codex Usageガイド](https://blog.laozhang.ai/ja/posts/openai-codex-usage-limits)で分けます。

## CLI では /status を最初に使う

Codex CLI の <code>/status</code> は、現在の terminal session を調べるための入口です。Model、configuration、context pressure、token usage など、今開いている作業面の状態を確認できます。ただし、account-wide history ではありません。

~~~text
/status
~~~

この出力は session 確認情報 として扱います。長い編集で context が重くなっているのか、想定した model が使われているのか、現在の 経路 が合っているのかを判断できます。ChatGPT plan の残量、API key の昨日の spend、別マシンの活動までは証明しません。

| <code>/status</code> の内容 | 正しい読み方 | 読み違え |
| --- | --- | --- |
| model や session configuration | 現在の CLI 設定 | 永続的な account policy |
| context や token usage | 今の session state | 月次 invoice |
| limit hint | 現在の Codex 画面 signal | cross-product quota proof |

実務では、まず <code>/status</code> の出力を保存し、その後で問題が CLI に残るのか、subscription usage や API billing に移るのかを判断します。

## /statusline は footer 表示であり billing ではない

![Codexの/status、/usage、/statusline、プラン、API、ローカル推定の確認先](https://blog.laozhang.ai/posts/ja/codex-token-usage/img/usage-views.webp)

<code>/statusline</code> は、作業中に状態を見続けたいときの設定です。Model、context、limits、token counters、git、session、current directory、Codex version などを TUI の下部に置けます。

大事なのは役割の違いです。<code>/status</code> は呼び出す確認です。<code>/statusline</code> は表示面です。長い作業で context pressure を早く見るには便利ですが、過去使用量の公式 dashboard にはなりません。

よい使い方：

- 長い編集で context pressure を見続ける
- project を切り替えたときに model と session を確認する
- 大きな変更前に compact や分割の必要性を見る
- <code>/status</code> を何度も打つ中断を減らす

悪い使い方：

- historical spend を証明する
- ChatGPT quota と API billing を照合する
- 別マシンの Codex activity を推定する
- OpenAI Platform Usage の代わりにする

「この terminal が今どうなっているか」なら CLI に残ります。「account や API key がどれだけ使ったか」なら公式の usage 画面 に移動します。

## Context meter は session pressure として読む

Codex の context meter を探す人は、たいてい二つの問いを混ぜています。今の CLI session が context pressure にどれだけ近いか、そして conversation、task、run ごとの完全な token usage 履歴を見られるか、です。前者は CLI で確認できます。後者は <code>/status</code> や <code>/statusline</code> だけでは証明できません。

| Context の問い | 最初の動き | 境界 |
| --- | --- | --- |
| 今の CLI session がどれだけ重いか | <code>/status</code> を実行する | current session のみ |
| 作業中に context と token counters を見たい | <code>/statusline</code> を設定する | TUI が開いている間の visibility |
| task が過去に合計何 token 使ったか | まず official usage surfaces、local logs は private estimate | billing 確認情報 ではない |
| context used と API cost を照合したい | 直接照合しない。API cost は Platform Usage と response <code>usage</code> | context pressure は invoice ではない |

この分離が、remaining context capacity と remaining account quota の混同を防ぎます。長い session は context pressure が高くても API spend の証明にはなりません。API project が費用を発生させても、ChatGPT/Codex quota 画面 が変わるとは限りません。

## 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 設定です。

この 画面 が答える質問は次のようなものです。

- Codex の included usage はどれだけ残っているか
- plan limit または credit limit に当たったのか
- credits はこの 経路 に適用されるのか
- 現在の session は ChatGPT sign-in か API key か

Plan windows や credits の詳細はここで広げすぎません。現在の quota、credits、after-limit choices は [OpenAI Codex usage limits guide](https://blog.laozhang.ai/ja/posts/openai-codex-usage-limits) が担当します。ここでは、数字を信じる前に meter を選ぶことだけに集中します。

Support に出すなら、account、workspace または plan、Codex 経路、確認した usage 画面、timestamp をセットで残します。数字だけを貼っても、どの契約の数字か判断できません。

## API billing と response usage は別の lane

![現在context、アカウントtoken activity、プランquota、API費用の違い](https://blog.laozhang.ai/posts/ja/codex-token-usage/img/context-vs-billing.webp)

API key、project、organization、service account、SDK、backend integration が関係するなら、問題は API lane です。OpenAI Platform Usage は organization または project の API usage を見ます。Completed response の <code>usage</code> は、1回の request の token accounting を見ます。

| API の問い | 画面 | 証拠 |
| --- | --- | --- |
| org/project がどれだけ使ったか | OpenAI Platform Usage | time range、project/org scope、billing period |
| 1 request が何 token か | completed response <code>usage</code> | response id、model、usage fields |
| API cost と Codex CLI が違う理由 | 経路 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 に切り替えた時点で、使用量メーターも変わります。

経路 そのものが曖昧なら [Codex API key vs subscription](https://blog.laozhang.ai/ja/posts/codex-api-key-vs-subscription) を先に見てください。経路 を決めてから 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 記録 と呼ばないでください。正しい表現は「このマシンに記録された範囲の推定」です。

## 数字が一致しない理由

Codex と OpenAI の usage numbers が合わないのは、そもそも別の問いに答えているからです。

| 不一致 | よくある理由 | 次の動き |
| --- | --- | --- |
| <code>/status</code> は高いが Platform Usage は低い | CLI session tokens は API organization spend ではない | CLI と API を分ける |
| Platform Usage は増えたが Codex quota は変わらない | work が API key 経由 | project key と billing 管理元 を確認 |
| ChatGPT/Codex quota は変わったが API logs はない | subscription Codex を使った | signed-in account と workspace を確認 |
| local logs と dashboard が合わない | logs は incomplete で local-only | account 確認情報 は official dashboard |
| per-call <code>usage</code> と invoice が完全に足し合わない | pricing、cached tokens、time range、scope、rounding | API billing lane 内で比較 |

一つの total に無理に寄せないでください。数字を分類し、同じ種類の証拠とだけ比較します。

## Support に出す前の証拠

CLI issue：

- active session の <code>/status</code> 出力
- Codex version、model、project directory
- ChatGPT sign-in か API key か
- approximate time window

Subscription quota issue：

- Codex/ChatGPT usage 画面 の screenshot
- plan または workspace type
- credits の有無
- timezone と time window
- cloud tasks、local messages、code reviews の関与

API billing issue：

- organization と project scope
- API key 管理元 または service account。key 本体は出さない
- Platform Usage time range
- representative completed response <code>usage</code>
- model names と request ids

これで support や admin は正しい meter を見られます。「Codex token usageがおかしい」では広すぎます。「/status、ChatGPT quota、Platform Usage を別 経路 で比較している」なら診断できます。

## よくある質問

### Codex CLI で token 使用量を見るには？

Active Codex CLI session で <code>/status</code> を実行します。Current session state 用であり、account-wide history ではありません。

### /statusline は何をするものですか？

<code>/statusline</code> は 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 <code>usage</code> です。

### 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 を先に使います。