ccusage の代替:常時そばにいるビジュアルな GUI
ターミナルで Claude Code の token 使用量を確認する人気ツール ccusage を使っていて、「ひと目で見られる画面がほしい」と思ったことはありませんか。Token Forest はその、常時デスクトップに居るビジュアルな代替です。同じローカルログを読み取りますが、必要に応じてレポートを表示する代わりに、デスクトップで育つピクセルの木を育て、使用量と概算コストを記録する完全オフラインのダッシュボードを備えています。どちらが自分に合うか(あるいは両方使うか)を選べるよう、正直な比較をまとめました。
最終更新 2026年7月11日
ひと言でいうと
ccusage は高速でオープンソースのコマンドラインツールで、ローカルの Claude Code(および Codex)ログを、ターミナル上の日次・月次・セッション別・5 時間の課金ブロック別のコストレポートに変えます。Token Forest は同じログを読み取り、それを心地よいピクセルのペットと 3 つのビューを持つダッシュボードに変える独立したデスクトップアプリです。どちらも何もアップロードせず、コストはローカルで見積もります。
要点:Token Forest は ccusage のビジュアルな代替であり、そのフロントエンドではありません。ccusage とコードを一切共有せず、完全に独立して動作します。ターミナルが好きなら ccusage を使い続けてください。常時ひと目で見られるビューがほしいなら Token Forest を加えてください。
ccusage の優れている点
ccusage(npm パッケージ名 ccusage、作者 ryoppippi、MIT ライセンス)は本当に優れたツールで、ターミナル中心のワークフローにはおすすめです。
- ✦どのターミナルでも即座にレポート —— npx で実行、インストール不要。
- ✦日次・週次・月次・セッション別・5 時間の課金ブロック別に、token と概算コストを内訳表示。
- ✦ターミナルレポートに加えて、実験的(ベータ)な Claude Code のステータスライン表示。
- ✦スクリプト化でき CI に優しい —— JSON 出力、日付フィルタ、モデル別内訳に対応。
- ✦多くのコーディングエージェント(Claude Code を含む 15 種以上 —— Codex、Gemini CLI、Copilot CLI など)を読み取ります。
Token Forest が加えるもの
Token Forest は Windows 10/11 と macOS 向けの、心地よいピクセルアートのデスクトップペットです。無料(パブリックベータ)で、ローカルファースト、完全オフラインで動きます。
- ✦常にそばにいる相棒:作業するあいだ、token 使用量が 8 段階でピクセルの木を育てます —— コマンド不要。
- ✦3 つの相互に裏づけ合うビューを持つ完全オフラインのダッシュボード —— 成長(木ごとの段階、植えてからの日数、「この木 ≈ $X」)、使用量(日次/週次/月次のグラフ、Claude Code と Codex のモデル別内訳、26 週間のヒートマップ、バーンレート、プロジェクト別合計)、チャット(会話ごとに 1 行、4 種類の token と概算コスト)。
- ✦生の数字ではなく、やさしいゲーミフィケーションの動機づけ —— 努力が育つものに変わっていくのを眺められます。
- ✦任意参加のグローバルリーダーボード。既定ではオフで、比べたいときだけ自分で参加します。
ccusage と Token Forest の早見表
| 機能 | ccusage(CLI) | Token Forest(アプリ) |
|---|---|---|
| インターフェース | ターミナル CLI | デスクトップペット + ダッシュボード |
| 動作環境 | 任意のターミナル(npm/npx) | Windows 10/11、macOS |
| 読み取る対象 | ローカルログ(Claude Code・Codex ほか十数種) | ローカルログ(Claude Code + Codex) |
| 出力 | 日次/週次/月次/セッション/5 時間ブロックのレポート | 成長・使用量・チャットの 3 ビュー + ライブの木 |
| 常駐/ライブ | Claude Code のステータスライン(ベータ) | 常駐ペット、作業に応じて成長 |
| 動機づけ | 数字 | ゲーミフィケーションのピクセルの木、8 段階 |
| リーダーボード | — | 任意参加、既定でオフ |
| コスト表示 | 価格表からローカルで概算 | 内蔵の価格表からローカルで概算 |
| 価格 | 無料・オープンソース(MIT) | 無料(パブリックベータ) |
| 向いている人 | ターミナル利用者、スクリプト、CI | ビジュアルで常時のビューがほしい人 |
同じログを読み、コードには一切触れません
どちらのツールもあなたの端末上のローカル使用ログだけを読み取ります —— Claude Code は ~/.claude、Codex は ~/.codex。Token Forest は token 数と、わずかな構造メタデータ(モデル名、タイムスタンプ、セッションのタイトル、プロジェクトフォルダ名、git ブランチ、セッション id、メッセージ種別の構造)だけを使います。あなたのソースコードやプロンプト、会話の内容は決して読みません。テレメトリは送らず、ネットワークを完全に切っても動作します。
token の数字が巨大に見える理由
どちらのツールも 4 種類の token を追跡します:入力、出力、キャッシュ読み取り、キャッシュ書き込み。キャッシュ読み取りは生の数では大半を占めますが、1 つあたりは非常に安価です —— Token Forest 自身の 6 週間のサンプルでは、キャッシュ読み取りが実コストの約 57% を占め、入力と出力を合わせても約 24% でした。だからこそ生の token 合計は途方もなく見えても、実コストは控えめなままなのです。
両ツールに共通する正直な注意点:これらのドル金額はローカルの価格表から見積もった概算であり、実際の Anthropic や OpenAI の請求額とは異なることがあります。近い、あなただけの概算値として扱い、自分の実数の推移は Token Forest のダッシュボードで確認してください。
どちらを選ぶべき?
- ✦ターミナルに常駐し、CI 向けのスクリプト可能な出力がほしい、あるいはたまに素早く数字を見たいだけなら —— ccusage。
- ✦ビジュアルで常時見られるビュー、クリックできるダッシュボード、そして少しの動機づけがほしいなら —— Token Forest。
- ✦迷ったら?両者は競合しません —— 両方入れて、その時々で合う方を使いましょう。
両方いっしょに使える?
使えます。どちらも同じ読み取り専用ログを読み、書き換えないので、ターミナルの ccusage とデスクトップの Token Forest は仲良く共存します。CI の素早い確認には ccusage、毎日のひと目の全体像には Token Forest、という使い分けをする人も多いです。
よくある質問
Token Forest は ccusage の GUI やフロントエンドですか?
いいえ。Token Forest は ccusage とコードを一切共有しない独立したアプリです。同じローカルログを直接読み取り、すべて自前で計算します。ccusage は素晴らしいツールだと思っています —— Token Forest は、使用量を「表示」するより「眺めたい」人のためのビジュアルな代替にすぎません。
ccusage のデスクトップアプリや GUI はありますか?
ccusage 自体はターミナルの CLI で、デスクトップアプリではありません。同じ Claude Code と Codex の使用量をグラフィカルに常時見たいなら、Token Forest が Windows と macOS 向けの無料の代替で、完全オフラインのダッシュボードを備えています。
ccusage と Token Forest、どちらが正確ですか?
どちらも同じローカルログを読み、価格表からコストを見積もるため、token 数は一致し、ドル金額は正確な請求書ではなく近い概算になります。実際の請求は必ず Anthropic か OpenAI のアカウントで確認してください。日々のプライベートな概算にはどちらのツールでも十分です。
ccusage と Token Forest を同時に使えますか?
はい。どちらもログを読むだけで書き換えないので、干渉せず並行して動きます。ターミナルと CI には ccusage を、ビジュアルで常時のビューには Token Forest を加えてください。
Token Forest は一部のツールのように私のコードやプロンプトを読みますか?
いいえ。読み取るのはローカルログの token 数とわずかな構造メタデータだけで、ソースコードやプロンプト、会話の内容は決して読みません。テレメトリも送らず、ネットワークを完全に切っても動作します。
ターミナルツールに、ビジュアルな相棒を
Token Forest は ccusage と同じログを読む、無料・オフラインのデスクトップペット兼使用量ダッシュボード —— 作業するあいだにピクセルの木が育ちます。