서브에이전트
Claude는 작업을 서브에이전트에 위임하여 작업을 세분화하고 구성 요소 작업을 병렬로 실행함으로써 컨텍스트 관리를 개선할 수 있습니다. 각 서브에이전트는 자체적으로 격리된 컨텍스트 창에서 작동합니다.
작동 방식
Claude Code에서 컨텍스트를 관리하는 것은 중요합니다. 컨텍스트 창의 많은 부분은 코드베이스를 탐색하는 도구 호출이나 리서치를 위한 웹 검색 실행과 같은 작업에 소비됩니다. Claude가 그러한 탐색 과정에서 발견하는 내용이 항상 개발 중인 주요 기능과 관련이 있는 것은 아닙니다.
바로 여기서 서브에이전트가 등장합니다. Claude는 "이 코드베이스를 탐색해줘"와 같은 작업을 처리하기 위해 서브에이전트를 생성합니다. 서브에이전트는 자체 컨텍스트 창으로 병렬로 실행되어 모든 탐색 작업을 수행하고, 완료되면 발견한 내용을 요약하여 Claude에게 반환합니다.
결과적으로, 답을 찾는 데 걸린 전체 과정이 메인 컨텍스트를 어지럽히지 않으면서도 원하는 답을 얻을 수 있습니다.
나만의 서브에이전트 만들기
서브에이전트는 YAML 프런트매터가 포함된 Markdown 파일로 정의됩니다. 가장 쉽게 시작하는 방법은 Claude가 직접 생성하도록 하는 것입니다. 원하는 서브에이전트와 저장할 위치를 설명하세요:
.claude/agents/ 에 버그와 가독성을 검토하는 code-reviewer 서브에이전트를 생성하세요. 읽기 전용으로 만드세요.
.claude/agents/에 있는 서브에이전트는 현재 프로젝트에서 작동하며, ~/.claude/agents/에 있는 서브에이전트는 모든 프로젝트에서 작동합니다. 세션을 시작할 때 선택한 폴더가 존재하지 않았다면, 새 서브에이전트를 로드하기 위해 Claude Code를 재시작하세요.
Claude는 서브에이전트의 이름, 설명, 프롬프트를 생성합니다. 이는 또한 사용자가 제공한 프롬프트를 기반으로 Claude가 언제 서브에이전트를 호출해야 하는지를 알려줍니다.
추가 커스터마이징
서브에이전트는 더 다양하게 커스터마이징할 수 있습니다. 주요 기능은 다음과 같습니다:
- 영구 메모리(Persistent memory)를 사용하면 서브에이전트가 대화 전반에 걸쳐 메모리를 유지할 수 있습니다. 동일한 프로젝트에서 지속적으로 사용하는 경우 매우 유용합니다.
skills키를 추가하고 Skills 이름을 나열하여 서브에이전트에 Skills를 미리 로드(Preload skills)할 수 있습니다. 메인 대화에서의 Skills와 달리, 여기서는 전체 Skill이 컨텍스트에 로드된다는 점에 유의하세요.
요약
컨텍스트 창을 깔끔하게 유지하는 것은 Claude Code에서 생산성을 유지하는 가장 좋은 방법 중 하나입니다. 서브에이전트를 사용하면 백그라운드에서 에이전트를 실행하여 무거운 작업을 처리하고 메인 컨텍스트 창에는 답만 반환할 수 있습니다.
더 깊이 알아보고 싶으신가요? 전용 코스를 확인해보세요: 서브에이전트 소개(새 탭에서 열림)