CC Usage

官网：https://haishishushu.github.io/cc-usage-website/

CC Usage

让 AI 用量，一眼看得见。

常驻桌面的灵动岛 + 完整统计主面板，集中查看 AI 编程工具的本机用量与服务商额度。

下载安装 · 在线文档 · 更新日志 · 反馈问题

简体中文 | English
文中的界面图片用于说明操作与布局，图中数值不代表你的真实用量。实际数据取决于本机留存记录、连接授权和服务商返回结果。

目录

- 核心功能
- 平台与额度支持
- 下载与安装
- 首次使用
- 日常操作
- 读懂统计数据
- 更新与数据保留
- 隐私与本地存储
- 常见问题
- 开发与构建
- 反馈与许可证
- Community 社区
- Star History

核心功能

本地统计与在线额度是两条独立链路：有本机会话不代表能查询账号额度；有账号额度也不代表本机留存了会话记录。

平台与额度支持

AI 工具平台

平台目录与能力以应用中的实际提示为准。Windows、macOS、Linux 均有构建目标，但第三方应用的数据目录和系统托盘行为存在差异，不能把某系统安装包可用等同于全部来源均已验证。

额度服务商

平台表示“使用哪个工具”，服务商表示“由谁提供额度”。例如，在 Claude 中使用 Kimi 编程套餐，工具平台仍是 Claude。

具体窗口以账户套餐和接口返回为准。未知、不支持或查询失败会显示相应状态，不应理解为“剩余为零”。

下载与安装

从官网下载页选择系统，也可以在 GitHub Releases 选择指定版本。

- macOS 芯片类型可在“关于本机”中确认。
- .sig 是更新签名，latest.json 是更新清单，都不是手动安装包。
- 每个版本拥有独立发行页，历史版本应从对应版本页下载。
- 如系统提示无法运行，先核对系统架构、下载来源和发行说明；Linux 还需满足相应桌面运行依赖。

首次使用

1. 启动应用

首次安装后，主面板自动居中打开；灵动岛先在屏幕上方居中展示约 5 秒，然后在允许吸附且未被主动展开等情况下贴向上边缘。

后续启动会恢复已保存的显示偏好和窗口位置。多次点击快捷方式会唤起已有实例，不会重复运行多个程序。

2. 准备数据来源

先在需要监控的 AI 工具中完成登录或配置，并实际产生一次会话。CC Usage 读取本机已有记录，不会凭空生成使用数据。

- 官方订阅：先在对应 CLI 中登录，然后读取本机授权。
- 本机 API 配置：先在 CC Switch 中配置并应用到对应平台，再由 CC Usage 读取 Key 和服务地址。
- 本机来源监控：先运行对应应用并产生记录，再检测来源；该操作不会切换外部应用账号。
- 手动 API 连接：仅在所选平台提供该入口时填写服务地址与 Key；按对话框说明确认支持范围。

3. 添加并检测连接

1. 打开主面板，进入 设置 → 连接管理。
2. 选择目标平台，点击添加连接，选择界面提供的连接类型。
3. 按提示读取本机配置或填写允许手动输入的信息。
4. 添加完成后，点击连接行中的 检测，查看可用状态及错误说明。
5. 对需要额外查询凭证的套餐，按对应设置项补充信息后重新检测。

检测成功说明当前连接或来源可访问；是否能显示 Token、额度或余额，仍取决于上方支持表。

4. 选择灵动岛连接

展开灵动岛，在连接切换入口选择需要展示的连接。该选择会保存到本地，软件重启或正常覆盖更新后继续读取。

如果原连接已被删除、断开或凭证失效，需要恢复原连接或重新选择；应用不会悄悄替换成同平台的其他账号。

5. 确认统计生效

在对应 AI 工具中再完成一次请求，回到主面板选择相同平台，查看今日统计与请求日志。若没有数据，先检查时间筛选、来源路径及记录是否已写入，再看常见问题。

日常操作

主面板：从总量到单条请求

1. 在顶部选择平台。
2. 选择今日、本周、本月、累计或自定义时间，并按需筛选模型。
3. 查看 Token 与缓存拆分，再沿趋势图定位使用高峰。
4. 在请求日志中查看具体记录，使用分页与跳转继续浏览。
5. 选中经本地代理使用过的 API Key…