CodeBurnはClaude Code、Cursor、Codexなど41種類のAIコーディングツールのセッションログをローカルで読み取り、トークン使用量と費用をタスク・モデル・プロジェクト別に可視化するツールです。CLI・ターミナルUI・Webダッシュボード・デスクトップアプリの4つの入口を持ち、すべて同じCLIのデータを参照します。料金計算にはLiteLLMの価格表を使い、外部にデータを送信しません。
各AIツールが端末に書き出すセッションログを、CodeBurnのCLIが直接パースします。パース結果はLiteLLMの価格表と突き合わせてコストを算出し、ローカルにキャッシュとして保存します。初回のみ全履歴を走査するコールドキャッシュ構築が発生し、数十秒から最大10分ほどかかることがあります。TUIやWebダッシュボードはこのCLIをワンショットまたは常駐サーブモードで呼び出し、結果を受け取って描画します。Electronデスクトップアプリはcli.tsとmain.tsから、同梱または外部のcodeburnバイナリをspawnし、IPC経由でレンダラーに結果を渡します。読み取り中は無出力タイムアウト(既定45秒、コールド時は10分)で監視され、Windowsでも孤児プロセスを検知して回収する仕組みがあります。Claude・Codex・Geminiなどの利用枠表示は、各ツールの認証情報ファイルやキーチェーンを読み取って取得します。
- STEP 01
npx codeburnを実行すると、手元のClaude Code・Cursor・Codexなどのセッションログをスキャンします。初回はコールドキャッシュ構築のため数十秒から最大10分ほど待たされることがあります。
- STEP 02
スキャン完了後、ターミナルUIにモデル別・プロジェクト別のトークン使用量と費用の内訳が表示されます。
- STEP 03
npx codeburn webを実行すると、ブラウザでWebダッシュボードが立ち上がり、同じデータをグラフィカルに確認できます。
- STEP 04
codeburn menubarやデスクトップアプリのdmg・msi・AppImageなどを使うと、常駐型で費用推移を確認できます。対応ツールならAPI利用枠も表示されます。
- STEP 05
設定画面でテレメトリの有効・無効を切り替えられます。送信される場合も、金額は粗いバケット(例: 1-10ドル)に丸められた匿名の集計値のみです。
手元のAIコーディングツールの費用が、どのモデル・どのプロジェクト・どのタスクに使われているかを、請求書だけでは分からない粒度で把握できます。全処理はローカルのCLIプロセス内で完結し、ダッシュボード表示用のデータもディスク上のセッションログとキャッシュファイルとして残ります。
quota機能はClaude・Codex・Gemini・Copilotなどの認証情報ファイルやキーチェーンにアクセスします。「no API keys」という説明とは別に、この点は留意が必要です。
初回のコールドキャッシュ構築は、環境によって最大10分程度かかる可能性があります(コード内のWARMUP_TIMEOUT_MSがそれに相当します)。
41種類のツール対応を謳っていますが、実際に使っているツールが対応範囲に含まれるかは事前に確認したほうがよいです。
価格計算はLiteLLMのデータに依存するため、各ベンダーの価格改定への追従にはタイムラグが生じる可能性があります。
Claude Code・Cursor・Codexなど複数のAIコーディングツールを併用し、費用の内訳を可視化したい開発者に向いています。無出力タイムアウトの watchdog やWindows孤児プロセス回収、コールドキャッシュ猶予など、実運用を意識した細かなテストファイルが多数存在します。この作り込みの丁寧さから、実際に動かさなくても挙動の妥当性はある程度信頼してよいと判断できます。ただしquotaまわりの認証情報アクセスと、対応ツール範囲の実態は導入前に確認することをおすすめします。