
定期実行は7日のうち4日、黙って止まっていた
定期実行が止まったとき、画面には何も出ない。エラーダイアログも、赤い通知も無い。ただ、いつも増えているはずの記録が、増えていないだけだ。
私は自分の環境で、この「何も起きない失敗」に、1週間のうち4日当たった。原因は2つで、まったく別の所から来ていた。調べるうちに、もう1つ別の沈黙の型も見つかった。

緑だったのは7日のうち3日だけだった

私は毎朝9時に、あるコマンドラインツールのCHANGELOG(変更履歴)の差分を自動で要約させ、自分のメモに追記するだけの小さなジョブを動かしている。判断の要らない仕事で、動かし方自体はすぐに組めた。
問題は、組んだ後だった。
2026年9月5日から11日までの7日間、このジョブが記録したログを後から数え直した。緑(成功)だったのは3日だけ。残る4日のうち3日は同じ形で失敗し、1日は実行された形跡そのものが無かった。
毎朝決まった時刻に走らせているつもりでも、実際に届いた日数は半分にも届いていなかった。
失敗した理由はログに書かれていなかった
まず気づいたのは、3日連続で同じ形の行が残っていたことだった。
[2026-09-05 09:00:04] ❌ 要約失敗(状態は据え置き、次回リトライ): claude -p が失敗 (rc=1):
[2026-09-06 09:00:04] ❌ 要約失敗(状態は据え置き、次回リトライ): claude -p が失敗 (rc=1):
[2026-09-07 09:00:06] ❌ 要約失敗(状態は据え置き、次回リトライ): claude -p が失敗 (rc=1): rc=1(コマンドが異常終了したことを示す終了コード)は分かる。問題はコロンの後ろだ。本来ならエラーメッセージが入る場所が、3日とも空だった。
ここで起きた事故: 空欄からは何も絞り込めなかった
ネットワークが切れたのか、差分の取得に失敗したのか、要約の中身がおかしかったのか。この行だけでは、可能性を一つも消せない。
エラーメッセージが空だと、次に何を確認すればいいかすら決められない。これが一番厄介な形の失敗だった。
ログ設計そのものは正しく働いていた。失敗したときは状態を進めず、翌朝また同じ差分から再挑戦する作りにしてあったので、9月8日の成功時には5日・6日・7日ぶんの差分もまとめて拾えていた。実害は出なかった。だが「なぜ落ちたか」は、ログを読むだけでは最後まで分からなかった。
同じログをAIに見せても、私と同じところで止まった
このジョブを作ったエージェント(この記事でのAIの呼び方)に、同じログを見せて原因を聞いた。返ってきたのは「エラーメッセージが空なので、この行だけでは特定できない」という、私と同じ結論だった。
ログという間接的な記録しか残っていない場面では、聞く相手を変えても答えは増えない。情報が無いのだから当然で、ここで粘っても時間を捨てるだけだった。
手で1回叩き直したら、空欄だった原因が言葉になって出てきた
手がかりが無いなら、同じ壊れ方をもう一度自分で起こすしかない。
「echo test | claude -p; echo $?」と単体で叩いて再現させると、今度は空ではなく、はっきりしたメッセージが返ってきた。「Failed to authenticate: OAuth session expired and could not be refreshed」。ローカルのCLI自体が持つ認証セッション(いま使っている対話画面とは別に、CLI側が独立に持っている認証情報)が切れていた、という中身だった。
スクリプト経由の実行では、このメッセージがログに残らず、空欄として消えていた。単体で直接叩いたときだけ、同じ失敗が言葉を伴って出てきた。
この再現結果を見せて初めて、原因を絞り込めた。ログを何度眺めても出なかった答えが、1回叩き直しただけで出た。なお認証のログインそのものは自分の手でやっている。認証情報を通す操作は任せない、と決めている。
対処そのものは単純だった。同じ「rc=1・エラー空」が続けて出たら、まず単体で1回叩いてrcとメッセージを見る。原因が認証切れだと分かれば、直すのは自分の手でログインし直すだけで済む。
本当に止まっていた日は、ログに1行も残っていなかった
3日分の原因が分かって落ち着いた頃、7日間の中にもう一つ違う穴があることに気づいた。9月11日は、ログに成功も失敗も、行そのものが無かった。
最初に疑ったのは、その時間にMacが眠っていたということだった。時刻どおりに起きていなければ、定期実行の仕組み自体が動かないのは自然に思えたからだ。
ここから先は「登録」「ロード」という言葉が続く。macOSで定期実行を組む仕組みが何をしていて、どこに何を書き出しているのかを先に並べておく。

だが実際に「ジョブが登録されているか」を確認するコマンドを叩くと、答えは違った。定期実行の仕組みに登録していた自分のジョブが、まるごとアンロードされていた。ログを残す私のジョブだけでなく、他の自動化ジョブも一緒に止まっていた。
原因は、まったく別の作業だった。株の自動売買を試している別の仕組みで、次の判定日まで通知がうるさいのを止めたい、という理由から、定期実行の仕組みをまとめて止める操作を行っていた。そのとき、無関係だったはずのCHANGELOG要約ジョブも巻き添えで一緒に止まっていた。
設定ファイル自体は消えていなかった。登録は残ったまま、動く状態(ロード)だけが外れていた。だから「設定は合っているのに動かない」という、確認しづらい壊れ方になっていた。
ログはジョブが実行されて初めて書かれる。ジョブそのものが動いていなければ、ログには何も残らない。当たり前のことだが、ログを見る側からは「今日は何も無かったから平和だ」と「今日はそもそも動いていない」の区別がつかない。
同じ沈黙が、別々の理由から出ていた
ここまでの2つを並べると、面白いことが見えてくる。

「ログから何が起きたか分からない」という同じ症状が、3日間は認証切れ、1日は仕組み自体の停止という、まったく別の原因から出ていた。原因を1つ潰しても、残りの原因は消えない。
私はこれを最初、別々の小さな失敗談だと思っていた。束ねてみて初めて、「無人実行の失敗はエラー画面ではなく沈黙で来る」こと自体が一つの構造だと分かった。
もう一つ、自分では踏んでいないが見過ごせない実例がある。定期実行の仕組みとして広く使われているcron(あらかじめ決めた時刻にコマンドを実行させる、古くからある仕組み)には、失敗した処理の内容を宛先のメールで知らせる、という既定の通知経路がある。
ところがmacOSのある時期以降、cronの動く場所が普段使っているユーザーの画面から切り離され、このメール通知が届かなくなっているという報告を見つけた。これは私自身で検証した事実ではなく、外部の実例を読んだだけの情報として書いておく。バージョンの特定までは確認していない。
もしこの報告のとおりだとすると、cronを使っている人にとっては、通知の仕組みそのものが黙って失われている可能性がある。私が踏んだ認証切れや仕組みの停止よりも、もう一段静かな壊れ方だ。
3つの型に共通しているのは、どれも「実行の頻度を変えても直らない」ということだった。週1回にしても、認証は切れるときに切れるし、仕組みが止められればやはり動かない。
「動かし方」の記事は多いが、「動いていたのに止まった」を書いた記事はほとんど無かった
この経験を書く前に、他の人がどこで同じことに困っているかを見てみた。
定期実行の仕組みについて検索で相談されている内容の多くは、そもそも動かせない、という設定段階の困りごとだった。「実行時にエラーが出る」「権限のエラーが出る」「決めた時刻に走らない」「決まったアドレスに通知が届くようにしたい」。動かすところまでは、調べれば情報が出てくる。
一方で、「一度は動いていたのに、いつの間にか止まっていた」という運用段階の話を扱った日本語の記事は、私が見た範囲ではほとんど見つからなかった。見つかった中では、あるOS環境の変更でcronが実質使えなくなっていたという実例の記事と、同じ仕組みを長時間動かして踏んだ落とし穴を数え上げた記事の、2本くらいだった。
投稿サービスで検索してみても、「定期実行 気づかない」という言葉で見つかる直近30日の投稿は14件、読者の反応の中央値は2件分。「launchd cron 気づかない」ではさらに少なく、直近30日12件で反応の中央値は1件分だった。
数がそもそも少ないうえ、反応も小さい。設定記事は多いが、運用記事は薄い。今困っている人が少ないのではなく、困った経験を書いている人が少ないのだと思う。
自分の定期実行が今も動いているか、こう確かめている
ここからは、私の環境の話ではなく、読者が自分の環境でできる形で書く。
まず、ログの中身だけを見て安心しない。ログは「実行された結果」しか書けない。実行されたかどうかそのものは、登録したジョブの一覧を出すコマンドで見る。macOSのlaunchdならlaunchctl list、cronならcrontab -lだ。登録は残っているのに動く状態から外れている、という壊れ方は、ログには絶対に出てこない。
次に、「エラーメッセージが空」という記録に出会ったら、そのまま諦めない。裏で呼んでいるコマンドを、スケジュールを介さずに手元で単体で叩き直す。私の場合はそれだけで、空欄の裏にあった本当のメッセージが出てきた。
そして、認証やログインの状態は、対話で使っている画面と無人実行の裏側とで別物だと考えておく。対話中は調子よく動いていても、裏側の認証だけが独立に切れることがある。これは気づいた本人が入り直すべき操作で、自動化の側に肩代わりさせない方がいい。
もう一つ、別の作業のついでに定期実行の仕組みごと止めてしまう、という巻き添え事故は、自分で心当たりを作らない限り防ぎようがない。だからこそ、「動いているはず」を過信せず、たまに登録状態を見に行く習慣が要る。
最後に、ログに頼るだけでは「動いてすらいない」日を見つけられないと分かった以上、外に向けて合図を出す仕組みを検討する価値はある。ジョブが動くたびに外部の死活監視サービスへ合図を送り、その合図が届かなくなったら知らせてもらう、という仕組みだ。ログが「失敗を記録する」ためのものだとすれば、こちらは「動いたこと自体を証明する」ためのものになる。
cronで組んでいる人は、仕組みそのものが少し違う。書いた1行が、出力の行き先まで決めている。

cronを使っている人であれば、既定の通知に頼らず、実際に自分の環境で通知が届くかどうかを一度手元で確かめておくといい。届かない前提で、外部への合図に切り替える判断も選べる。
怖いのはエラー画面ではなく、何も起きていないように見える日だ
無人実行を組むこと自体は難しくない。難しいのは、動き始めた後も本当に届いているかを疑い続けることだ。
私が7日間で見たのは、緑3日、同じ形の失敗3日、そして行そのものが無い1日だった。原因は認証切れと仕組みの巻き添え停止という、まったく別の2つ。そこに、私自身は踏んでいないもう一つの実例(cronの通知経路の喪失)を重ねると、同じ沈黙が少なくとも3種類の顔を持つことが分かる。
エラー画面が出る失敗は、まだ親切だ。何が起きたか教えてくれる。本当に怖いのは、何も起きていないように見える日の方だ。
すでに定期実行を組んでいる人がいたら、一度でいいから、ログの中身ではなく「登録した状態そのもの」を見に行ってほしい。動いているつもりのまま止まっている日は、思っているより多い。
【PR】Amazonのオーディオブック【Audible】
通勤や家事の時間に、本やポッドキャストを耳で聴けるサービスです。いまはプライム会員向けに、最初の4か月が月額99円になるキャンペーンが出ています(2026年10月19日まで)。適用条件と料金は公式ページで確認してください。
【PR】AIエージェントの作り方を学べる本
この記事の多くはClaude Codeを使ったAIエージェント開発の中から生まれています。仕組みから学びたい方はこちらもどうぞ。
【PR】noteでの発信を学べる本
この記事もnoteで書いています。noteでの発信の仕方はこちらの本を参考にしています。
※Amazonのアソシエイトとして、当サイトは適格販売により収入を得ています(広告)