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

Sub-agents are specialized assistants that Claude can delegate tasks to. 서브에이전트는 Claude가 작업을 위임할 수 있는 전문 보조 에이전트입니다. Each sub-agent runs in its own conversation contacts window with a custom system prompt that you define. 각 서브에이전트는 직접 정의한 커스텀 system prompt가 포함된 독립적인 컨텍스트 윈도우에서 실행됩니다. When finished, it returns a summary to the main thread while all the intermediate work stays isolated. 작업이 완료되면 메인 스레드에 요약을 반환하고, 중간 작업은 모두 격리된 상태로 유지됩니다. One of the main advantages of sub-agents is that they help manage context window usage. 서브에이전트의 주요 장점 중 하나는 컨텍스트 윈도우 사용량을 효과적으로 관리한다는 점입니다. When you chat with Claude Code, you're adding context to the main context window. Claude Code와 대화하면 메인 컨텍스트 윈도우에 컨텍스트가 계속 쌓입니다. Every tool call and its results get stored in this main context window. 모든 도구 호출과 그 결과가 이 메인 컨텍스트 윈도우에 저장됩니다. And so, when Claude uses a sub-agent, a separate window starts. Claude가 서브에이전트를 사용하면 별도의 윈도우가 시작됩니다. The sub-agent receives two inputs, a custom system prompt from your configuration file, and a task description written by the parent or parent agent based on what you ask for. 서브에이전트는 두 가지 입력을 받습니다. 하나는 설정 파일의 커스텀 system prompt이고, 다른 하나는 요청에 따라 상위 에이전트가 작성한 작업 설명입니다. The sub-agent then works autonomously. 이후 서브에이전트는 자율적으로 작동합니다. When it reads files, edits files, or uses tools, none of these will appear in the main conversation. 파일을 읽거나 편집하거나 도구를 사용할 때, 그 내용은 메인 대화에 나타나지 않습니다. Just a summary is returned back. 요약만 반환됩니다. The entire sub-agent conversation then gets completely discarded. 서브에이전트의 전체 대화는 완전히 폐기됩니다. Consider a task like investigating how the payment system works in an unfamiliar code base. 낯선 코드베이스에서 결제 시스템이 어떻게 작동하는지 조사하는 작업을 생각해 보세요. Maybe you're trying to use Claude Code to figure out which service handles refunds. Claude Code를 사용해 어떤 서비스가 환불을 처리하는지 파악하려 한다고 가정해 봅시다. Well, without a sub-agent, Claude might read 15 files, run several searches, and trace through multiple function calls. 서브에이전트 없이는 Claude가 파일 15개를 읽고, 여러 번 검색하고, 여러 함수 호출을 추적할 수 있습니다. All of that context fills your context window, even if you only needed one single fact, which service handles refunds. 그 모든 컨텍스트가 윈도우를 채우게 됩니다. 정작 필요한 건 어떤 서비스가 환불을 처리하는지라는 단 하나의 사실인데도요. With a sub-agent, you get the answer without the journey. 서브에이전트를 사용하면 과정 없이 답을 얻을 수 있습니다. The sub-agent explores, discovers the answer, and returns a focused summary, keeping your main context clean. 서브에이전트가 탐색하고 답을 찾아 집중된 요약을 반환하므로, 메인 컨텍스트는 깔끔하게 유지됩니다. But, the main window loses visibility into how the sub-agent reaches its conclusions and what it discovered along the way. 단, 메인 윈도우는 서브에이전트가 어떻게 결론에 도달했는지, 그리고 과정에서 무엇을 발견했는지는 알 수 없습니다. Claude Code includes several built-in sub-agents that you can use immediately, like the general-purpose sub-agent, used for multi-step tasks that require both exploration and action. Claude Code에는 즉시 사용 가능한 기본 서브에이전트가 여러 개 있습니다. 탐색과 실행이 모두 필요한 다단계 작업에 사용되는 범용 서브에이전트가 그 예입니다. The explore sub-agent, used for fast searching of code bases. 코드베이스를 빠르게 검색하는 explore 서브에이전트. The plan sub-agent, used during plan mode for research and analysis of your code base before presenting a plan. 플랜을 제시하기 전에 코드베이스를 조사하고 분석하는 플랜 모드용 plan 서브에이전트. And you can also create your own sub-agents with custom system prompts and tool access. 커스텀 system prompt와 도구 접근 권한을 설정해 직접 서브에이전트를 만들 수도 있습니다. Sub-agents like Claude Code break work into focused pieces, keep your main context window clean, and bring back just what you need, whether you're using the built-in ones or creating your own. Claude Code 같은 서브에이전트는 작업을 집중된 단위로 나누고, 메인 컨텍스트 윈도우를 깔끔하게 유지하며, 기본 제공 서브에이전트를 쓰든 직접 만들든 필요한 것만 가져다 줍니다. They're a practical way to get more out of longer Claude Code sessions. Claude Code 세션을 더 길고 효율적으로 활용하는 실용적인 방법입니다.