이 글의 결론: Claude Code를 밤에 자동으로 실행하는 것을 29일 동안 지속했습니다. '실행 완료' 알림을 받았더라도, 다음 날 아침에는 반드시 확인해야 할 3곳이 있습니다. 확인을 소홀히 했던 날에 한해서, 2일 동안 멈춰 있었다는 사실을 나중에 발견했습니다.
대상 독자
Claude Code를 야간 배치(batch)로 구동하고 있어 '정말로 작동하는지'가 불안한 사람. 또는 무인 실행을 막 시작하여 무엇을 어떻게 확인해야 할지 헤매는 사람을 상정합니다. 태스크 스케줄러(Task Scheduler, Windows 또는 Linux cron)에서 Claude를 호출하는 구성으로 매일 밤 정해진 작업을 자동화하고 있는 사람이 가장 참고하기 쉬울 것이라고 생각합니다.
야간 자동 실행 시 첫 번째 확인 사항은 '애초에 어젯밤 실행이 시작되었는지'입니다.
이는 당연하게 들릴 수 있습니다. 하지만 멈춘 방식에 따라 '실행이 시작되지 않음'과 '실행이 시작되었으나 도중에 멈춤'의 두 가지 패턴이 있으며, 어느 쪽도 '정상 종료' 알림은 오지 않습니다. 로그가 남는 방식이 다르기 때문에 구별할 수 있다면 이후 대처가 빨라집니다.
확인에 사용한 것은 capacity-log.jsonl입니다. 각 실행 세션의 시작 시간, 턴(turns) 수, 비용(cost)이 한 줄씩 기록됩니다.
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 플랜의 일일 사용 한도에 도달하여 세션이 강제 종료되는 경우입니다. 이 경우, 중간까지의 로그는 capacity-log.jsonl에 남아 있지만 턴 수가 적습니다.
스크립트 오류: node append-pool-row-qiita.mjs 등의 호출에서 에러가 발생하여 멈추는 경우입니다. Claude는 '에러가 발생했다'고 인식하고 멈추기 때문에, 에러보다 앞선 로그는 남아 있습니다.
태스크 스케줄러 등록 누락: 전반 작업은 작동했지만 후반 작업을 등록하는 것을 잊어버린 경우입니다. 로그에는 전반만 있지만 에러가 아니므로 알림이 오지 않습니다.
세 번째 경우가 가장 알아차리기 어렵습니다. 7일 차에 후반 작업의 등록 누락이 밝혀졌을 때는 이미 7일 동안 후반 작업이 작동하지 않았던 것입니다. 블로그 재고가 보충되지 않은 것을 통해 깨달았습니다.
실행되었더라도 '무엇을 했는지' 내용 자체가 맞지 않는 경우가 있습니다.
확인에 사용한 것은 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개였던 경우
품질 검사 (Quality Check) (append-pool-row-qiita.mjs)에서 걸러진 기사는 gate-rejects.jsonl에 기록되어 있었다. 다만, 거절되었다는 내용이 daily-log에 작성되지 않았고, '2개의 글을 쓰려고 했다'와 '2개를 추가했다'가 혼동되고 있었다.
패턴 3: 전반부만 작동하고 후반부가 없었던 날이 2일 연속 지속됨
이것이 바로 '2일 동안 문제가 있어도 알아차리지 못했던' 실체이다. 전반부(Qiita 보충)만 작동했기 때문에 로그에는 기록이 남아 있었고, 이상 알림이 오지 않았다. 하지만 후반부(블로그 보충・Threads)는 전혀 작동하지 않고 있었다.
daily-log의 헤드라인을 확인하는 과정에서 '전반부' 내용만 있는 날이 2일 연속 지속되었다는 사실이 3일 후에야 밝혀졌다.
세 번째로 확인할 것은 비용(Cost)이다. 정확히 말하면 '턴 수(Turn count)가 예상 범위 내에 있는지'를 확인하는 것이다.
야간 실행 1회당 턴 수가 기준선(Baseline)에서 크게 벗어나지 않았는지 본다.
기준선 측정 방법
2026년 9월 25일 실측 기준으로, 전반부 세션이 113턴으로 $5.27 상당이었다. 이것을 '평범한 전반부 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;
...
"
턴 수가 대폭 증가했을 때는, 무언가 원활하게 진행되지 않아 '만약을 위한 확인', '재시도', 또는 '같은 파일을 두 번 읽기' 같은 과정이 발생했을 가능성이 높다.
턴 수 증가가 쉬운 패턴:
- Bash 명령어가 거부되어 재시도된 경우 (Python이나 sed를 사용하려다 차단됨)
- 품질 검사에서 걸러진 기사를 다시 작성하여 추가한 경우
- 같은 CSV 파일을 여러 번 읽은 경우 (확인할 때마다 다시 읽음)
매일 아침 7시에 작동하는 morning-digest.mjs에 위 세 가지 점의 확인을 결합했다.
알림(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('전반부'));
...
| 일수 | 문제점 | 원인 | 조치 |
|---|
| 7일째 | 후반부가 7일간 작동하지 않음 | 태스크 스케줄러에 후반부 작업을 등록하는 것을 누락함 | Windows 작업 스케줄러에 후반부 작업을 추가함 |
| ... | | | |
4주차 이후부터는 같은 문제가 반복되는 경우가 줄었다. 로그를 확인하고 재발 방지 조치를 하는 사이클이 돌아가기 시작했기 때문이라고 생각한다.
'작동했다'와 '의도한 내용으로 완성되었다'는 별개의 문제다.
야간 자동 실행을 막 시작했을 때는, '오늘은 이상 없음'이라는 전제하에 다음 날 작업을 구성하고 있었다. 하지만 실제로는, 전날 작업이 절반만 작동했던 날이나, 작동은 했지만 큐(Queue)에 쌓여 있을 뿐 실제 게시물은 다음 날 이후가 되었던 날들이 있었다.
세 군데의 확인과 자동 알림을 결합한 후에는 '오늘은 어젯밤 작업 상태를 파악하고 나서 움직이기 시작한다'는 기준이 자연스럽게 정착되었다. 처음부터 다시 만들 수 있다면, 애초에 이 세 가지 점의 확인을 태스크에 포함하도록 설계하는 것이 편할 것 같다.
현재까지 29일 동안 시스템이 완전히 중단된 것은 3일이었다. 나머지 26일 동안은 어떤 작업이든 움직이고 있었다. 이것이 많은지 적은지는 아직 판단하기 어렵지만, 적어도 '작동하지 않았던 날의 원인'을 전부 파악했다는 점은 개선되었다고 느낀다.
어젯밤 실행 기록 확인
tail -n 5 capacity-log.jsonl | node -e "
const lines = require('fs').readFileSync('/dev/stdin','utf8').trim().split('\n');
..."
관련 기사:
무인 실행이 중단되는 원인 점검을 Cocona Cola에서 받고 있습니다("Claude Code 점검"으로 검색).