동영상

서브에이전트

Claude는 작업을 서브에이전트에 위임하여 세부 작업으로 분해하고 병렬로 실행할 수 있어 컨텍스트 관리가 향상됩니다. 각 서브에이전트는 독립된 자체 컨텍스트 창에서 작동합니다.

작동 방식

Claude Code에서 컨텍스트를 관리하는 것은 중요합니다. 코드베이스를 탐색하는 도구 호출이나 리서치를 위한 웹 검색 같은 작업이 컨텍스트 창의 상당 부분을 차지합니다. 탐색 과정에서 Claude가 발견한 내용이 개발 중인 주요 기능과 항상 관련 있는 것은 아닙니다.

바로 여기서 서브에이전트가 등장합니다. Claude는 "이 코드베이스를 탐색해줘"와 같은 작업을 처리하기 위해 서브에이전트를 생성합니다. 서브에이전트는 자체 컨텍스트 창에서 병렬로 실행되며 모든 탐색 작업을 수행하고, 완료되면 발견한 내용을 요약하여 Claude에게 반환합니다.

결과적으로, 답을 찾기까지의 전체 과정이 메인 컨텍스트를 어지럽히지 않으면서 원하는 답을 얻을 수 있습니다.

나만의 서브에이전트 만들기

서브에이전트는 YAML 프론트매터가 포함된 마크다운 파일로 정의됩니다. 가장 쉽게 시작하는 방법은 Claude가 자동으로 생성하도록 하는 것입니다. 다음 명령을 실행하세요:

/agents

그런 다음 "Create new agent"를 선택하세요. 에이전트의 범위 선택, 목적 정의, 접근 가능한 도구 선택, 심지어 색상 지정까지 단계별로 진행하게 됩니다.

Claude가 서브에이전트의 이름, 설명, 프롬프트를 생성합니다. 이를 통해 사용자가 제공하는 프롬프트에 따라 Claude가 언제 서브에이전트를 호출할지도 결정됩니다.

추가 커스터마이징

서브에이전트는 더 세부적으로 커스터마이징할 수 있습니다. 주요 기능을 소개합니다:

  • 영구 메모리를 사용하면 서브에이전트가 대화 간에 기억을 유지할 수 있습니다. 동일한 프로젝트에서 지속적으로 사용하는 경우에 유용합니다.
  • skill 키를 추가하고 스킬 이름을 나열하여 서브에이전트에 스킬을 미리 로드할 수 있습니다. 메인 대화의 스킬과 달리, 여기서는 전체 스킬이 컨텍스트에 로드됩니다.

요약

컨텍스트 창을 깨끗하게 유지하는 것은 Claude Code로 생산성을 높이는 가장 좋은 방법 중 하나입니다. 서브에이전트를 사용하면 백그라운드에서 에이전트를 실행하여 무거운 작업을 처리하고, 메인 컨텍스트 창에는 결과만 반환할 수 있습니다.

더 깊이 알고 싶으신가요? 전용 강좌를 확인해 보세요: 서브에이전트 소개