Claude Code✓ 공식 문서로 확인11월 19일 수집
claude -p에서 백그라운드 서브에이전트 기다리는 10분 한도 늘리는 환경변수 설정법
claude -p는 마지막 턴이 끝난 뒤에도 Claude가 띄운 백그라운드 서브에이전트와 워크플로, Monitor 감시를 기다린다. 아무 진행 없이 10분이 지나면 남은 작업을 멈추고 중간 결과는 버린다. 긴 작업을 스크립트나 CI로 돌렸는데 결과가 비어 있다면 이 한도에 걸렸는지 먼저 본다.
2.1.328(11월 19일)부터는 CLAUDE_CODE_FORK_SUBAGENT=0으로 포크 모드를 끈 -p 실행에서, 백그라운드 서브에이전트와 그 서브에이전트가 기다리는 하위 서브에이전트를 10분 대기 한 번으로 묶어 센다. 서브에이전트를 여러 단 엮었다면 한도를 늘린다.
- 값은 밀리초 단위이고 기본값은
600000(10분)이다.
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=1800000 claude -p "테스트 전부 돌리고 실패 원인 정리해 줘"
- 한도 없이 기다리려면 0을 준다.
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=0 claude -p "테스트 전부 돌리고 실패 원인 정리해 줘"
Claude가 백그라운드 결과를 받아 턴을 한 번 더 돌 때마다 대기 시간은 다시 0부터 센다. 본 대화가 띄운 백그라운드 명령(개발 서버, watch 빌드)이 돌고 있으면 한도와 상관없이 그 명령이 끝날 때까지 기다린다. 이 환경변수는 2.1.182부터 있었다.
출처