token-tracker は何をしますか？
ローカルAIエージェント（Claude Code、Codex）でのトークン使用量を追跡 — コスト分析、レート制限監視、セッション追跡機能を備えたCLIダッシュボード。
概要
token-trackerは、開発マシン上で動作するAIエージェントのトークン使用状況を監視・分析するためのコマンドラインツールです。
機能
- トークン使用量の追跡: Claude CodeやCodexが消費したトークン数をリアルタイムで記録
- コスト分析: トークン使用量に基づいて推定コストを計算し、月間・セッションごとのレポートを提供
- レート制限監視: API呼び出しのレート制限に近づいているかを警告
- セッション追跡: 各エージェントセッションの開始・終了時刻と消費トークンを記録
使用方法
# インストール
git clone https://github.com/stormzhang/token-tracker.git
cd token-tracker
pip install -r requirements.txt
# CLIの実行
python tracker.py --help
# セッションの開始
python tracker.py start --agent claude-code
# 現在の使用量を表示
python tracker.py status
# レポートの生成
python tracker.py report --period weekly
設定
config.yamlファイルで以下の項目を設定できます：
agents:
claude-code:
token_cost_per_1k: 0.015 # USD per 1k tokens
codex:
token_cost_per_1k: 0.02 # USD per 1k tokens
rate_limit:
max_requests_per_minute: 60
warning_threshold: 0.8 # 80%で警告
対応エージェント
- Claude Code
- Codex
出力例
Token Usage Report (2024-03-15)
================================
Agent: claude-code
Total Tokens: 125,432
Estimated Cost: $1.88
Requests Today: 23
Rate Limit: 38% used
Agent: codex
Total Tokens: 45,210
Estimated Cost: $0.90
Requests Today: 12
Rate Limit: 20% used
詳細情報
詳細なドキュメントはGitHubリポジトリを参照してください。