用量和额度
Agent 用了多少 token、按 API 价格大约值多少钱、离套餐限额还有多远,以及提示缓存还剩多久。
点侧边栏里的用量。这一页按天、模型和项目汇总所有 Agent 的用量。
页面上有什么
顶部这一行决定统计什么:
| 控件 | 选项 |
|---|---|
| 统计指标 | Token、请求数(统计来源为仅 Kettu 时是轮数)、费用 |
| Agent | 全部,或其中一个 Agent;有两个以上 Agent 有用量时出现 |
| 统计来源 | 本机或仅 Kettu;开启统计本机用量后出现 |
| 时间范围 | 今天、7 天、30 天、90 天、一年、全部时间,或自定义 |
自定义打开日期选择器,带本周、上个月等快捷选项。
下面依次是:
- 数据概览:总 token、估算费用、每次请求 token、缓存节省、日均和用量最多的一天。
- 按天、周或月的趋势图;选今天时按小时显示。
- 活动:近 53 周每天的 token 用量。
- Token 构成:输入、输出、推理、缓存读取和缓存写入。
- 按模型和按项目。
- 套餐限额。
费用按 API 价格估算,页面上注明价格的日期。没有价格的模型不计入费用,页面会写明有多少 token 没算进去。
数字从哪里来
装好 Kettu 之后,它会记下自己运行的每一轮对话的 token,这就是 Kettu 的记录。
要算上安装 Kettu 之前和在终端里的使用,在设置 › 用量里打开统计本机用量,或者在空白的用量页上点统计本机用量。之后 Kettu 还会读取 Claude Code、Codex 和 OpenCode 在这台电脑上的日志。它只读 token 数、模型和时间,不读对话内容,数据也不离开这台电脑。日志每 10 分钟重新读一次,点立即同步马上读。
设置 › 用量里还有:
- 每个 Agent 的日志状态,点**重新导入…**从头再读一遍。
- 侧边栏显示:侧边栏“用量”那一行末尾显示什么,可选今日 token、今日估算费用、最紧的套餐限额或不显示。
- 清除 Kettu 的记录:删除 Kettu 自己记下的 token。Agent 的日志以及从中导入的数据不受影响。
套餐限额
Agent 报告了你套餐的限额时,比如 Claude Code 和 Codex,套餐限额会列出每个账号的各个窗口,比如5 小时和每周,以及已用多少、何时重置。不提供限额的 Agent 列在面板下方。每次打开这一页,Kettu 都会重新读取限额。
Agent 接近其中某个限额时,例程会暂停。
提示缓存倒计时
两轮对话之间,会话的顶栏会显示提示缓存(prompt cache)还剩多久,比如缓存 4 分钟。点它能看到缓存的时长、上次请求的时间,以及缓存过期后下一条消息大约要按全价重新读取多少 token。
缓存的最后一分钟(一小时的缓存是最后五分钟),倒计时变成警示色,侧边栏里这个会话的那一行也会出现一个圆环。
Claude Code 自己的会话记录里写着缓存时长,所以它的倒计时是准确的。其他使用 Anthropic 或 OpenAI 模型的 Agent,Kettu 按服务商文档里最短的保留时间估算,倒计时会显示成缓存约 4 分钟。两者都不知道时,顶栏显示未报告缓存时间。