레딧에 「클로드 코드가 빌드를 백그라운드로 돌리고 '완료 알림을 기다리겠다'며 차례를 끝내면 그런 알림은 없어서 빌드도 같이 죽는다」는 경험담이 올라왔는데, 공식 도구 참조 문서는 그렇게 멈추는 경우를 전면(foreground) 서브에이전트가 시작한 명령과 claude -p 비대화형 실행(최종 결과 뒤 약 5초) 두 가지로 한정하고, 메인 대화나 백그라운드 서브에이전트가 시작한 명령은 최종 응답 뒤에도 계속 돈다고 적었어요. 완료 알림도 문서상 존재해서 백그라운드 명령이 끝나면 다음 차례에 알림으로 들어오지만, 9월 6일 깃허브 이슈 #92563 은 v2.1.250~259 에서 알림이 대화에 붙기만 하고 새 차례를 열지 않아 사용자가 말을 걸 때까지 세션이 멈춰 있던 사례(알림 약 580건 중 7건)를 보고했어요. 그러니 「알림은 없다」는 말은 부정확하고, 실제 증상은 명령이 실제로 끝나는 경우와 알림이 차례를 깨우지 못해 멈춘 것처럼 보이는 경우로 나뉘는데, 레딧 글 발췌만으로는 글쓴이가 어느 쪽이었는지 확인되지 않아요.
- run_in_background
- Bash 도구 호출을 백그라운드 작업으로 시작하게 하는 매개변수
- /tasks
- 돌고 있는 백그라운드 셸과 서브에이전트를 보고 멈출 수 있는 클로드 코드 명령
- claude -p
- 터미널 대화 없이 프롬프트 하나를 실행하고 결과만 출력하는 비대화형 실행 방식
긴 빌드나 렌더는 메인 대화에서 run_in_background 로 돌리면서 출력을 로그 파일에 남기고, 서브에이전트에 맡길 때는 전면이 아니라 백그라운드 서브에이전트로 띄우거나 명령이 끝나기 전에는 최종 응답을 내지 말라고 지시하세요. 클로드가 「알림을 기다리겠다」며 멈춰 있으면 /tasks 로 작업이 살아 있는지 확인하고, 살아 있다면 「백그라운드 작업 출력을 읽고 보고하라」고 한 번 말을 걸면 이어서 진행해요.
- 공식 문서(도구 참조) 전면 서브에이전트가 시작한 명령은 그 서브에이전트의 최종 응답에 멈추고, 메인 대화·백그라운드 서브에이전트가 시작한 명령은 계속 돌며, -p 모드에서는 최종 결과 직후에 끝난다고 적혀 있어요. Claude Code 공식 문서
- 공식 문서(서브에이전트) 백그라운드 서브에이전트의 결과와 백그라운드 명령의 종료는 다음 차례에 완료 알림으로 클로드에 전달된다고 적혀 있어요. Claude Code 공식 문서
- 깃허브 이슈 9월 6일 열린 이슈는 v2.1.250~259 에서 완료 알림이 대화에 붙기만 하고 새 차례를 열지 않아 세션이 멈춘 사례를 보고했고, 작업 자체는 죽지 않고 정상 종료돼 있었어요. GitHub