β 公開中 · OSS(MIT)

月末に驚く前に、今日知る。

ローカルで完結、1 コマンドで可視化。あなたのマシン上で、コストと使い方を見える化。

koji-lens summary --since 30d
$ koji-lens summary --since 30d
koji-lens — analyzed 412 sessions
period: last 30d
==============================
TOTAL
sessions: 412
cost: $874.12 (¥135K)
models: claude-opus-4-7×1562, claude-sonnet-4-6×60
note: API-rate equivalent
$npm install -g @kojihq/lens
  • 01Claude Code、月いくら使ってますか?
  • 02何にトークンを使った日が高くついてましたか?
  • 03どのツール呼び出しが時間を食っていますか?

koji-lens は、ローカルに保存された Claude Code のセッションログを解析し、 あなたの AI コーディングの使い方を 1 コマンドで可視化します。

$ koji-lens summary --since 30d
TOTAL
sessions: 412
cost: $874.12 (¥135K)
top tools: Read×523, Bash×412, Edit×287, ...

2 つの使い方

Claude Code をどう契約しているかで、koji-lens の使いどころが変わります。

Claude Pro / Max 加入者

月 $20 / $200 のサブスクが、本当はいくらの価値か。

フラットな月額を払っているが、$20 として使っているのか、$500 として使っているのか — Anthropic はどこにも答えを出してくれません。

$ koji-lens summary --since 30d
TOTAL
cost: $874.12 (API-equivalent)
models: claude-opus-4-7×1562, claude-sonnet-4-6×60
note: API-rate equivalent.
Subscribers pay a flat fee regardless.

この $874.12 は、過去 30 日の使用量を API 換算したらいくらかかっていたかの値。$20/月 Pro の人なら、サブスク代の 40 倍超 になっていることが、ここで初めて数字で見えます。Claude Code の `/usage` にも Anthropic Console にも出てこない情報です。

API トークン課金ユーザー

月末請求が来る前に、Opus 偏重を捕まえる。

Sonnet で十分な作業まで Claude Code が Opus を使っている気がする — その勘を、数字に変える。

$ koji-lens summary --since 7d
TOTAL
cost: $187.45
cost by model:
claude-opus-4-7 $173.21 (92%)
claude-sonnet-4-6 $14.24 ( 8%)

92% が Opus に流れているのが見えれば、簡単なタスクは Sonnet に切り替える根拠になる。来週もう一度叩いて差を見る — 勘ではなく数字で、改善が見えてきます。

インストールして 1 分で分かること

ターミナル 1 コマンドで、AI コーディングの実態を掴む。

今月いくら使ったか

セッションごとの USD / JPY 換算コストと TOTAL 集計を即表示。月末の Anthropic 請求と照合できます。

どの作業が高くついたか

過去 7 / 30 日のコスト推移と top sessions。突出したセッションをワンクリックで掘れます。

ツール別の内訳が 1 コマンドで見える

`koji-lens tools` で Bash / Read / Edit / Write / MCP の使用回数を比率 + バーグラフ表示。期間内に何のツールがコストを引っ張ったかが即わかります。

statusline で常に状態が見える

Claude Code の statusLine 統合に対応。利用傾向 (💚 sub value up / 💧 under-utilized) + cache 効率 (💎) + agent 状態 (⚡/💤/🛑) + audit 異常 (🛡/⚠) を 1 行で表示。subscription default 出力例: 💚 ↑60% vs last month │ $30 more usage │ sub value up │ 💎 78% cache (Pro/Max 元取れてる + cache 効率 78%)。API ユーザーは `koji-lens config set billing-mode api` で v0.2 互換挙動に切替可。

監査ログを -79% 高速化、週次レビューが習慣に

`koji-lens audit` を実行するだけで、ファイル書き込み・外部通信・MCP 呼び出しを自動でカテゴリ分類。個人情報は伏字化済み。2 回目以降は -79% で返るので、週末 5 分の振り返りが続けられます。

麹キャラが statusline で発酵中

`--buddy` で麹キャラを忍ばせる。累計セッション数で Lv1 → Lv10 (3 年で Max)、5 状態 × 10 Lv = 50 セリフ。`--buddy-only` で麹だけの単独表示も可。

データはあなたの PC だけに留まる

クラウドへの送信なし。プロンプト本文は SQLite に保存しない設計。安心して全ログを解析できます。

Windows / macOS / Linux すべてで動く

Node.js 22+ で動く CLI、`koji-lens hook` 内蔵で OS 別シェルスクリプト不要。`--buddy-locale en` で英語セリフにも対応。

公式の usage と、何が違うか。

Claude Code の /usage コマンドと Anthropic Console との比較。

期間集計
公式(/usage / Anthropic Console)
24h / 週単位(固定)
koji-lens
--since で 24h / 7d / 30d / 任意 ISO 日付
プロジェクト / モデル / ツール / subagent 横断
公式(/usage / Anthropic Console)
✗
koji-lens
✓(パス・モデル・ツール名・親子構造で集計)
サブスク利用者のコスト見え方
公式(/usage / Anthropic Console)
利用状況のみ、コスト数値なし
koji-lens
API 換算値で参考表示(注記付き)
ローカル完結(社外送信なし)
公式(/usage / Anthropic Console)
Console / dashboard はクラウド経由
koji-lens
✓(JSONL ローカル解析、Free 永続)
JSON / CSV / Markdown エクスポート
公式(/usage / Anthropic Console)
✗
koji-lens
--format json / --summary-only / `koji-lens export --format markdown` で Zenn / HN / blog に貼り付け可能なテーブル整形 (CSV / JSON も同コマンド)
statusline 統合 + 麹キャラ
公式(/usage / Anthropic Console)
✗
koji-lens
`koji-lens statusline` で 1 行表示、`--buddy` で麹キャラ Lv1-10 進化、`--mode minimal | normal | detailed` で表示密度切替
tool_use 監査ログ (audit log)
公式(/usage / Anthropic Console)
✗
koji-lens
`koji-lens audit` で fs-read / fs-write / exec / fetch / task / mcp / other の 7 category 別抽出、PII 15 種 (Email / Phone / API key / Bearer / Card / UUID / JWT / AWS Key / GitHub Token / Webhook URL ほか) は自動 redaction、statusline で新規 MCP / 高頻度 exec / 機密ファイル書き込み 異常検知

公式の /usage は v2.1.105 以降搭載。Anthropic Console は API ユーザー向け請求確定値を月次で表示。koji-lens は Claude Code が ~/.claude/projects/ に書き出す JSONL をローカルで解析する設計、データ送信なしで集計・監査・statusline を一体提供します。

セッション単位でも、突出を一目で。

koji-lens sessions で個別セッションを並べ、コストの大きい行を即特定。ブラウザでも同じデータをひと目で確認できます。

koji-lens sessions --since 24h --limit 5
$ koji-lens sessions --since 24h --limit 5
055a662d-... 8m 58s $9.63
44c29745-... 1h 7m 33s $32.75
28cf16fa-... 7h 38m 22s $420.66 ← 突出
agent-a94b... 1m 9s $0.29 ↳ subagent
22a919c7-... 12m 4s $20.74
... (10 more)
# チャートで見るなら:
$ koji-lens serve
→ http://localhost:3210

ブラウザでも、同じデータを。

koji-lens serve でローカルに Web ダッシュボードを起動。チャートと集計数値で全体像を一画面に。

http://localhost:3210
koji-lens Web ダッシュボード — 合計コスト・KPI カード・セッション別コストとツール使用のチャートを 1 画面で可視化
実データのスクリーンショット(直近 30 セッション集計)

3 ステップで始める

Claude Code を使っていれば、追加設定なしですぐ動きます。

  1. 1インストール
    $npm install -g @kojihq/lens
  2. 2セッションサマリを見る
    $koji-lens summary
  3. 3ダッシュボードを起動
    $koji-lens dashboard

続きは koji-lens --help で。冒頭に「Quick Start (try these 3 commands first)」が出ます。

💡 短縮 alias lens でも実行できます(例: lens summary)。