주의: headless claude -p는 일반적인 Claude Code 사용보다 5시간 제한을 약 1.5배 더 빨리 소모함
Heads up: headless claude -p eats your 5-hour limit about 1.5x faster than using Claude Code normally
핵심 요약
Claude Code를 headless 모드(-p)로 실행하면 일반적인 대화형 사용보다 5시간 사용 제한을 약 1.5배 빠르게 소모한다는 분석 결과입니다.
- 사용량 분석 — 4개의 Max 20x 계정을 추적한 결과 headless 모드가 약 1.5배 더 많은 제한을 소모함
- 원인 분석 — 캐시 설정, 시작 비용, 업데이트 지연 등 다양한 변수를 검토했으나 1.5배의 차이는 여전함
- 대안 제시 — 스크립트로 대화형 세션을 유지하며 메시지를 보내는 방식이 headless보다 비용 효율적일 수 있음
- 제한 변화 — 최근 5시간 사용 제한 범위가 약 15% 확대되었으나 주간 제한은 그대로인 현상이 관찰됨
세 줄 요약: Claude Code를 헤드리스 모드(claude -p, 스크립트나 파이프라인에서 사용)로 돌리면 일반적인 대화형 사용보다 5시간 제한을 약 1.5배 더 빨리 잡아먹음. Max 20x 계정 4개로 직접 측정해 봄.
내가 한 짓
사용량 추적기를 만들고 있음. 몇 분마다 Max 계정 4개의 5시간 제한이랑 주간 제한 수치를 긁어오거든. 이걸 각 메시지가 쓴 토큰 수(Claude Code가 로컬 로그 파일에 저장함)랑 대조해 봤음. 덕분에 헤드리스로 돌릴 때랑 대화형으로 작업할 때를 비교할 수 있었지.
알아낸 것
헤드리스 파이프라인을 돌리는 계정 3개에서, 주간 제한 1%를 쓸 때마다:
-
대화형 작업은 5시간 제한의 약 **4.4%**를 소모함
-
헤드리스 작업은 약 **7%**를 소모함
Image 2에 나와 있음.
계정 4개를 다 합쳐서 계정별, 주차별 변수를 고려해 봐도 헤드리스가 1.49배 더 많이 먹음. 실제 수치는 1.4배에서 1.6배 사이일 확률이 매우 높음.
계정별로 봐도 결과는 똑같음(image 3). 내 메인 계정은 헤드리스를 거의 안 돌려서 추정치가 좀 불확실하긴 함.
다른 이유가 있을까?
헤드리스 작업을 돌리는 계정 3개로 뻔한 이유들을 다 테스트해 봤는데, 결과는 그대로였음:
-
캐시 설정: 헤드리스나 일반 세션이나 캐시 방식은 똑같음. 같은 조건끼리 비교해도 여전히 1.46배 정도 나옴.
-
실행 시 초기 비용: 이걸 포함해도 1.45배 정도 나옴.
-
타이밍을 앞뒤로 10~30분씩 밀어봐도 최악의 경우 1.42배까지밖에 안 떨어짐.

