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

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

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

서브에이전트는 별도의 컨텍스트 윈도우를 생성함으로써 이 문제를 해결합니다. 서브에이전트는 두 가지를 받습니다:

• 구성 파일에서 가져온 커스텀 시스템 프롬프트로, 서브에이전트의 역할과 동작을 정의합니다
• 요청한 내용을 기반으로 부모 에이전트가 작성한 작업 설명

그런 다음 서브에이전트는 독립적으로 작업합니다. 파일을 읽고, 검색을 실행하고, 코드를 편집하는 등 필요한 모든 작업을 수행합니다. 작업이 완료되면 메인 대화로는 요약만 돌아옵니다. 그러면 전체 서브에이전트 대화는 폐기됩니다.

이는 메인 컨텍스트가 깨끗하게 유지된다는 것을 의미합니다. 답을 찾기 위해 거쳐간 과정의 모든 잡음 없이 답만 얻게 됩니다. 단점은 서브에이전트가 어떻게 결론에 도달했는지에 대한 가시성을 잃게 된다는 것입니다.

실제 예시

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

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

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

내장 서브에이전트

Claude Code는 즉시 사용할 수 있는 여러 내장 서브에이전트와 함께 제공됩니다:

• 범용 서브에이전트(General purpose subagent) -- 탐색과 실행이 모두 필요한 다단계 작업용
• Explore -- 코드베이스의 빠른 검색 및 탐색용
• Plan -- 계획을 제시하기 전에 코드베이스에 대한 연구와 분석을 위해 계획 모드에서 사용됨

커스텀 서브에이전트

내장 옵션 외에도, 커스텀 시스템 프롬프트와 도구 접근 권한을 가진 자체 서브에이전트를 만들 수 있습니다. 이를 통해 워크플로우에 맞춘 전문화된 에이전트 -- 코드 리뷰어, 테스트 작성자, 문서 생성기, 또는 필요한 그 무엇이든 -- 를 정의할 수 있습니다.

핵심 요약

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

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

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