β 公開中 · OSS（MIT）

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

Name: koji-lens
Author: Koji

ローカルで完結、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▍

GitHub で見る

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` で英語セリフにも対応。