1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claude Code無人実行29日——毎朝確認する3か所(2026年)

1
Posted at

この記事の結論:Claude Codeの夜間自動実行を29日間続けた。「実行完了」の通知が届いても、翌朝必ず確認すべき3か所がある。確認を怠った日に限って、2日間止まったままだったことが後から発覚した。

対象読者

Claude Codeを夜間バッチとして動かしており、「本当に動いているか」が不安な人。もしくは、無人実行を始めたばかりで何をどう確認すればいいか手探りの人を想定している。タスクスケジューラ(WindowsまたはLinux cron)からClaudeを呼ぶ構成で、毎晩決まった作業を自動化している人が一番参考にしやすいと思う。

1か所目——実行されたか(2026年)

夜間自動実行の最初の確認は「そもそも昨晩の実行が始まったか」だ。

これは当たり前に聞こえる。ただ、止まり方によって「実行が始まらなかった」「実行が始まったが途中で止まった」の2パターンがあり、どちらも「正常終了」の通知は来ない。ログの残り方が違うので、区別できると後の対処が速くなる。

確認に使っているのは capacity-log.jsonl だ。各実行セッションの開始時刻・ターン数・コストが1行ずつ追記される。

tail -n 5 capacity-log.jsonl

出力例(1行がJSON):

{"timestamp":"2026-11-11T01:03:12.000Z","session":"tsubumi-前半","turns":97,"costUSD":4.52}
{"timestamp":"2026-11-11T03:15:40.000Z","session":"tsubumi-後半","turns":44,"costUSD":2.03}

昨晩の実行があるか、タイムスタンプを見るだけでいい。深夜1時前後に「前半」、深夜3時前後に「後半」がある構成なら、両方のエントリが今日の日付で入っているかを確認する。

片方しかない日、あるいはどちらもない日は、翌朝の通知(後述の morning-digest.mjs)でアラートが出る。

29日間で実際にあった止まり方のパターン:

  • 利用上限(Claude Pro):Pro プランの1日あたり利用枠に達し、セッションが強制終了する。この場合、途中までのログは capacity-log.jsonl に残っているがターン数が少ない
  • スクリプトエラー:node append-pool-row-qiita.mjs などの呼び出しでエラーが出て止まる。Claude は「エラーが出た」と認識して止まるので、エラーより前のログは残っている
  • タスクスケジューラの登録漏れ:前半タスクは動いているが後半タスクを登録し忘れていた。ログに前半しかないがエラーではないので通知が来ない

3番目が一番気づきにくい。7日目に後半タスクの登録漏れが判明したときは、すでに7日間、後半の作業が動いていなかった。ブログの在庫が補充されていなかったことで気づいた。

2か所目——意図した内容になっているか

実行されていたとしても、「何をやったか」の中身が合っていない場合がある。

確認に使っているのは weekly-reports/daily-log.md だ。毎回の実行の最後に、担当(野手さん・つぶみ・ここな)が実行内容を書き込む。内容が無い、または途中で途切れているなら、そこで止まったことが分かる。

grep -n "^### " weekly-reports/daily-log.md | tail -n 5

これで最新の見出しが確認できる。見出しが「(前半)」で終わっており「(後半)」が無ければ、後半が動いていない。

ただし daily-log.md は30万字を超えているので、全体を読もうとすると容量を消費する。見出しだけgrepして末尾を確認するのが実用的だ。

29日間で実際にあった「通知はなかったが、中身が違った」パターン:

パターン1:Threadsへの投稿が「pending のまま」なのに「投稿しました」と書かれていた

投稿スクリプトのタイムアウトを daily-log の記録タイミングと合わせていなかったため、タイムアウト後に「投稿した」という記録だけ残っていた。実際には投稿キューに入ったままで、次の投稿スケジュール(12:10)まで出なかった。

パターン2:Qiitaのプール補充を「2本追加した」と書いているが、実際には0本だった

品質チェック(append-pool-row-qiita.mjs)で弾かれた記事が gate-rejects.jsonl に記録されていた。弾かれた旨が daily-log に書かれておらず、「2本書こうとした」と「2本追加した」が混同されていた。

パターン3:前半のみ動いて後半が無かった日が2日続いた

これが「2日間止まっても気づかなかった」の正体だ。前半(Qiita補充)だけ動いていたのでログには記録があり、異常の通知が来なかった。後半(ブログ補充・Threads)が全く動いていなかった。

daily-log の見出し確認で「(前半)」しかない日が2日続いていたことが、3日後に判明した。

3か所目——コストが予想の範囲内か

3つ目の確認は、コストだ。正確には「ターン数が予想の範囲内か」になる。

夜間実行1回あたりのターン数が、ベースラインから大きく外れていないかを見る。

ベースラインの測り方

2026年9月25日の実測で、前半セッションが 113ターンで$5.27相当 だった。これを「普通の前半1回」の基準にしている。前半・後半・追加の3セッション合計で、1晩あたり150〜250ターンが目安だ。

確認は capacity-log.jsonl の最新数行を見るだけでいい:

tail -n 3 capacity-log.jsonl | node -e "
const lines = require('fs').readFileSync('/dev/stdin','utf8').trim().split('\n');
let total = 0;
lines.forEach(l => {
  const d = JSON.parse(l);
  total += (d.turns || 0);
  console.log(d.session, ':', d.turns, 'ターン');
});
console.log('合計:', total, 'ターン');
if (total > 350) {
  console.log('⚠ 合計ターン数が多い。事務作業の繰り返しがあった可能性がある');
}
"

ターン数が大幅に増えているときは、何かがうまくいかずに「念のため確認」「再試行」「同じファイルの二度読み」が発生している可能性が高い。

ターン数が増えやすいパターン:

  • Bashコマンドが弾かれて再試行した(Pythonやsedを使おうとして却下された)
  • 品質チェックで弾かれた記事を書き直して再追加した
  • 同じCSVファイルを複数回読んだ(確認のたびに読み直した)

morning-digest.mjs でこの3点を自動通知する

毎朝7時に動く morning-digest.mjs に、上の3点のチェックを組み込んだ。

通知(ntfy経由でスマートフォンへ)の形式:

昨晩の実行: ✅ 前半01:03・後半03:21(両方あり)
日次ログ: ✅ 前半・後半ともに記録あり(最終更新03:28)
コスト: ✅ 合計141ターン(前半97・後半44)

異常があるときは:

昨晩の実行: ❌ 後半のエントリなし(前半のみ)
日次ログ: ⚠ 前半のみ(後半の見出しが見つからない)
コスト: ⚠ 前半199ターン(ベースラインの176%)

ここまで自動で通知が来るようになってから、朝の確認が30秒以内で終わるようになった。異常があればその日の対話セッションで原因を調べる、という流れに落ち着いている。

// morning-digest.mjs の実行チェック部分(概略)
const lastCapacity = getLastNightEntries('capacity-log.jsonl');
const hasZenhan = lastCapacity.some(e => e.session.includes('前半'));
const hasKouhan = lastCapacity.some(e => e.session.includes('後半'));
const totalTurns = lastCapacity.reduce((s, e) => s + (e.turns || 0), 0);

if (!hasZenhan || !hasKouhan) alerts.push('実行が不完全');
if (totalTurns > 350) alerts.push('ターン数多め(' + totalTurns + ')');

29日間で起きた主なトラブルと対処

日数 トラブル 原因 対処
7日目 後半が7日間動いていなかった タスクスケジューラへの後半タスク登録漏れ Windowsタスクスケジューラに後半タスクを追加
14日目 Playwright認証切れでブログ下書きが止まった CookieのTTL切れ save-auth-*.mjs で再取得
18日目 利用上限3日連続 1セッションに作業を詰め込みすぎ 前半・後半・追加の3セッションに分割
24日目 前半ターン数が220まで増加 同じCSVを確認のたびに再読み込み pool-brief.mjs で1回にまとめた
28日目 Qiitaに0本しか追加されなかった 品質チェックで弾かれたが再投稿していなかった gate-rejects.jsonl を morning-digest に組み込んだ

4週目以降は、同じトラブルが繰り返されることが減った。ログを確認して再発防止を入れるサイクルが回り始めたからだと思う。

29日間でわかったこと

「動いた」と「意図した内容になった」は別の話だ。

夜間自動実行を始めたばかりのころは、「今日は異常なし」という前提で翌日の作業を組み立てていた。でも実際には、前日の作業が半分しか動いていなかった日や、動いたがキューに積まれただけで実際の投稿は翌日以降になっていた日があった。

3か所の確認とその自動通知を組み込んでから、「今日は昨晩の作業の状態を把握してから動き始める」という基準が自然に定着した。ゼロから作り直せるなら、最初からこの3点の確認をタスクに含めた設計にすると楽だと思う。

今のところ29日間でシステムが完全停止したのは3日間だった。残りの26日間は何かしらの作業が動いていた。これが多いのか少ないのかはまだ判断できないが、少なくとも「動かなかった日の原因」が全部分かっているのは改善だと感じている。

付録:確認スクリプトのまとめ

# 昨晩の実行エントリを確認
tail -n 5 capacity-log.jsonl | node -e "
const lines = require('fs').readFileSync('/dev/stdin','utf8').trim().split('\n');
lines.forEach(l => {
  const d = JSON.parse(l);
  const dt = new Date(d.timestamp).toLocaleString('ja-JP');
  console.log(dt, d.session, d.turns + 'ターン', d.costUSD + 'USD');
});
"

# 最新の日次ログ見出しを確認(daily-log.mdは読まずgrepだけ)
grep -n "^### " weekly-reports/daily-log.md | tail -n 5

# 昨晩の合計ターン数を計算
node -e "
const today = new Date().toISOString().slice(0,9);
const lines = require('fs').readFileSync('capacity-log.jsonl','utf8').trim().split('\n');
const todayEntries = lines
  .map(l => JSON.parse(l))
  .filter(d => d.timestamp && d.timestamp.startsWith(today));
const total = todayEntries.reduce((s,d) => s + (d.turns||0), 0);
console.log('今日の合計ターン数:', total);
"

関連記事:
https://note.com/light_tern636/n/n6958f1413b15


無人実行が止まる原因の点検を、ココナラで承っています(「Claude Code 点検」で検索)。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?