Claude Token Analyzer

Claude Token Analyzer

你的 Claude Code 会话可能正在消耗你看不到的令牌。 诊断令牌都花在了哪里、为什么会浪费，以及应该先修复什么。

完全本地运行——将 ~/.claude JSONL 文件解析到 SQLite。数据不会离开你的设备。无云端服务。无遥测。

English | 繁體中文

功能

• 诊断令牌浪费——检测 6 种统计异常类型（HighCost、LowCacheHitRate、CostInefficient、ExcessiveToolUse、HighTokenUsage、UnusualModelMix），并为严重程度评分
• 审计成本——按会话、项目和全局汇总成本，并显示月度趋势
• 预测支出——根据每日／每周／每月用量趋势预测消耗速率
• 优化缓存——找出缓存命中率低、导致成本增加的会话
• 确定修复优先级——按严重程度为异常评分，让你知道应该先修复什么，而不只是发现问题
• 自然对话——用自然语言提问：“我花了多少钱？”或“扫描异常”

快速开始

# Install (binary auto-downloads, no Rust toolchain needed)
claude plugin install claude-token-analyzer

然后，在任意 Claude Code 会话中提问：

> cta
> how much did I spend this month?
> scan for anomalies
> analyze this project
> show me usage trends

工作原理

~/.claude/projects/**/*.jsonl       Your session logs (never modified)
    → parser.rs                     Extract + deduplicate responses
    → analyzer.rs                   Cost calculation, 10-dimension metrics
    → storage.rs                    Upsert into local SQLite
    → detector.rs                   6-type anomaly detection + severity scoring
    → MCP tools / Skills            You ask, it answers

所有处理都在本地完成。在插件模式下，SQLite 数据库位于插件数据目录中；在独立模式下，则使用 ~/.claude/。运行时不会进行网络调用，也不依赖外部组件。

技能

技能	触发短语	功能
cta	“cta”、“analyze tokens”	路由到合适的子技能
cta-health-check	“quick check”、“overview”、“看看狀況”	单页用量摘要
cta-cost-audit	“monthly costs”、“cost report”、“這個月花多少”	按模型细分的月度成本明细
cta-anomaly-hunt	“anomalies”、“problems”、“有異常嗎”	统计异常扫描并支持深入分析
cta-project-review	“analyze project”、“專案健檢”	四维项目分析
cta-trend-watch	“trends”、“burn rate”、“趨勢”	用量趋势分析与预测

MCP 工具

工具	用途
sync_db	将 JSONL 会话日志同步到 SQLite
analyze_session	对会话进行 10 维分析
analyze_project	按项目汇总并排序
analyze_global	跨项目全局概览
cost_report	月度成本报告（也可按日查看）
anomaly_scan	检测 6 种异常类型并为严重程度评分
trend_report	时间序列趋势（每日／每周／每月）

配置

环境变量（均为可选）：

变量	用途	默认值
CTA_DB_PATH	SQLite 数据库位置	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer.db 或 ~/.claude/token-analyzer.db
CTA_PROJECTS_DIR	会话日志目录	${CLAUDE_CONFIG_DIR}/projects 或 ~/.claude/projects
CTA_ARCHIVE_DIR	归档目录	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer-archive 或 ~/.claude/token-analyzer-archive
CTA_PRICING_PATH	自定义定价 TOML	嵌入二进制文件中
CLAUDE_CONFIG_DIR	会话日志的 Claude 配置根目录	未设置

路径解析优先级：

• DB／归档：环境变量 > 插件模式（$CLAUDE_PLUGIN_ROOT）> 独立模式（$HOME/.claude/）
• 项目：环境变量 > Claude 配置目录（$CLAUDE_CONFIG_DIR/projects）> 独立模式（$HOME/.claude/projects）

从源代码构建

git clone https://github.com/li195111/claude-token-analyzer.git
cd claude-token-analyzer
bash scripts/build.sh
# Binary: mcp-server/target/release/cta-mcp-server

# Run tests (106 tests)
cargo test --all-targets --manifest-path mcp-server/Cargo.toml

# Lint
cargo clippy --manifest-path mcp-server/Cargo.toml -- -D warnings

# Launch with plugin loaded
claude --plugin-dir .

需要：Rust 工具链

Contributing

Issues and PRs welcome! See open issues for starter tasks.

Development setup:

1. Clone the repo and run bash scripts/build.sh
2. Run cargo test --all-targets --manifest-path mcp-server/Cargo.toml to verify
3. Load the plugin locally with claude --plugin-dir .

Rust toolchain required. The project uses cargo clippy -- -D warnings for linting.

License

MIT

---

繁體中文

你的 Claude Code 會話可能正在浪費你看不見的 token。 診斷 token 流向、浪費原因，並告訴你該優先修正什麼。

全本地運行 — 解析 ~/.claude JSONL 檔案到 SQLite。資料不離開你的機器。無雲端、無遙測。

功能特色

• 診斷 token 浪費 — 6 種統計異常類型，含嚴重度評分
• 成本審計 — 按會話、專案、全域的費用拆解與月度趨勢
• 趨勢預測 — 日/週/月用量趨勢與燃燒率預測
• 快取優化 — 識別低快取命中率的會話，降低不必要開銷
• 嚴重度排序 — 優先處理影響最大的問題，不只是標記異常
• 自然語言互動 — 用中文直接問：「看看狀況」「這個月花多少」「有異常嗎」

快速開始

# 安裝（自動下載 binary，無需 Rust 工具鏈）
claude plugin install claude-token-analyzer

然後在 Claude Code 中直接問：

> 看看狀況
> 這個月花多少？
> 有異常嗎？
> 分析這個專案
> 用量趨勢

技能一覽

技能	觸發語	功能
cta	"cta"、"分析 token"	智能路由至子技能
cta-health-check	"看看狀況"、"總覽"	一頁式用量摘要
cta-cost-audit	"這個月花多少"、"成本報告"	月度費用明細
cta-anomaly-hunt	"有異常嗎"、"排查"	統計異常掃描
cta-project-review	"專案健檢"	四維度專案分析
cta-trend-watch	"趨勢"、"燃燒率"	用量趨勢分析

歡迎台灣及亞洲開發者試用和回饋！