AI 뉴스 데일리English
← AI 도구 팁
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분 대기 한 번으로 묶어 센다. 서브에이전트를 여러 단 엮었다면 한도를 늘린다.

  1. 값은 밀리초 단위이고 기본값은 600000(10분)이다.
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=1800000 claude -p "테스트 전부 돌리고 실패 원인 정리해 줘"
  1. 한도 없이 기다리려면 0을 준다.
CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS=0 claude -p "테스트 전부 돌리고 실패 원인 정리해 줘"

Claude가 백그라운드 결과를 받아 턴을 한 번 더 돌 때마다 대기 시간은 다시 0부터 센다. 본 대화가 띄운 백그라운드 명령(개발 서버, watch 빌드)이 돌고 있으면 한도와 상관없이 그 명령이 끝날 때까지 기다린다. 이 환경변수는 2.1.182부터 있었다.

새 팁이 올라오면 앱이 알려 드려요

팁 알림은 앱에서만 보내요. 앱을 설치하고 알림을 켜 두세요.

앱 받기

팁 전체 보기 →