Cachebeat

Cachebeat 是一个单文件 Claude Code 技能，用空闲心跳避免长会话丢掉 Anthropic 的 prompt cache。仓库 ARahim3/cachebeat 创建于 2026-09-14。2026-09-16 GitHub 显示 5 star、0 fork。README 自称 MIT；当天 GitHub API 没有 SPDX 许可证文件，许可以 README 为准，不是 API 确认。它出现在 r/ClaudeAI，有人离开一会儿再回来，5 小时窗口和周额度被一口吃掉。

README 写 Anthropic 缓存读取按输入价的 0.1x 计。冷启动会把整段历史按全价再送一遍。Pro/Max 上同一套记账还会消耗 5 小时窗口和周配额。5 star 是热度信号，不是访问量。

若要宿主本身，对照 Claude Code；若要用量看板，对照 ccusage；若要更宽的工程技能包，对照 Agent Skills。

核心功能

• 空闲计时器，不是节拍器：/cachebeat 只开一个后台监视。任何真实回合都会重置时钟。真正静默 N 分钟才打一次，Claude 回几个字，TTL 重新开始。
• 默认：空闲 50 分钟，8 小时后自动停。/cachebeat 40 改阈值（夹在 5–55）。/cachebeat 40 4 再加 4 小时截止。/cachebeat stop 关掉。
• 安装：把 SKILL.md 拷到 ~/.claude/skills/cachebeat/（用户级）或 <项目>/.claude/skills/cachebeat/。没有额外二进制。
• 核对：token 行类似 tok:312.0k/0.0k（总量 / 来自缓存）。热返回时第二个数字应该很大。README 也教你在会话 jsonl 里比 cache_read_input_tokens 和 cache_creation_input_tokens。
• 自检：CACHEBEAT_WARN 表示心跳自己也没打中缓存，TTL 太短，桥不过去。CACHEBEAT_EXPIRED 结束监视。

限制：只对 长 TTL（1 小时） 会话有用。5 分钟 TTL 桥不过。每次心跳仍有一点缓存读取和几个输出 token，这些行会留在后续上下文。原生 Windows（非 WSL）未测。技能通过 $CLAUDE_CODE_SESSION_ID 读 ~/.claude/projects/<slug>/<session-id>.jsonl，这是内部布局，不是公开 API。

适用场景

• 很长的 Claude Code 会话：盯训练、CI、下载，人要睡觉。
• Pro/Max 用户：空闲后再回一句「还好吗」，5 小时窗口被咬掉一块。
• 不该用的人：你不回来。8 小时截止就是防止废弃会话一直滴费用。

定价方案

快速开始

1. mkdir -p ~/.claude/skills/cachebeat，把 SKILL.md 拷进去。
2. 在长 TTL 的 Claude Code 会话里输入 /cachebeat。
3. 离开。回来时看 token 行的缓存一侧不是 0.0k。
4. 不回来就 /cachebeat stop。

第一方资源：README 和 SKILL.md。

常见问题

能替代 Claude Code 吗？

不能。它是 Claude Code 里的技能。账单仍是你的套餐。

为什么是 50 分钟，不是每 5 分钟？

空闲阈值必须低于 TTL。50 分钟给 1 小时缓存留大约 10 分钟余量。打太勤浪费 token，打太晚会冷启动。

5 分钟 TTL 有用吗？

README 说没有实用心跳能桥过去。账单仍全价就停掉。

替代方案

• Claude Code：宿主。没有它这个技能什么都不做。
• ccusage：用量图，不是缓存保活。
• OpenCode Skills：给 OpenCode 的 SKILL.md，不是 Claude Code 缓存。

使用技巧

1. 只在你会重新打开的会话上开。8 小时停止是保险，不是让它永远挂着。
2. 看到 CACHEBEAT_WARN 就停。TTL 太短。
3. 心跳回复只留几个字。多出来的 token 后面每一轮都会再读。

总结

Cachebeat 是对长 Claude Code 会话「空闲税」的小修补。拷一个文件，输入 /cachebeat，回来时缓存还是热的。会话很短、TTL 只有 5 分钟、或者根本不回来，就别开。