OpenAI Codex の使用量とコストを追跡する（Codex CLI）
OpenAI Codex CLI は、消費したトークンをすべてあなたのマシン上に記録します。本ガイドでは、そのログの場所、記録される内容、数字が大きく見える理由、そして使用量とコストを明確に把握する 3 つの方法を説明します——すべてオフラインで、コードには一切触れません。
最終更新 2026 年 7 月 15 日
手短に言うと：Codex CLI はセッションごとのログを ~/.codex/sessions/**/rollout-*.jsonl に保存します。各ターンで使った入力・出力・キャッシュ・推論トークン数、モデル、タイムスタンプを記録します——ソースコードは決して記録しません。手動でも、スクリプトでも、ビジュアルなデスクトップダッシュボードでも読めます。
どちらの「Codex」か
Codex と呼ばれるものは 2 つあり、追跡対象を明確にするうえでこの区別は重要です。元の Codex は 2021 年の OpenAI の API モデルで、現在は非推奨です。今日の Codex は Codex CLI——OpenAI のターミナル型コーディングエージェントで、現行の GPT モデルで動作します。本ガイドが扱うのはこの CLI です。ターミナルにインストールして実行するツールで、セッションごとに使用ログを書き出します。コーディングエージェントの支出を見張るなら、そのログが唯一の正確な情報源です。
Codex CLI が使用ログを保存する場所
Codex はセッションごとに自動でログファイルを書き出します。有効化の操作は不要です：
| プラットフォーム | 場所 |
|---|---|
| macOS / Linux | ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl |
| Windows | %USERPROFILE%\.codex\sessions\YYYY\MM\DD\ |
セッションは日付フォルダにまとめられ、1 セッションにつき rollout-*.jsonl が 1 つです。比較として、Claude Code は同種のログを ~/.claude/projects/**/*.jsonl に保存します——だからこそ 1 つのツールで両方を合算できます。
ログが記録するもの——しないもの
各行が 1 つのイベントです。使用量にとって重要なのは、そのターンの累計トークン数を持つ定期的な token-count イベントです。そこから次を読み取れます：
- ✦トークン数（入力・出力・キャッシュ入力・推論の 4 分類）
- ✦そのターンに応答した GPT モデル
- ✦タイムスタンプとセッション id
- ✦ただしソースコードファイルは含まず、プロンプトの意味も読み取りません
生ファイルにはメッセージ本文が含まれます。完全なセッション記録だからです。しかし支出を合算するには、トークンとモデルのフィールドだけで十分で、優れたトラッカーはそこだけを読みます。たとえば Token Forest は数値・モデル名・タイムスタンプだけを取り、プロンプトやコードを自身のデータにコピーすることも、アップロードすることもありません。
Codex のトークン数が大きく見える理由
2 つの分類が、請求額を同じ割合で押し上げずに生の数字だけを膨らませます。キャッシュ入力トークンはセッション内で再読される文脈で、完全な入力料金よりはるかに安く課金されます。推論トークンはモデルの内部思考です。どちらも見える入力・出力を大きく上回りうるため、生の合計だけを見ると驚きがちです。
支出は生のトークン合計ではなく、推定コストで判断してください。数十億という数字は正常であり、請求が同じ桁だという意味ではありません——その大半はごくわずかな価格で再読されるキャッシュ文脈です。
Codex のコストを把握する 3 つの方法
1. ログを手動で読む
- ~/.codex/sessions/ を開き、日付フォルダを選び、rollout-*.jsonl ファイルを選びます。
- テキストエディタで開きます。各行が 1 つの JSON イベントです。累計を持つ token-count イベントを探します。
- トークン数にモデルの単価を掛けてコストを推定します。手間はかかりますが、追加ツールなしでできます。
2. コマンドラインツールを使う
CLI はログを解析して合計を表示できます。高速でスクリプト化もできますが、ターミナルの中に留まり、常時表示ではなくスナップショットを示し、価格表を内蔵していない限りトークンから価格への換算は自分で行う必要があります。
3. オフラインのデスクトップダッシュボードを使う
Token Forest は同じ Codex ログ（および Claude Code のログ）を読み、常時表示の全体像に変えます：時間ごとの成長、モデル別の使用量、複数週のヒートマップ、そして内蔵の更新可能な価格表によるオフラインのコスト推定です。Windows と macOS で動作し、完全にオフラインで、上記のトークン数とメタデータだけを読みます——コードは決して読みません。
Codex と Claude Code を並べて追跡する
両方のエージェントを使うなら、別々の集計は避けたいはずです。Token Forest は Codex と Claude Code を 1 つの合計にまとめ、リアルタイムのトークンバブルをソース別に色分けします——Claude Code はオレンジ、Codex は青紫——支出の行き先が一目でわかります。特定の CLI のフロントエンドではなく独立したツールであり、それらとコードを共有しません。
よくある質問
Codex CLI は以前の OpenAI Codex モデルと同じですか？
いいえ。2021 年の Codex API モデルは非推奨です。今日の Codex は Codex CLI で、現行の GPT モデルで動く OpenAI のターミナル型コーディングエージェントです。本ガイドと Token Forest はこの CLI の使用量を扱います。
Codex CLI は使用ログをどこに保存しますか？
~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl（Windows では %USERPROFILE%\.codex\sessions\ 以下）です。1 セッションにつき 1 ファイルで、日付フォルダにまとめられます。
Codex CLI はいくらかかりますか？
モデルと、各ターンで消費するトークン数によります。ログにトークン数が記録されているので、モデルの単価を掛ければ推定できます。キャッシュと推論のトークンは生の数字を実際の請求よりはるかに大きくするため、生の合計ではなく推定で判断してください。
使用量トラッカーは Codex を追跡するときにコードを読みますか？
読む必要はありません。トークン合計はメタデータフィールドにあるので、トラッカーはそこだけで済みます。Token Forest は数値・モデル名・タイムスタンプだけを読み、プロンプトやコードをコピーすることも、アップロードすることもありません。
Codex と Claude Code を 1 か所で追跡できますか？
はい。Token Forest は両方のログを読み、1 つの合計とダッシュボードにまとめ、リアルタイムのトークンバブルをソース別に色分けするので両者を見分けられます。
Codex の使用量が木に育つのを見よう
Token Forest は、あなたが消費した Codex と Claude Code のトークンを生きたピクセルの木に変え、その裏にオフラインのコストダッシュボードを備えます。無料、ローカルファースト、Windows と macOS 対応。