Cachebeat

Cachebeat は、長いセッションが Anthropic の prompt cache を落とさないよう、無操作ハートビートを仕込む 1 ファイルの Claude Code スキルです。リポジトリ ARahim3/cachebeat の作成日は 2026-09-14。2026-09-16 の GitHub は 5 stars、0 forks。README は MIT と書いていますが、その日の GitHub API に SPDX ライセンスファイルは無く、ライセンスは README 記載であり API 確認ではありません。r/ClaudeAI では、席を外して戻ったあとに 5 時間枠と週次上限を削られた投稿の中で出てきました。

README はキャッシュ読みを入力単価の 0.1x としています。冷えた復帰は履歴全体を通常入力で再送します。Pro/Max では同じ計算が 5 時間枠と週次クォータも削ります。5 stars は熱量の信号であり、トラフィックではありません。

ホスト本体なら Claude Code、利用量ダッシュボードなら ccusage、広いエンジニアリングパックなら Agent Skills を見てください。

主な機能

• メトロノームではなく無操作タイマー：/cachebeat は監視を 1 本だけ。本物のターンで時計はリセット。本当に N 分静かになってから発火し、Claude が数語返し、TTL が延びる。
• 既定：アイドル 50 分、8 時間で自動停止。/cachebeat 40 は閾値（5–55 にクランプ）。/cachebeat 40 4 は 4 時間期限も。/cachebeat stop で停止。
• 導入：SKILL.md を ~/.claude/skills/cachebeat/（ユーザ）か <project>/.claude/skills/cachebeat/ にコピー。追加バイナリなし。
• 確認：トークン行は tok:312.0k/0.0k（合計 / キャッシュ由来）。温かい復帰なら後者が大きい。README は jsonl の cache_read_input_tokens と cache_creation_input_tokens の見方も書く。
• 自己診断：CACHEBEAT_WARN はビート自体が未キャッシュ。TTL が短すぎて橋を架けられない。CACHEBEAT_EXPIRED で監視終了。

制限：長い TTL（1 時間） のセッションにしか効かない。5 分 TTL は橋を架けられない。ビートごとに小さなキャッシュ読みと数トークンの出力が付き、その行は後の文脈に残る。ネイティブ 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. 席を外す。戻ったらトークン行のキャッシュ側が 0.0k でないことを見る。
4. 戻らないなら /cachebeat stop。

一次情報：README と SKILL.md。

よくある質問

Claude Code の代わりになりますか？

なりません。Claude Code 内のスキルです。請求はプランのまま。

なぜ 50 分で、5 分おきではないのですか？

閾値は TTL より短くする。50 分は 1 時間キャッシュに約 10 分の余裕。頻繁すぎるとトークン無駄、遅すぎると未キャッシュ。

5 分 TTL に効きますか？

README は実用的なハートビートでは橋を架けられないとします。請求が全額のままなら止める。

代替案

• Claude Code：ホスト。無ければ何もしない。
• ccusage：利用量チャート。キャッシュ維持ではない。
• OpenCode Skills：OpenCode 向け SKILL.md。Claude Code のキャッシュではない。

ヒント

1. 開き直すセッションだけ武装する。8 時間停止は安全弁。
2. CACHEBEAT_WARN を見たら止める。TTL が短い。
3. 返信は数語。余分なトークンは以後の毎ターンで再読される。

まとめ

Cachebeat は長い Claude Code セッションのアイドル税への小さな修正です。ファイルを 1 つコピーし /cachebeat と打てば、戻ったときにキャッシュは温かい。短いセッション、5 分 TTL、戻る予定がないなら使わない。