이 장에서는 서브에이전트를 직접 만들고, 잘 만들어진 에이전트를 가져와 쓰는 방법을 다룹니다.

1. /agents로 만들기

서브에이전트는 /agents 명령으로 만들고 관리합니다.

/agents

새 에이전트를 만들 때 가장 먼저 저장 위치를 묻습니다.

특정 프로젝트에서만 쓸 거라면 프로젝트를, 어디서나 쓸 거라면 사용자를 선택합니다.

다음으로 클로드와 함께 에이전트를 만들지 선택할 수 있습니다. 이 옵션을 고르면, 어떤 일을 시키고 싶은지 자연어로 설명하기만 하면 클로드가 적절한 시스템 프롬프트와 설정을 갖춘 에이전트를 대신 작성해줍니다. 도구 접근 권한 등은 기본값(엔터)으로 넘어가도 됩니다.

만들고 나면 목록에서 선택해 수정하거나 삭제할 수 있습니다.

2. 에이전트 파일 확인

생성된 에이전트는 다음 위치에 마크다운 파일로 저장됩니다.

.claude/agents/      # 프로젝트
~/.claude/agents/    # 사용자

파일 안에는 이 에이전트의 역할, 사용할 도구, 시스템 프롬프트가 정의되어 있습니다. 직접 열어 다듬을 수도 있습니다.

3. 서브에이전트 사용하기

서브에이전트는 두 가지 방식으로 동작합니다.

• 자동 위임: 클로드가 작업 성격을 보고 적절한 서브에이전트에게 알아서 위임
• 명시적 호출: "보안 검토 에이전트로 이 코드를 점검해줘"처럼 직접 지목

예를 들어 코드 작업을 마친 뒤 이렇게 지시할 수 있습니다.

방금 작성한 코드를 code-simplifier 에이전트로 단순화해줘.

서브에이전트는 별도 컨텍스트에서 작업하므로, 자유롭게 탐색하고 시행착오를 거쳐도 메인 세션은 깔끔하게 유지됩니다.

4. 만들기보다 가져오기

직접 만드는 것보다, 이미 잘 만들어진 에이전트를 가져와 쓰는 편이 효율적일 때가 많습니다. 많은 개발자가 자신이 쓰는 서브에이전트를 공개하고 있습니다. 공개된 컬렉션을 가져와 우리 프로젝트에 맞게 다듬어 쓰는 것을 권합니다.

• 공식 문서: https://docs.claude.com/en/docs/claude-code/sub-agents
• 커뮤니티 서브에이전트 모음 예시: https://github.com/dl-ezo/claude-code-sub-agents

5. 정리

• 서브에이전트는 /agents로 만들고 관리합니다.
• 프로젝트/사용자 레벨로 저장 위치를 정합니다.
• 자동 위임 또는 명시적 호출로 사용합니다.
• 핵심 가치는 별도 컨텍스트로 메인 세션을 깨끗하게 유지하는 것입니다.
• 직접 만들기보다 공개된 에이전트를 활용하는 것도 좋은 전략입니다.

다음 챕터에서는 클로드 코드를 외부 세계와 연결하는 MCP를 다룹니다.