← 返回列表

claudit:自托管的 Claude Code 用量统计看板,按项目做成本核算

Nitjsefnie/claudit · Self-hosted Claude Code usage dashboard — TTL-correct cost accounting and per-project attribution for session transcripts

GitHub原文发布 未知首次收录 2026-10-05上架 2026-10-05 07:02

☆ 收藏查看项目 ↗

ELI5:它是什么,解决什么问题

claudit 是一个自托管 Web 应用,用 FastAPI 从 Cloudflare R2(或本地 file:// 镜像)摄取 Claude Code 会话转录,解析入库到 Postgres,并通过 React 前端展示用量仪表盘。它聚焦“花了多少、用了多少、什么时候用”的量化统计,包括按模型的成本拆分(含 5 分钟 / 1 小时缓存创建 TTL 计费差异)、Token 明细、思考输出、提示缓存 TTL 拆分、响应大小、单会话上下文增长、会话消耗速率、工具使用比例与错误率、回复延迟、活动热力图、按上下文长度与 Agent 类型的成本、代码增删行估计,并对跨文件 uuid 去重、限流命中做检测。同一套部署也可解析 Codex 与 Kimi(kimi-code 与 legacy)转录并统一入表,支持多用户认证或访客模式、时间范围选择与实时更新。

核心能力与快速开始

★ 5 · Python

能做什么
从对象存储(Cloudflare R2 或多个桶,亦可用本地 file:// 镜像)小时级摄取 Claude Code、Codex、Kimi CLI 会话转录,解析进 Postgres,并通过 FastAPI 提供仪表盘 API 与 React(浏览器内 Babel,无构建步骤)前端。统计维度包括:按模型的成本拆分(含 ephemeral_5m / ephemeral_1h 缓存创建 TTL 计费差异)、Token 明细(输入/输出/缓存创建/缓存读取)、思考输出、提示缓存 TTL 拆分、可见响应字符大小、单会话上下文增长、会话消耗速率、工具使用比例与工具错误率、回复延迟分位数、捷克本地时间的活动热力图、按上下文长度与 Agent 类型的成本、代码新增/删除行估计。另含跨文件 uuid 去重(is_canonical 标记)、限流命中检测、可配置品牌名、时间范围选择(24h/7d/30d/90d/1y/all)、SSE 实时更新、用户名密码(外部 auth 库 PBKDF2)或访客模式认证。
适用场景
适合个人或团队自托管,长期追踪 Claude Code(以及同部署下的 Codex、Kimi)编程会话的 Token 消耗与花费,查看按模型、按项目、按上下文长度、按 Agent 类型的成本归属;分析提示缓存 TTL 命中情况、回复延迟与工具错误率,观察活动时段分布与代码产出量。也可通过 APP_NAME/APP_TITLE/APP_DESCRIPTION 用同一套代码配置成 codexmeter / kimimeter 等品牌部署。
项目形态
可直接使用的工具
部署方式
自托管:需自行运行 Postgres(claudit 库 + 独立的外部 auth 库),配置 R2_BUCKET(支持用 + 连接多个桶)、R2_ENDPOINT、DATABASE_URL_VIZ/AUTH、ADMIN_TOKEN 等环境变量,再以 uvicorn 启动 backend.app:app。README 给出首次启动、升级既有数据库时的 re-key 注意事项。
主要依赖
Python;Postgres 数据库(含一个外部 auth 库,其 users 表需由使用方自行管理与填充,应用只读);对象存储(Cloudflare R2 或本地 file:// 镜像);前端依赖从 unpkg.com 通过带 SRI 的固定标签加载,浏览器无法访问 unpkg.com 时页面空白且无回退 UI;导出 PNG 功能需一个同时装有 matplotlib 与 psycopg 的 Python 解释器(由 EXPORT_PYTHON 指定,默认 /usr/bin/python3)。
使用限制
定位为纯统计看板,README 明确不做会话分析、教练或审计,不评估会话质量、不生成 AI 叙述,相关 PR 被列为超出范围。成本数据依赖 src/pricing.json 中的费率,费率变更需提升 PRICING_VERSION 重定价,未说明费率来源的时效保证。代码增删行数为基于命令文本的估算,不执行命令、不校验成功率。浏览仪表盘时会访问 unpkg.com、fonts.googleapis.com 与 fonts.gstatic.com。活动热力图使用 Europe/Prague 时区。未说明硬件规模、并发能力、API 成本与商业使用许可之外的限制(许可证为 MIT)。
许可证
MIT
最近推送
2026-10-05 06:02

资料检查:2026-10-05 07:00 · 卡片整理:2026-10-05 07:00
卡片由 AI 根据仓库资料整理,未进行安装或运行验证 · 本次更新未完成,保留上次成功内容

职业应用

程序员

自托管 Claude Code 用量看板,用于按项目核算 AI 编码会话成本:按模型拆分成本(含 5 分钟/1 小时缓存创建 TTL 计费差异)、Token 明细、思考输出、提示缓存 TTL 拆分、响应大小、单会话上下文增长、会话消耗速率、工具使用比例与错误率、回复延迟、活动热力图、按上下文长度与 Agent 类型的成本、代码增删行估计,并支持跨文件 uuid 去重与限流命中检测。

查看内容依据
claudit 是一个自托管 Web 应用,用 FastAPI 从 Cloudflare R2(或本地 file:// 镜像)摄取 Claude Code 会话转录,解析入库到 Postgres,并通过 React 前端展示用量仪表盘。

官方使用入口 ↗

由 AI 根据来源材料整理,未进行安装或运行验证

这是基于来源内容整理的摘要。原文链接失效后,本页摘要和讨论仍会保留。

讨论 0

登录后参与讨论,阅读资讯无需注册。

还没有评论,来分享第一个看法。