Claude Code 성공 제대로 판정하기

claude -p 를 자동화에 넣으면 종료 코드가 0 이면 성공으로 기록하게 마련입니다. 그런데 성공으로 끝났는데 결과 파일이 없는 날이 있고, 실패로 끝났는데 파일은 멀쩡한 날이 있습니다.

이 책은 claude -p 가 정말 일을 끝냈는지를 Claude 의 말이 아니라 종료 코드 · subtype · is_error · 거절 · 도구 오류 · 파일로 세어 확인합니다.

이런 일을 하고 계신다면

· claude -p 의 종료 코드가 0 이면 성공으로 기록한다

· 성공으로 끝났는데 결과 파일이 없는 날이 있다

· 실패로 끝났는데 파일은 멀쩡한 날이 있다

· Claude 가 done 이라고 하면 그대로 믿는다

· 밤새 돌린 자동화의 아침 결과를 믿어도 되는지 모르겠다

이 책에 들어 있는 것

레시피 열네 개 · 열다섯 단계 · 95쪽

01 claude -p 의 '성공' 은 여섯 곳에서 읽습니다 — 종료 코드 하나만 믿지 않습니다

02 정상으로 끝날 때 — 여섯 곳이 모두 '성공' 을 가리킵니다 (15/15)

03 턴 한도에 걸리면 — 종료 코드 1 · 답은 비어 있고, 일은 끝났을 수도 있습니다

04 예산 한도에 걸리면 — 종료 코드 1 · 답이 비고, 일은 어디선가 끊깁니다

05 권한이 거절돼도 — 종료 코드 0 · subtype success, 파일은 하나도 없습니다 (18/18)

06 쓰기 도구가 빠져 있으면 — 거절 기록도 없이 'done' 이라고 답합니다 (10/24)

07 없는 모델로 부르면 — 종료 코드 1 · is_error True 인데 subtype 은 success 입니다 (9/9)

08 읽을 파일이 없으면 — 종료 코드 0 · success 이고, 단서는 도구 결과의 오류뿐입니다 (15/15)

09 출력 형식에 따라 보이는 것이 다릅니다 — text 로는 권한 거절이 보이지 않습니다

10 '만든 뒤 Read 로 확인해' 라고 부탁에 넣어도 — 거짓 완료는 사라지지 않았습니다

11 한도에 걸려 멈춘 일은 — 세션을 이어서 마저 끝낼 수 있습니다 (12/12)

12 권한 거절을 없애는 두 방법 — --allowedTools 에 넣기 · acceptEdits (15/15)

13 Claude 없이 한 번의 기록을 판정하는 판정기 — 성공 · 성공(경고) · 실패 · 의심

14 Claude 의 말이 아니라 파일을 연다 — 파일마다 맞음 · 없음 · 비어 있음 · 다름

15 '종료 코드 0 이면 성공' 은 스물네 번 중 열두 번 틀렸고, 판정기는 한 번도 안 틀렸습니다

조용히 틀어진 것을 다 실었습니다

· 권한이 거절돼도 종료 코드 0 · subtype success — 파일은 하나도 없음 (18/18)

· 쓰기 도구가 없으면 거절 기록도 없이 done 이라고 답함 (24번 중 10번)

· 없는 모델은 is_error True 인데 subtype 은 success (9/9) · 읽을 파일이 없어도 종료 코드 0

· text 형식으로는 권한 거절이 보이지 않고, '확인해' 라는 문구로도 거짓 완료가 사라지지 않음

· 반대로 턴 한도에 걸려 종료 코드 1 인데 일은 끝나 있던 경우 (15번 중 12번)

· 여덟 시나리오 판정 — 종료 코드 0 이면 성공은 24번 중 12번, subtype 은 15번 틀렸고 판정기는 한 번도 안 틀림

성공은 파일이 말합니다

종료 코드 · subtype · is_error · permission_denials · 도구 결과의 오류 · 폴더 안의 파일, 여섯 곳으로 판정했고 마지막은 파일로 확인했습니다.

판정기와 파일 검증은 Claude 없이 돌아가는 코드로 실었습니다.

전부 실제로 돌려 확인했습니다

2026년 10월 12일, Windows 10 · Claude Code 2.1.286 에서 레시피 열네 개를 세 판 만들어 돌렸습니다.

기록이 남은 호출 315번. 본문의 검은 상자는 그때 나온 화면 그대로이고, 부록의 코드도 실제로 돌아간 파일 그대로입니다.

시나리오마다 연습 폴더 밖의 새 폴더에서 불렀고, 내 사용자 설정은 읽지 않았습니다. 모델은 haiku 이며 Windows 10 에서만 시험했습니다.

이런 분께

· claude -p 로 자동화를 돌리는 분

· 종료 코드로 성공을 판단하는 스크립트를 가진 분

· 밤새 돌린 자동화의 결과를 믿고 싶은 분

포함 파일

PDF (A4 · 95쪽) · EPUB (모바일 · 리더용)

두 가지가 ZIP 하나에 들어 있습니다.

「Claude Code 실전」 시리즈입니다. 이 책은 Anthropic 과 관계가 없는 개인의 사용기입니다.