token-meter

Token Meter

Claude Code、Codex、Cursor のトークン使用量とコストをローカルで追跡できます。アカウントもクラウドも不要です。

Claude Code と Codex のトークン使用量をひとつのローカルダッシュボードで確認できます。 無料で、MCP に対応し、コア部分は MIT ライセンスです。

npm: @whdrnr2583/token-meter · GitHub: whdrnr2583-cmd/token-meter · サイト: token-meter.dev

Token Meter は、Claude Code と Codex がすでにディスクに書き込んでいる JSONL ファイルを解析し、プロジェクト別、モデル別、MCP ツール別、時間別のコストを確認できる、本格的なダッシュボードを作成します。データがマシンの外に出ることはありません。

最初の監査を実行する

npx -y @whdrnr2583/token-meter audit

取り込んだ Claude Code と Codex の履歴をスキャンし、コストと信頼度の順に、高コストのセッション、過大なツール応答、遅いツール、繰り返しの呼び出し、キャッシュの無駄を確認できます。すべてローカルの SQLite データベースに対して実行されます。Token Meter のほかの機能と同様、ローカル優先で、クラウドを使わずに処理します。機械可読な出力を得るには --json を追加してください。フラグ一覧と JSON スキーマについては、docs/audit.md をご覧ください。

こんなときにお使いください

次のような場合に Token Meter をご利用ください。

• Claude Code または Codex のセッションで、トークンと費用がどれだけ発生しているかをプロジェクト別、モデル別、MCP ツール別に把握したい
• 定額料金プラン（Claude Max など）を利用していて、相当する API コストを確認したい
• 最も多くのトークンを消費している MCP サーバーやツール、または最もコストの高い時間帯を見つけたい
• 最近のセッションを再開したく、claude --resume / codex resume コマンドをすぐに使えるようにしておきたい
• アカウント登録やアップロードなしで、以上のすべてをオフラインで利用したい

Anthropic または OpenAI の請求書と照合して検証済みの、請求に使える精度の数値が必要な場合には適していません。Token Meter はローカルの JSONL ファイルのみから推定値を算出します。

MCP ツール

Token Meter を MCP サーバーとして接続すると（install-mcp all）、AI アシスタントで次の 4 つのツールが利用できるようになります。

ツール	返される内容
usage_summary	日別およびモデル別のトークン数、米ドル相当のコスト、呼び出し回数を示す日次テーブル
recent_sessions	最新のセッションと、そのまま貼り付けて使える claude --resume / codex resume コマンド
session_tools	セッション内のツール別内訳：呼び出し回数、合計トークン数、平均レイテンシ、応答サイズ
refresh_data	ローカルの JSONL ログを再スキャンして新しいアクティビティを取り込み、最新の概要を返します

4 つのツールはすべて読み取り専用です。データがマシンの外に出ることはありません。

プロンプトの例

MCP サーバーをインストールした後、以下を Claude Code または Cursor にコピーして貼り付けてください。

Show me my token usage and cost for the last 7 days.

List my recent sessions so I can pick one to resume.

Show the tool breakdown for my most recent session — which tool used the most tokens?

Refresh token-meter data, then tell me which model cost the most this week.

Which hour of the day am I spending the most tokens on?

クイックスタート

npx @whdrnr2583/token-meter ingest        # scan ~/.claude/projects + ~/.codex/sessions
npx @whdrnr2583/token-meter stats 30      # CLI summary for last 30 days
npx @whdrnr2583/token-meter serve         # http://localhost:8765 dashboard
npx @whdrnr2583/token-meter mcp           # run as an MCP server for Claude Code / Cursor

npm では既存の類似名と衝突するため、このパッケージは npm スコープ（@whdrnr2583/）で公開されています。インストール後の CLI バイナリ名は引き続き token-meter です。

AI ツール（MCP）に Token Meter を接続する

1 つのコマンドで、お使いのマシン上の対応クライアントすべてに Token Meter を登録できます。

npx -y @whdrnr2583/token-meter install-mcp all

Claude Code、Cursor、Claude Desktop に対応しています。何度実行しても安全で、既存の設定をバックアップし、ほかの MCP サーバーも保持します。単一クライアント向けのコマンドは次のとおりです。 install-mcp claude-code | cursor | claude-desktop。実行内容を事前に確認するには --dry-run を追加してください。

LLM に設定してもらうこともできます。 Claude Code／Cursor／Claude Desktop を開いて、次のように依頼してください。 「https://raw.githubusercontent.com/whdrnr2583-cmd/token-meter/main/docs/mcp-server.md を読み、token-meter を MCP サーバーとして設定してください。」

手動で設定する場合のコマンド（インストーラーを使わない場合）：

クライアント	コマンド／設定
Claude Code	claude mcp add token-meter -- npx -y @whdrnr2583/token-meter mcp を実行し、claude mcp list で確認します
Cursor	~/.cursor/mcp.json（Windows：%USERPROFILE%\.cursor\mcp.json）を編集します。docs/mcp-server.md を参照してください
Claude Desktop	claude_desktop_config.json を編集します。docs/mcp-server.md を参照してください
ChatGPT	現時点では Stdio のみ対応しています。HTTP ラッパーの設定方法は docs/mcp-server.md を参照してください
その他（Continue、Zed、カスタム）	Stdio 経由で npx -y @whdrnr2583/token-meter mcp を実行します

次に、「token-meter を使って最近のセッションを表示して」、または 「token-meter usage_summary を使って今週の使用状況を表示して」 と依頼してください。

Claude Code のショートカット： npx -y @whdrnr2583/token-meter install-command claude-code を一度実行して、/token-meter スラッシュコマンドを登録します。セッションを開き直した後に /token-meter と入力すると、自然言語を使わずに一度だけ概要を表示できます。

セットアップ、確認、トラブルシューティングの詳細は docs/mcp-server.md を参照してください。

保存先：~/.tokenpulse/usage.db（SQLite）。最初からやり直すには、このフォルダーを削除してください。 今後のリリースでは、自動移行によりフォルダー名が ~/.tokenmeter/ に変更されます。それまでは、v0.1 のディレクトリ名は変更されません。

表示内容

• 日別、モデル別、プロジェクト別の米ドル換算コスト。 Max プランをご利用の場合、API ならいくらかかったかを把握するのに役立ちます。
• MCP とツールの内訳： トークンを多く消費している MCP サーバー、各ツールの平均処理時間、呼び出しごとのレスポンスサイズを確認できます。
• 出力トークンの時間別分布。
• Claude Code と Codex を並べて、1 つの画面で確認できます。

ドル表示について

コストは、Claude Code と Codex が JSONL ファイルに記録するトークン数に、モデルごとの公表されている 100 万トークンあたりの料金を掛けて、ローカルで算出した推定値です。Anthropic／OpenAI の実際の請求額と照合したものではないため、いくつかの理由から差が生じる場合があります。

• ベンダーは料金を変更します。src/pricing.ts の表は、ある時点のスナップショットです
• サブスクリプションプラン（Pro／Max）は定額料金です。画面上のドル表示は API ならかかったはずの金額であり、実際に支払う金額ではありません
• 一部のトークンカテゴリ（サーバー側のツール使用、キャッシュ書き込みの各種）は概算です

この数値は、無駄を見つけるための相対的な指標として扱い、請求額と完全に一致する会計データとしては扱わないでください。Token Meter には、計算を再現できることを確認する回帰テストと、不変条件を確認する監査スクリプトが含まれています。いずれも、料金をベンダーの請求書と照合するものではありません。

ローカルファーストである理由

• JSONL にはソースコード、プロンプト、ツールの実行結果が含まれます。Token Meter はそのいずれもアップロードしません。ヒューリスティック、正規表現、SQL 集計のみを使用します。
• SDK の統合も、無料プランで設定が必要なプロキシもありません。
• CLI とダッシュボードのコア部分は MIT ライセンスです。

料金プラン

プラン	料金	内容
Free	$0	Claude Code + Codex の解析、MCP／ツールの内訳、時間別／モデル別／プロジェクト別の内訳、7日間の履歴、デスクトップ通知1件
Pro	$5/mo	Free のすべての機能に加え、月次の支出レビューに最適化：30日間の履歴（今月と先月の比較）、予算を超過した実行まで確認できるセッション別／メッセージ別の詳細表示、キャッシュ効率による節約額、無駄の兆候（過大なツール応答と、効果のなかったキャッシュ）、さらにスマートアラート無制限（デスクトップ + Webhook）
Pro+	later	ローカル LLM プロキシ（Ollama / LM Studio / llama.cpp / vLLM）、GPU／VRAM の追跡、自動アクション

Pro は、先週の数値をざっと見るだけの場合と、今月の支出がどこで膨らんだかを確認する場合の違いです。Pro は提供中です — token-meter.dev で購読。

Pro+ は、Pro への登録数とコミュニティの需要によって対象市場が確認され次第、リリースします。

ロードマップ

• M1 ✅ Claude Code の解析、MCP／ツールの内訳、時間別統計
• M2 ✅ Codex 連携
• M3 ✅ Pro プラン（$5）、Polar.sh の課金、ライセンスの有効化
• M4+ Pro+（ローカル LLM プロキシ、GPU の追跡）、需要に応じて提供

プライバシーとセキュリティ

• トークン数は、Claude Code と Codex がすでに書き込んでいる JSONL ファイルから集計します。 Token Meter は、どちらのベンダーのネットワーク API にもアクセスしません。
• プロンプトや応答の本文はデフォルトでは保存せず、メタデータのみを保存します （タイムスタンプ、トークン数、ツール名、応答の長さ）。
• データベースは ~/.tokenpulse/ に保存されます。削除するとデータを消去できます。（将来のリリースでは ~/.tokenmeter/ に名称を変更し、自動移行を行います。）

変更履歴

リリースノートと破壊的変更については、CHANGELOG.md をご覧ください。

ライセンス

CLI、ダッシュボード、パーサーは MIT ライセンスです。Pro プランの機能は、クローズドソースライセンスの別パッケージとして提供されます。