CASE · 中程度 · monitoring-gap
未検証の報告公開情報からの収集定時実行のClaude Codeが2.5日何もしなかったのに、GitHub Actionsはずっと緑だった(未検証の報告)
4時間ごとにClaude Codeでブログ記事を書き直すGitHub Actionsのジョブが、9月18日の夜から21日の朝までの2.5日、何も生み出さなかった。そのあいだの実行はすべて緑で、記録の残る9月20〜21日の8回は、どれも使用上限ですぐに終わっていた。
約3分で読めます
- 発生日
- 分類
- monitoring-gap
- 影響範囲
- uptime
- 検知
- manual-observation
- タグ
- #claude-code #github-actions #usage-limit #exit-code #silent-failure #watchdog
CH 1
原因
週の利用上限に達し、Claudeは上限を知らせる1行だけを返していた。コマンドの末尾が || true、pipefail も無効で、パイプライン全体の結果は tee のものになり、通知は赤のときしか出なかった。止まった実行を知らせるはずの見張り役も、同じ上限を使うClaudeで動いていたため、仕事と見張りが一緒に止まった。
CH 2
結果
2026年9月18日から21日まで、記事は1本も書き直されなかった。筆者は9月21日、別件の調べものの途中で状態ファイルを開き、上限による停止が8件並んでいるのを見つけて気づいた。9月20日には、Claudeを使うほかのジョブ2本も上限に当たって失敗していた。
CH 3
対策
筆者が実際に直したのは3点。見張り役の起動を2時間ごとから6時間ごとにするなどして週77回分の起動を削った。止まった理由を、Claudeを使わない毎朝の集計にも出すようにした。「印を残した」と「印が人に届いた」を分けて考えるようにした。記事ではさらに、判定をシェルからPythonへ出してテストできるようにする、出力が出たかを数える、「0件」と「確かめられなかった」を分ける、通知は素の curl で送る、といった対策を勧めている。ただし筆者自身の仕組みは、判定がまだYAMLの中のgrepのままだという。
何が起きたか
あるフリーランスのエンジニアが、Claude Codeを定時で動かしていた。自前のランナーの上でGitHub Actionsが4時間ごとに claude -p を呼び、検索順位を上げるためにブログ記事を書き直す仕組みである。
2026年9月18日の夜から21日の朝まで、このジョブは何も変えなかった。実行はすべて緑で、かかった時間は毎回25秒ほどだった。ふだんは数十分かかる仕事である。
現場の混乱
誰にも知らせは来なかった。失敗の通知は、赤になったときにしか出ない。9月21日、筆者は別件の調べものの途中で、止まった理由を書き残すJSONファイルを開き、9月20〜21日の8回がどれも使用上限で終わっていたのを見つけた。9月20日には、Claudeを使うほかの2本(週次の編集会議と経営レビューのジョブ)も上限に当たって失敗していた。
原因
週の利用上限が尽きて、Claudeはどの呼び出しにも、そのことを告げる1行だけを返していた。それを緑に変えたのは、3つの習慣だった。コマンドの末尾の || true が終了コードを捨てていた。シェルで pipefail を設定していなかったので、パイプラインの結果は成功する tee のものになった。そして通知は、赤になったときにしか出なかった。
まさにこれを捕まえるための見張り役もあった。状態ファイルを読んで問題を報告する仕組みである。ところがこれもClaudeを使い、同じ週の上限を分け合っていたので、見張る相手と同じ瞬間に黙ってしまった。
対策
筆者が実際に直したのは3点だった。見張り役の起動を2時間ごとから6時間ごとにするなど、判断の要らない起動を週77回分削った。止まった理由を、Claudeを使わない毎朝の集計(Pythonだけで動く)にも出すようにした。そして「印を残した」ことと「印が人に届いた」ことを分けて考えるようにした。
記事ではさらに、自分のワークフローに足せる対策を勧めている。成功・失敗の判定はシェルからPythonへ出し、実際のエラーメッセージでテストする。出力が出たかを数え、「0件だった」と「確かめられなかった」を分けて報告する。
通知は素の curl で送り、上限の問題が、上限の問題を知らせる警報まで止めないようにする。ただし筆者は、自分の仕組みの判定はまだYAMLの中のgrepのままだと正直に書いている。
同じ教訓は以前のエントリにも出てくる。緑のチェックは、プロセスがきれいに終わったことしか意味せず、仕事がなされたことまでは意味しない。そして、見張る相手と同じ理由で止まる見張りは、見張りにならない。
出典
この記録をチームに回す