# 실전: 조용히 실패하는 야간 잡

> 출력 계약·권한 기준선·세션 추적으로 원인을 좁히기

- Canonical: https://learning.reopt.ai/courses/claude-code-team-operations/lessons/ccto-m2-scenario
- Language: ko-KR
- HTML: https://learning.reopt.ai/courses/claude-code-team-operations/lessons/ccto-m2-scenario

---

[헤드리스와 팀 운영](/courses/claude-code-team-operations) 2. 출력 계약과 권한 기준선 4 / 9

# 실전: 조용히 실패하는 야간 잡

출력 계약·권한 기준선·세션 추적으로 원인을 좁히기
시나리오 60 XP 8분

야간 CI에서 flaky 테스트를 조사하고 수정하는 헤드리스 잡이 어떤 날은 30분에 끝나고 어떤 날은 타임아웃으로 죽습니다.
상황 배경 stdout에는 사람이 읽는 텍스트만 찍히고 종료 코드는 항상 0입니다. 비용이 얼마나 나갔는지도 모르고, 실패한 날과 성공한 날을 사후에 구분할 방법이 없습니다. 결정 1 / 3

가장 먼저 무엇을 바꿔 실패를 감지 가능하게 만들까요?
`--output-format stream-json --verbose --include-partial-messages`로 모든 이벤트를 로그에 쏟아붓는다 `--output-format json`으로 `session_id`·`total_cost_usd`를 기록하고 `--json-schema`로 결과 구조를 고정한 뒤 `structured_output`·검증 결과·종료 코드를 함께 확인한다 잡 타임아웃을 두 배로 늘려 죽는 빈도를 먼저 줄인다

---

에이전트용 사이트 안내: https://learning.reopt.ai/llms.txt · 사이트맵: https://learning.reopt.ai/sitemap.xml · 문의: https://learning.reopt.ai/contact