Claude Token Analyzer

Claude Token Analyzer

Claude Code のセッションでは、気付かないうちにトークンを消費しているかもしれません。 診断機能で、トークンの消費先や無駄になっている原因、最初に対処すべきことを特定します。

完全ローカルで動作 — ~/.claude の JSONL ファイルを SQLite に解析します。データがマシンの外に送信されることはありません。クラウドもテレメトリーもありません。

英語 | 繁體中文

機能

• トークンの無駄を診断 — 6 種類の統計的な異常（HighCost、LowCacheHitRate、CostInefficient、ExcessiveToolUse、HighTokenUsage、UnusualModelMix）を重大度スコア付きで検出します
• コストを監査 — セッション別、プロジェクト別、全体のコスト内訳と月次推移を表示します
• 支出を予測 — 日次／週次／月次の使用量推移と消費率予測を表示します
• キャッシュを最適化 — キャッシュヒット率が低く、コストが増加しているセッションを特定します
• 修正の優先順位を決定 — 異常に重大度スコアを付けることで、問題点だけでなく、最初に修正すべき点が分かります
• 自然な言葉で会話 — 「いくら使った？」「異常をスキャンして」のように、普段の言葉で質問できます

クイックスタート

# Install (binary auto-downloads, no Rust toolchain needed)
claude plugin install claude-token-analyzer

あとは、Claude Code の任意のセッションで次のように尋ねるだけです。

> cta
> how much did I spend this month?
> scan for anomalies
> analyze this project
> show me usage trends

仕組み

~/.claude/projects/**/*.jsonl       Your session logs (never modified)
    → parser.rs                     Extract + deduplicate responses
    → analyzer.rs                   Cost calculation, 10-dimension metrics
    → storage.rs                    Upsert into local SQLite
    → detector.rs                   6-type anomaly detection + severity scoring
    → MCP tools / Skills            You ask, it answers

すべての処理はローカルで行われます。SQLite データベースは、プラグインモードではプラグインのデータディレクトリに保存され、スタンドアロンモードでは ~/.claude/ にフォールバックします。ネットワークへの接続や、実行時の外部依存関係はありません。

スキル

スキル	起動フレーズ	機能
cta	"cta", "analyze tokens"	適切なサブスキルに振り分けます
cta-health-check	"quick check", "overview", "看看狀況"	使用状況を 1 ページにまとめます
cta-cost-audit	"monthly costs", "cost report", "這個月花多少"	モデル別内訳を含む月次コストの内訳を表示します
cta-anomaly-hunt	"anomalies", "problems", "有異常嗎"	詳細分析が可能な統計的異常スキャンを実行します
cta-project-review	"analyze project", "專案健檢"	4 つの観点からプロジェクトを分析します
cta-trend-watch	"trends", "burn rate", "趨勢"	予測機能付きの使用量推移分析を行います

MCP ツール

ツール	目的
sync_db	JSONL のセッションログを SQLite に同期します
analyze_session	セッションを 10 の観点から分析します
analyze_project	並べ替え機能付きでプロジェクト単位に集計します
analyze_global	プロジェクト横断の全体像を表示します
cost_report	月次コストレポートを表示します（日次単位も利用できます）
anomaly_scan	重大度スコア付きで 6 種類の異常を検出します
trend_report	時系列の推移（日次／週次／月次）を表示します

設定

環境変数（すべて任意）：

変数	目的	デフォルト
CTA_DB_PATH	SQLite データベースの保存場所	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer.db または ~/.claude/token-analyzer.db
CTA_PROJECTS_DIR	セッションログのディレクトリ	${CLAUDE_CONFIG_DIR}/projects または ~/.claude/projects
CTA_ARCHIVE_DIR	アーカイブディレクトリ	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer-archive または ~/.claude/token-analyzer-archive
CTA_PRICING_PATH	カスタム料金設定 TOML	バイナリに埋め込み
CLAUDE_CONFIG_DIR	セッションログ用の Claude 設定ルート	未設定

パスの解決優先順位：

• DB／アーカイブ：環境変数 > プラグインモード（$CLAUDE_PLUGIN_ROOT）> スタンドアロンモード（$HOME/.claude/）
• Projects：環境変数 > Claude 設定ディレクトリ（$CLAUDE_CONFIG_DIR/projects）> スタンドアロンモード（$HOME/.claude/projects）

ソースからビルド

git clone https://github.com/li195111/claude-token-analyzer.git
cd claude-token-analyzer
bash scripts/build.sh
# Binary: mcp-server/target/release/cta-mcp-server

# Run tests (106 tests)
cargo test --all-targets --manifest-path mcp-server/Cargo.toml

# Lint
cargo clippy --manifest-path mcp-server/Cargo.toml -- -D warnings

# Launch with plugin loaded
claude --plugin-dir .

必要なもの：Rust ツールチェーン

コントリビューション

Issue と PR を歓迎します！初めて取り組む方に適したタスクについては、未解決の Issueをご覧ください。

開発環境のセットアップ：

1. リポジトリをクローンし、bash scripts/build.shを実行します
2. cargo test --all-targets --manifest-path mcp-server/Cargo.tomlを実行して確認します
3. claude --plugin-dir .を使ってプラグインをローカルで読み込みます

Rust ツールチェーンが必要です。このプロジェクトでは、Lint にcargo clippy -- -D warningsを使用します。

ライセンス

MIT

---

繁體中文

Claude Code のセッションでは、見えないところでトークンが無駄になっている可能性があります。 トークンの流れと無駄の原因を診断し、何を優先して修正すべきかをお知らせします。

すべてローカルで実行 — ~/.claudeの JSONL ファイルを SQLite に解析します。データがマシンの外に出ることはありません。クラウドもテレメトリーもありません。

主な機能

• トークンの無駄を診断 — 重大度スコア付きの 6 種類の統計的異常
• コスト監査 — セッション別、プロジェクト別、全体の費用内訳と月次推移
• 傾向の予測 — 日・週・月ごとの使用量の傾向と消費ペースの予測
• キャッシュの最適化 — キャッシュヒット率の低いセッションを特定し、不要なコストを削減
• 重大度順の並べ替え — 異常を示すだけでなく、影響の大きい問題を優先して対応
• 自然言語でのやり取り — 中国語で「状況を見て」「今月はいくら使った？」「異常はある？」と直接質問できます

クイックスタート

# 安裝（自動下載 binary，無需 Rust 工具鏈）
claude plugin install claude-token-analyzer

その後、Claude Code で直接質問できます：

> 看看狀況
> 這個月花多少？
> 有異常嗎？
> 分析這個專案
> 用量趨勢

スキル一覧

スキル	起動フレーズ	機能
cta	"cta"、"トークンを分析"	サブスキルにインテリジェントに振り分け
cta-health-check	"状況を見て"、"概要"	1 ページで使用量を要約
cta-cost-audit	"今月はいくら使った"、"コストレポート"	月次の費用明細
cta-anomaly-hunt	"異常はある？"、"調査"	統計的異常をスキャン
cta-project-review	"プロジェクトの健全性チェック"	4 つの観点からプロジェクトを分析
cta-trend-watch	"傾向"、"消費ペース"	使用量の傾向を分析

台湾およびアジアの開発者の皆さん、ぜひお試しいただき、フィードバックをお寄せください！