ilhae.ai

CHAPTER 06 / 10

5. 서브에이전트에 맡긴다: 무거운 작업을 메인 대화에서 떼어 내기

『Claude Code 사용 한도 절약법: 토큰 줄이는 설정과 습관 정리』 · 김재우 · 2026년 11월 8일

1장에서 봤듯이 한 번 읽은 파일이나 명령 출력은 그 뒤 대화에 계속 실린다. 긴 테스트 로그를 한 번 읽히기만 해도 이후 모든 메시지가 그 로그를 짊어진다.

미리 읽기

1장에서 봤듯이 한 번 읽은 파일이나 명령 출력은 그 뒤 대화에 계속 실린다. 긴 테스트 로그를 한 번 읽히기만 해도 이후 모든 메시지가 그 로그를 짊어진다.

이걸 막는 게 서브에이전트다.

서브에이전트의 구조

서브에이전트는 자기 전용 컨텍스트를 가진 별도의 Claude다. 메인 대화에서 일을 맡기면 서브에이전트가 자기 컨텍스트 안에서 작업하고 결과 요약만 메인에 돌려준다.

메인: "테스트를 실행하고, 실패 원인을 조사해 줘"
   ↓
서브에이전트: 테스트 실행 → 5000줄 로그를 읽는다 → 원인 특정
   ↓
메인: "실패 2건. 원인은 날짜의 타임존 처리" (요약만 받는다)

5000줄 로그는 서브에이전트 안에만 남고 메인 대화에는 들어오지 않는다.

잘 맞는 작업

공식 문서도 다음처럼 출력이 많은 작업을 맡기라고 권한다.

  • 테스트 실행과 실패 조사
  • 문서나 웹 페이지 조사
  • 로그 파일 분석
  • "이 함수는 어디서 쓰이나" 같은, 파일을 많이 읽는 탐색

반대로 메인 대화에서 세세하게 주고받으며 진행하는 작업(설계 상담, 조금씩 하는 수정)은 서브에이전트에 맞지 않는다.

실측: 아무거나 맡기면 오히려 늘어난다

8장 실험에서는 4,000줄 로그에서 에러 원인을 찾는 작업을 Haiku 서브에이전트에 맡겨 봤다. 그랬더니 맡기지 않았을 때보다 4% 늘었다.

지금의 Claude Code는 로그를 통째로 읽지 않고 ERROR 등으로 걸러서 필요한 줄만 읽는다. 그래서 서브에이전트 없이도 메인 대화가 더러워지지 않았다. 거기에 서브에이전트를 끼우면 띄우는 비용(시스템 프롬프트 등 로드)만큼 손해를 본다.

서브에이전트는 Claude Code가 스스로 걸러 낼 수 없는 대량의 출력이 나오는 작업에서 정말 효과를 본다. 전문을 읽어야 판단이 서는 긴 테스트 출력이나 수십 개 파일에 걸친 조사가 그렇다. "무거워 보이니까 맡긴다"가 아니라 "걸러 낼 수 없는 양이 나오는가"로 판단하자.

이 장의 나머지 내용은 읽기 화면에서 이어서 볼 수 있어요.

이어서 읽기

이 장에서 다루는 것

  1. 서브에이전트의 구조
  2. 잘 맞는 작업
  3. 실측: 아무거나 맡기면 오히려 늘어난다
  4. 주의: 서브에이전트도 공짜가 아니다
  5. 서브에이전트 만드는 법
  6. 에이전트 팀은 신중하게

ilhae.ai 안내 도우미대기 중

글자를 치면 사이트 자료를 바로 찾아요. AI 대화는 하루 20번까지이고, 질문 앞부분은 서비스 개선을 위해 30일 보관해요. 개인정보는 적지 마세요.