Claude Statistics
English 29 ★
快速开始

从下载到看到第一份数据,大约 5 分钟。

Claude Statistics 是个原生 macOS 应用。安装、授权、自动索引,然后基础功能就绪；需要更多 provider、订阅 endpoint 或集成时,再从插件市场安装。

↓ 下载最新 DMG 查看源码
  1. 01

    确认系统要求

    Claude Statistics 是为 macOS 14 (Sonoma) 及以上设计的原生应用,在 Apple Silicon 和 Intel 上都跑得动。

    • macOS 14 Sonoma 或更新
    • Apple Silicon(M1+)或 Intel
    • 至少装了一个 AI CLI:Claude Code、Codex 或 Gemini
  2. 02

    下载并安装

    从 GitHub Releases 下载最新 DMG,把 Claude Statistics.app 拖进 Applications。

    • Latest DMG → 双击挂载 → 拖入 Applications
    • 首次打开如果被 Gatekeeper 拦下,在 Finder 右键选 'Open'
    • DMG 未走 Apple notarize,所以你可能需要执行下面这条命令
    xattr -cr /Applications/Claude\ Statistics.app
    提示 · 为什么不签名?这是开源项目,Apple Developer 会员费每年 99 美元。MIT 许可意味着任何人都可以从源码编译。
  3. 03

    首次启动 · 授权访问

    应用第一次启动时会请求读取 ~/.claude、~/.codex 和 ~/.gemini 三个目录。所有解析都在本地完成 — 没有数据离开你的机器。

    • 在 macOS 隐私设置里授权 Full Disk Access(可选,提升性能)
    • 应用图标会出现在菜单栏 — 这是它的家
    • 如果没出现,可能被自动隐藏 — 用 Bartender / Hidden Bar 显示出来
  4. 04

    等待第一次解析

    Claude Statistics 自动扫描 transcript 并建立 SQLite FTS 索引。首次解析时间取决于历史会话数量,通常几秒到一分钟。

    • 进度条会出现在菜单栏面板顶部
    • 解析完成后,Stats tab 立即显示总览数字
    • Sessions tab 按工作目录折叠所有历史会话
  5. 05

    解锁高阶功能

    下面这些都在应用内一键开启 — 不需要写命令,但你可以知道它在哪做了什么改动。

    启用刘海岛(Notch Island)

    在 Settings 里为每个 provider 切换 Notch Island 开关。应用会自动安装 hook,写入对应位置:

    • Claude → ~/.claude/settings.json 的 hooks 字段(PreToolUse、PostToolUse、Notification、Stop、PermissionRequest 等)
    • Codex → ~/.codex/hooks.json + ~/.codex/config.toml 中启用 [features] codex_hooks = true
    • Gemini → ~/.gemini/settings.json 的 hooks 字段(BeforeTool、AfterTool、Notification 等)
    全局快捷键

    默认 ⌃⌘S 唤起菜单栏面板。在 Settings → Shortcuts 改键。

    切换 CLI 账号

    Settings → Accounts。每个 provider 可以保存多个账号,一键切换激活身份 — 应用直接重写 CLI 读取的认证文件,下一次 claude / codex / gemini 调用就以新身份运行。

    安装插件

    Settings → Plugins → Discover。应用会从 claude-statistics-plugins 拉取目录,安装时校验 SHA-256 和 manifest id,然后热加载 provider、集成或订阅扩展。

    • Provider / Integrations / Subscription / Share Card / Utility 五类
    • Subscription 插件让第三方 endpoint piggy-back 在某个 provider 的 CLI 上,贡献配额、剩余时间推断、趋势图和模型定价
    • Installed tab 可更新、禁用、卸载和重置信任
    导出 Share Card

    菜单栏底部 Share 按钮 → 选择主题 → 导出 PNG。9 种角色和 11 个徽章基于你的真实使用模式自动派生。

  6. 06

    出问题怎么办

    Claude Statistics 自带诊断导出,可以一键把日志和最近事件打包发给 Issues。

    • Settings → Diagnostics → Export Diagnostics
    • GitHub Issues:https://github.com/sj719045032/claude-statistics/issues
    • 更新通过 Sparkle 在后台自动完成,每次启动检查
    提示 · 如果 Notch Island 不弹出,通常是 hook 没有装上,或者 Codex 的 codex_hooks feature 还是 false。可以用应用 Settings 重装。
继续探索

想看每个功能更深入的细节?

查看功能详情 → 更新日志