서브에이전트란 무엇인가요?

서브에이전트가 중요한 이유

Claude Code와 대화할 때마다 메인 컨텍스트 창에 내용이 추가됩니다. 모든 도구 호출, 모든 파일 읽기, 모든 검색 결과가 그곳에 저장됩니다. 그 공간은 유한하며, 한 번 가득 차면 Claude는 대화의 앞부분을 놓치기 시작합니다.

서브에이전트는 별도의 컨텍스트 창을 생성하여 이 문제를 해결합니다. 서브에이전트의 시작 컨텍스트에는 다음이 포함됩니다:

• 사용자 지정 시스템 프롬프트 -- 구성 파일에서 서브에이전트의 역할과 동작을 정의합니다
• 작업 설명 -- 사용자가 요청한 내용을 바탕으로 상위 에이전트가 작성합니다

그런 다음 서브에이전트는 독자적으로 작업을 수행합니다. 파일을 읽고, 검색을 실행하고, 코드를 편집하는 등 필요한 모든 작업을 수행합니다. 작업이 끝나면 요약만 메인 대화로 돌아옵니다. Claude Code는 서브에이전트 대화의 나머지 부분을 별도의 트랜스크립트 파일에 저장합니다.

즉, 메인 컨텍스트는 깨끗하게 유지됩니다. 답을 찾기까지의 과정에서 발생하는 모든 잡음 없이 답만 얻게 됩니다. 단점은 메인 대화에서 서브에이전트가 어떻게 결론에 도달했는지 볼 수 없다는 것입니다.

실제 예시

익숙하지 않은 코드베이스를 탐색하면서 어떤 서비스가 환불을 처리하는지 알고 싶다고 가정해 보겠습니다. 서브에이전트가 없다면 Claude는 15개의 파일을 읽고, 여러 번 검색을 실행하고, 여러 함수 호출을 추적해야 할 수도 있습니다. 단 하나의 사실만 필요했음에도 불구하고 이 모든 것이 컨텍스트 창을 채우게 됩니다.

서브에이전트를 사용하면 경험이 훨씬 깔끔해집니다. 질문을 하면 Explore 서브에이전트가 생성되어 자체 컨텍스트 내에서 모든 탐색 작업을 수행한 후, 집중된 답변을 돌려줍니다.

메인 컨텍스트 창에는 질문과 요약만 기록되며, 그 과정에서 읽은 15개의 파일은 기록되지 않습니다.

내장 서브에이전트

Claude Code에는 바로 사용할 수 있는 여러 내장 서브에이전트가 포함되어 있습니다:

• 범용 서브에이전트 -- 탐색과 실행이 모두 필요한 다단계 작업용
• Explore -- 코드베이스의 빠른 검색 및 탐색용
• Plan -- 계획을 제시하기 전에 코드베이스에 대한 리서치와 분석을 수행하는 계획 모드에서 사용됨

사용자 지정 서브에이전트

내장 옵션 외에도 사용자 지정 시스템 프롬프트와 도구 접근 권한을 가진 자신만의 서브에이전트를 만들 수 있습니다. 이를 통해 코드 리뷰어, 테스트 작성자, 문서 생성기 등 워크플로우에 맞춘 전문화된 에이전트를 정의할 수 있습니다.

핵심 요약

서브에이전트는 세 가지 주요 이점을 제공합니다:

• 작업을 집중된 단위로 나누어 각 서브에이전트가 특정 작업에 집중할 수 있게 합니다
• 모든 중간 작업을 격리하여 메인 컨텍스트 창을 깨끗하게 유지합니다
• 필요한 정보만 간결한 요약으로 돌려줍니다

내장 서브에이전트를 사용하든 직접 만든 서브에이전트를 사용하든, 서브에이전트는 더 긴 Claude Code 세션을 더욱 효과적으로 활용할 수 있는 실용적인 방법입니다. 메인 컨텍스트의 잡음이 적을수록 더 오래, 더 효과적으로 작업할 수 있습니다.