CHAPTER 06 / 10
5. 서브에이전트에 맡긴다: 무거운 작업을 메인 대화에서 떼어 내기
『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일
1장에서 봤듯이 한 번 읽은 파일이나 명령 출력은 그 뒤 대화에 계속 실린다. 긴 테스트 로그를 한 번 읽히기만 해도 이후 모든 메시지가 그 로그를 짊어진다.
CHAPTER 06 / 10
『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일
1장에서 봤듯이 한 번 읽은 파일이나 명령 출력은 그 뒤 대화에 계속 실린다. 긴 테스트 로그를 한 번 읽히기만 해도 이후 모든 메시지가 그 로그를 짊어진다.
1장에서 봤듯이 한 번 읽은 파일이나 명령 출력은 그 뒤 대화에 계속 실린다. 긴 테스트 로그를 한 번 읽히기만 해도 이후 모든 메시지가 그 로그를 짊어진다.
이걸 막는 게 서브에이전트다.
서브에이전트는 자기 전용 컨텍스트를 가진 별도의 Claude다. 메인 대화에서 일을 맡기면 서브에이전트가 자기 컨텍스트 안에서 작업하고 결과 요약만 메인에 돌려준다.
메인: "테스트를 실행하고, 실패 원인을 조사해 줘"
↓
서브에이전트: 테스트 실행 → 5000줄 로그를 읽는다 → 원인 특정
↓
메인: "실패 2건. 원인은 날짜의 타임존 처리" (요약만 받는다)
5000줄 로그는 서브에이전트 안에만 남고 메인 대화에는 들어오지 않는다.
공식 문서도 다음처럼 출력이 많은 작업을 맡기라고 권한다.
반대로 메인 대화에서 세세하게 주고받으며 진행하는 작업(설계 상담, 조금씩 하는 수정)은 서브에이전트에 맞지 않는다.
8장 실험에서는 4,000줄 로그에서 에러 원인을 찾는 작업을 Haiku 서브에이전트에 맡겨 봤다. 그랬더니 맡기지 않았을 때보다 4% 늘었다.
지금의 Claude Code는 로그를 통째로 읽지 않고 ERROR 등으로 걸러서 필요한 줄만 읽는다. 그래서 서브에이전트 없이도 메인 대화가 더러워지지 않았다. 거기에 서브에이전트를 끼우면 띄우는 비용(시스템 프롬프트 등 로드)만큼 손해를 본다.
서브에이전트는 Claude Code가 스스로 걸러 낼 수 없는 대량의 출력이 나오는 작업에서 정말 효과를 본다. 전문을 읽어야 판단이 서는 긴 테스트 출력이나 수십 개 파일에 걸친 조사가 그렇다. "무거워 보이니까 맡긴다"가 아니라 "걸러 낼 수 없는 양이 나오는가"로 판단하자.
이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.
이어서 읽기