Tokscale：1746⭐の AI Coding Agent トークン追跡ツール

複数の AI プログラミングアシスタント（OpenClaw、Claude Code、Codex など）を同時に使っていると、悩みが出てくる：これらのツールに毎月どれだけのトークンを消費しているか把握できない。今回紹介する Tokscale は、この問題を解決するために作られた高性能 CLI ツールだ。

プロジェクト概要

属性	内容
GitHub	junhoyeo/tokscale
Stars	1,746
言語	Rust
特徴	マルチエージェント対応、TUI インターフェース、トークン可視化
最終更新	アクティブ

解決する課題

AI プログラミングアシスタントが普及する中、課金方式はトークン制が基本。複数のツールを使い分けると：

• OpenClaw で日常業務を処理
• Claude Code で複雑なロジックを作成
• Codex でコードレビュー
• Gemini CLI で検索補助

こうした分散した消費をまとめるのは難しい。Tokscale はこれらのツールのデータベースとログファイルを自動スキャンし、統一されたトークン使用ビューを提供する。

対応 AI ツール

ツール	データ保存場所	対応状況
OpenClaw	~/.openclaw/agents/	✅ 対応
Claude Code	~/.claude/projects/	✅ 対応
OpenCode	~/.local/share/opencode/	✅ 対応
Codex CLI	~/.codex/sessions/	✅ 対応
Gemini CLI	~/.gemini/tmp/	✅ 対応
Hermes Agent	~/.hermes/state.db	✅ 対応

主な機能

リアルタイム TUI ダッシュボード

Tokscale v2 は Rust で書き直された TUI インターフェースを搭載し、キーボードナビゲーションに対応。メイン画面には以下が表示される：

• 今日/今週/今月のトークン統計
• 各 AI ツールの使用量比率
• 推定コスト（現在のモデル価格ベース）

自動データソース検出

手動でパスを設定する必要はない。Tokscale は一般的な AI ツールのデータ保存場所を自動検出する。レガシーパスと新版パスの移行検出にも対応。

可視化ランキングボード

bunx tokscale@latest submit を実行するとデータを tokscale.ai に送信し、個人の Wrapped 2025 レポートを生成。世界中のユーザーのトークン使用量ランキングも確認できる。

3D Contributions Graph

フロントエンドの可視化ページは、GitHub contributions のような 3D ヒートマップを提供し、AI の使用習慣を直感的に表示する。

クイックスタート

# npm でインストール
npm install -g tokscale

# または bun を使用
bun install -g tokscale

# TUI を起動
tokscale

Rust ユーザーの場合：

cargo install tokscale

使用シーン

コスト管理

Claude Code で大規模プロジェクトを処理する際、トークン消費は予想外に膨れ上がることがある。Tokscale のリアルタイム統計により、異常な使用量をすぐに発見できる。

効率分析

Wrapped レポートを通じて、自身の AI 使用パターンを振り返れる：

• どの Agent を最も使用しているか？
• どの時間帯に効率が良いか？
• トークンはどのような種類のタスクに費やされているか？

チーム協業

チーム環境では、Tokscale を使ってプロジェクト全体の AI 支援コストを統計し、予算計画のデータとして活用できる。

技術的ハイライト

• Rust 実装：高性能、低メモリ消費
• クロスプラットフォーム：macOS、Linux、Windows に対応
• ゼロコンフィグ：データソースを自動検出し、すぐに使用可能
• ローカルファースト：すべてのデータ処理はローカルで完了し、プライバシーを保護

注意事項

• Node.js 18+ または Bun ランタイムが必要
• leaderboard などの一部機能はデータをクラウドに送信する必要がある
• コスト推定は公開価格に基づくため、実際の請求はプランによって異なる場合がある

まとめ

Tokscale は、AI プログラミングアシスタントのエコシステムにおける空白を埋めるツール：使用量の可視化。AI ツールが普及する現代において、これらのツールへの投入対効果を把握することは重要になっている。1,746 スターの Tokscale はまだ一般的なツールとは言えないが、ヘビーな AI ユーザーにとって実用的な監視ツールだ。

プロジェクト情報

属性	内容
リポジトリ	https://github.com/junhoyeo/tokscale
公式サイト	https://tokscale.ai
ライセンス	MIT
言語	Rust + TypeScript
メンテナ	@junhoyeo