個人開発で運用している壁紙アプリのレビューを書き出したフォルダを、三十分ごとに Claude に見てもらう定期実行を組んだのは、ある週の月曜でした。新しいレビューがあれば要約して、返信が必要なものに印を付けてもらいます。それだけの仕事のつもりでした。
木曜の夜、設定画面の使用量のバーが、ふだんの週よりずっと先まで伸びていることに気づきました。手元の会話はむしろ少なめだったので、胃のあたりが少し重くなったのを覚えております。ログを遡ると、新着が無い回でも毎回 Claude が起きて、フォルダを読み、「新しいレビューはありませんでした」と丁寧に報告していました。
最初にお伝えしたいのは、定期実行の費用は「AI が仕事をした回」ではなく「AI が起こされた回」で決まるということです。そして、起こす必要があるかどうかの判断は、たいてい AI でなくても下せます。
症状の見分け方 — 枠を食べているのは「確認だけの回」か
同じ時期に、claude-code リポジトリの Issue #110395 でも似た報告が上がっていました。デスクトップアプリの Claude Code に外部のエージェントサービス上の定期実行を組ませたところ、「新着メールは?」「プロセスは動いている?」といった単純な条件確認が、5〜10分ごとの AI 実行として作られていた、という内容です。報告者の記録では1日およそ580回、1回あたり約4万トークンで、週の枠が 3.83 日で尽き、その後に有料の超過分が発生したそうです。
私のケースと構造は同じでした。手元で次の三つを見ると、確認だけの回が枠を食べているかどうかを見分けられます。
| 見るところ | 確認だけの回が原因のとき | 別の原因が疑わしいとき |
|---|---|---|
| 定期実行のログ・履歴 | 「変化なし」「新着なし」で終わる回が大半 | 毎回それなりの成果物が出ている |
| 使用量の増え方 | 時間に比例して、夜間もほぼ一定の傾きで増える | 自分が会話している時間帯にだけ跳ねる |
| 1回の中身 | 同じファイルや画面を毎回まるごと読み直している | 回によって読む量が大きく違う |
自分が会話している時間に跳ねる場合は、定期実行より会話の長さを先に疑ったほうが早いです。その切り分けは「使用量の上限が昼前に尽きた日、原因は送った回数ではなく一通の会話の長さでした」に書き残しております。
1日の回数と1回の量を掛ける — ただし掛け算は下限です
組み直す前に、まず数を置きました。下のスクリプトは、実行間隔と1回あたりのトークン量から、1日の消費と「週の枠を何日で使い切るか」を出すだけのものです。標準ライブラリだけで動きます。
# estimate_recurring.py — 定期実行の消費を、組む前に見積もる
import argparse
def estimate(interval_min: float, tokens_per_run: int,
weekly_allowance: int, retry_factor: float = 1.0,
active_hours: float = 24.0) -> dict:
runs_per_day = active_hours * 60 / interval_min
tokens_per_day = runs_per_day * tokens_per_run * retry_factor
days_to_empty = weekly_allowance / tokens_per_day if tokens_per_day else float("inf")
return {
"runs_per_day": round(runs_per_day, 1),
"tokens_per_day": int(tokens_per_day),
"days_to_empty": round(days_to_empty, 2),
"fits_in_week": days_to_empty >= 7,
}
if __name__ == "__main__":
p = argparse.ArgumentParser()
p.add_argument("--interval-min", type=float, required=True)
p.add_argument("--tokens-per-run", type=int, required=True)
p.add_argument("--weekly", type=int, required=True, help="週の枠(トークン)")
p.add_argument("--retry-factor", type=float, default=1.0, help="失敗による再実行の倍率")
p.add_argument("--active-hours", type=float, default=24.0, help="1日のうち動かす時間")
a = p.parse_args()
r = estimate(a.interval_min, a.tokens_per_run, a.weekly, a.retry_factor, a.active_hours)
for k, v in r.items():
print(f"{k:>15}: {v}")Issue の数字を入れてみると、思っていたのと違う結果が出ました。
# 1日580回 ≒ 約2.5分間隔。1回4万トークン、週の枠 3億6,160万トークン
python3 estimate_recurring.py --interval-min 2.48 --tokens-per-run 40000 --weekly 361600000
# runs_per_day: 580.6
# tokens_per_day: 23225806
# days_to_empty: 15.57
# fits_in_week: True単純な掛け算では、使い切るまで15日半かかり、週の枠に収まるという判定になります。けれど実際には 3.83 日で尽きています。差はおよそ4倍で、報告の中にある「同じ失敗が39回続いたループ」のような再実行や、ほかの自動実行が上に乗ったのだと思います。
ここから引いた線引きは一つです。見積もりの掛け算は天井ではなく床です。 失敗時の再実行、読み込むファイルの増加、別の定期実行との重なりで、実際の消費は見積もりより上にしか振れません。私は --retry-factor 3 を入れても週に収まるかどうかを、組むかどうかの判断に使うようにしています。
AI を起こす前の条件確認を、AI の外に出す
レビューの定期実行で変えたのは、Claude を呼ぶ前に「新しいファイルがあるか」をシェルで確かめる一段を挟んだことだけです。新着が無ければ、AI は一度も起きずに終わります。
#!/bin/bash
# review_watch.sh — 新着があるときだけ Claude を起こす
set -u
DIR="$HOME/reviews/inbox" # レビューを書き出すフォルダ
STATE="$HOME/.review_watch"; mkdir -p "$STATE"
STAMP="$STATE/last_run" # 前回 AI を起こした時刻の印
[ -f "$STAMP" ] || touch -t 197001010000 "$STAMP"
# 1. 条件確認(AI を使わない)
NEW=$(find "$DIR" -type f -name '*.csv' -newer "$STAMP" | wc -l)
if [ "$NEW" -eq 0 ]; then
echo "$(date '+%F %T') no new files — skip" >> "$STATE/log.txt"
exit 0
fi
# 2. 新着があるときだけ、その差分だけを渡して AI を起こす
FILES=$(find "$DIR" -type f -name '*.csv' -newer "$STAMP" | sort)
touch "$STAMP"
claude -p "次のファイルにある新しいレビューだけを要約し、返信が必要なものに印を付けてください: $FILES" \
>> "$STATE/summary.txt"なぜこう書くかというと、「何か変わったか」は機械で答えが決まる問いだからです。更新時刻の比較、HTTP のステータス、プロセスの有無、件数の増減——こうした判定に AI の文章力は要りません。AI に渡すのは、判定を通過した「変わった分」だけにしています。
もう一つの工夫は、AI に渡すのを差分のファイルに絞ったことです。以前は毎回フォルダ全体を読ませていたので、レビューが溜まるほど1回の量も増えていました。回数を減らすだけでなく、1回の量が時間とともに太らない形にしておくと、見積もりが崩れにくくなります。
失敗が続いたら止めるブレーキと、1日の回数の上限
条件確認を外に出しても、AI を起こした回が失敗し続ければ消費は膨らみます。Issue の39回連続の失敗ループは、まさにこの穴でした。上のスクリプトの末尾を、次のように差し替えています。
# review_watch.sh の後半(2. の部分を置き換え)
FAIL="$STATE/fail_count"; DAY="$STATE/runs_$(date +%F)"
MAX_FAIL=3; MAX_RUNS_PER_DAY=12
[ -f "$STATE/STOP" ] && { echo "$(date '+%F %T') STOP file present" >> "$STATE/log.txt"; exit 0; }
RUNS=$(cat "$DAY" 2>/dev/null || echo 0)
if [ "$RUNS" -ge "$MAX_RUNS_PER_DAY" ]; then
echo "$(date '+%F %T') daily cap reached ($RUNS)" >> "$STATE/log.txt"; exit 0
fi
echo $((RUNS + 1)) > "$DAY"
FILES=$(find "$DIR" -type f -name '*.csv' -newer "$STAMP" | sort)
if claude -p "次のファイルにある新しいレビューだけを要約してください: $FILES" >> "$STATE/summary.txt"; then
touch "$STAMP"; echo 0 > "$FAIL"
else
N=$(( $(cat "$FAIL" 2>/dev/null || echo 0) + 1 )); echo "$N" > "$FAIL"
if [ "$N" -ge "$MAX_FAIL" ]; then
touch "$STATE/STOP" # 人が原因を見て消すまで、二度と AI を起こさない
echo "$(date '+%F %T') stopped after $N failures" >> "$STATE/log.txt"
fi
fiポイントは三つです。失敗した回は印(last_run)を進めないので、次の回で同じ差分をやり直せます。3回続けて失敗したら STOP ファイルを置き、人が消すまで止まります。そして1日の回数に上限を置くことで、どんな想定外があっても、その日の消費には天井ができます。
止めたことに気づけなければ、止めた意味は半分になります。私は log.txt の最終行を朝いちばんに一度だけ見る、という習慣にしています。通知を増やすより、見る場所を一つに決めておくほうが、私の場合は続きました。
Claude に定期実行を頼むとき、先に渡している3つの問い
コードを書かない方が、Claude に「毎朝これをやっておいて」と頼む場面も増えていると思います。その場合でも、組ませる前に次の三つを答えてもらうだけで、ずいぶん事故が減りました。
- 1日に何回動きますか。そのうち、AI が文章を書く必要がある回は何回ですか
- 1回あたり、どれくらいのファイルや画面を読みますか。それは日を追って増えますか
- 失敗が続いたとき、何回で止まりますか。止まったことを、私はどこで知りますか
三つ目の問いに答えが無い組み方は、いまは引き受けないことにしています。Claude は頼まれた仕事を誠実にこなそうとしますが、「やらないで済む回」を自分から提案してくれるとは限らないのです。
すでに枠を使い切ってしまったときの次の一手
もし週の途中で枠が尽きてしまったら、原因を調べる前に、まず定期実行を止めてください。止めないまま調べていると、そのあいだにも消費が進みます。
- 定期実行を一時停止します(スケジュールの設定画面、または
crontab -eで該当行をコメントアウト) - 設定画面の使用量で、増え方の傾きが止まったことを確かめます
- 追加の利用(上限を超えた分を有料で使う設定)を有効にしている場合は、有効かどうかと月の上限額を確かめます。表示名はプランや時期で変わることがあります
- ログで「確認だけの回」の割合を数え、上の見積もりスクリプトに実際の回数を入れ直します
API キーで定期実行を回していて、金額の天井を仕組みとして持ちたい方には、日次のトークン超過を検知して止める設計を「Claude API の本番運用で予算上限を確実に守る」で詳しく扱っています。ここで書いた STOP ファイルの考え方を、もう一段しっかりした形にしたものです。
まずは、いま動いている定期実行を一つ選んで、その1日の回数と1回の量を見積もりスクリプトに入れてみていただければと思います。「AI が起こされた回」と「AI が要った回」の差が、そのまま削れる余白です。