Claude Code 서브 에이전트 캐시 최적화: 5분 기본 설정을 1시간으로 변경하기
서브 에이전트 사용 시 토큰 낭비를 방지하는 구체적 설정값, 비용 절감 효과 즉시 체감 가능.
요약
Claude Code의 서브 에이전트는 기본적으로 5분의 프롬프트 캐시 제한을 가지고 있어, 5시간 사용량 제한을 빠르게 소진하는 원인이 됩니다. 서브 에이전트가 5분 이상 소요되는 차단형 명령을 실행할 경우, 다음 요청 시 축적된 컨텍스트를 캐시에서 불러오지 못하고 재작성하게 되어 비용이 크게 증가합니다. 이를 해결하려면 ~/.claude/settings.json 파일에 'subagentPromptCacheTtl': '1h' 설정을 추가하여 캐시 유지 시간을 1시간으로 늘려야 합니다. 실제 테스트 기반 워크플로우에서 이 설정을 적용한 결과, 캐시 재작성 횟수가 약 75% 감소하는 효과가 확인되었습니다. Claude Code를 활용해 긴 작업을 수행하는 실무자들은 해당 설정을 변경하여 효율적으로 사용량을 관리할 것을 권장합니다.
AI가 원문을 요약한 내용으로, 부정확할 수 있습니다.
원문 제목 Claude Code sub-agents have a 5m prompt cache. Long commands can burn your 5-hour window.
원문 보기 ↗