AI 하나로 부족할 때, /agents로 역할별 '보조 일꾼' 팀 붙이기

큰 기능을 만들 때, 메인 작업을 하면서 동시에 코드 검색도 하고 테스트도 짜야 해서 한 대화가 정신없이 산만해진 적 있나요? 사람 하나가 다 하면 느리고 헷갈리듯, AI 하나에 다 맡겨도 그래요. 그럴 때 '팀'을 붙이는 게 /agents입니다. 특정 역할을 맡은 작은 Claude(서브에이전트)들에게 곁가지 작업을 나눠 맡깁니다.

정의

/agents는 보조 일꾼(서브에이전트) 설정을 관리하는 명령입니다. 서브에이전트란 특정 역할을 맡아 곁가지 작업을 대신 처리하는 '작은 Claude'예요.

예를 들어 '코드 리뷰 전담', '리서치 전담'처럼 역할을 정해두면, 메인 작업은 본체가 진행하면서 곁가지 일은 전담 일꾼에게 맡길 수 있습니다. 사람으로 치면 큰 프로젝트에 역할별 팀원을 붙이는 거죠. 여러 일꾼을 동시에 돌릴 수도 있어 큰 작업을 빠르게 끝낼 수 있습니다.

사용법 (난이도별)

기초 — 관리 화면 열기

대화창에 이렇게 입력합니다.

/agents

입력하면 서브에이전트를 만들고 관리하는 화면이 뜹니다. 여기서 새 일꾼을 만들거나, 기존 일꾼의 역할을 수정하거나, 더 이상 필요 없는 걸 지울 수 있어요.

응용 — 역할별로 만들기

'코드리뷰 전담' 에이전트 만들기

이렇게 말로 시키면 특정 역할을 맡은 에이전트를 만들 수 있습니다. 코드 리뷰처럼 반복적으로 필요한 작업은 전담 일꾼을 따로 두면, 메인 작업을 방해하지 않고 그 역할만 깔끔하게 처리해요.

심화 — 여러 일꾼 병렬 운용

리서치 에이전트와 테스트 에이전트 동시 운용

여러 전문 일꾼을 동시에 돌릴 수 있습니다. 한쪽은 코드를 검색해 정리하고, 다른 쪽은 테스트를 작성하는 식으로 병렬 진행하면 큰 작업이 훨씬 빨라져요.

흔한 함정 — 곁가지·읽기 작업에 잘 맞습니다

/agents를 처음 쓰면 "모든 작업을 잘게 쪼개 에이전트에 맡기면 빠르겠지" 생각하기 쉬운데, 그렇지 않습니다. 서브에이전트는 명확한 역할과 정해진 출력 형식이 있는 작업, 특히 읽기 위주의 곁가지 작업에 가장 잘 맞아요.

예를 들어 "이 함수를 호출하는 곳을 전부 찾아줘", "이 서브시스템(하위 모듈)이 뭘 하는지 요약해줘" 같은 탐색·리서치 작업이 딱입니다. 이런 작업은 탐색 비용을 에이전트 내부에 가두니 메인 대화가 깔끔하게 유지돼요. 반대로 핵심 로직을 짜는 일까지 무작정 떠넘기면 오히려 관리가 복잡해지니, 곁가지부터 맡겨보세요.

실전 사례

큰 기능을 만들면서 코드 구조도 파악해야 하고 테스트도 짜야 했어요. 메인 대화에서 다 하려니 맥락이 산만해졌고요. 그래서 '리서치 전담'과 '테스트 작성 전담' 에이전트를 따로 뒀습니다.

리서치 에이전트와 테스트 에이전트 동시 운용

리서치 에이전트가 기존 코드 구조를 정리하는 동안 테스트 에이전트가 테스트를 짰고, 저는 메인 작업에만 집중할 수 있었습니다. 혼자 다 하던 일을 병렬로 나누니 훨씬 빠르고 머리도 덜 복잡했어요.

이렇게 더 씁니다

• 역할별 에이전트: '코드리뷰 전담', '리서치 전담'처럼 전문 일꾼을 따로 둡니다.
• 병렬 분담: 여러 에이전트를 동시에 돌려 큰 작업을 빠르게 끝냅니다.
• 만드는 법: /agents 화면에서 만들거나, 마크다운(.md) 파일로 직접 작성할 수도 있습니다.
• 대규모 작업과 결합: /batch(배치 — 코드 전반을 한 번에 분담 처리하는 명령)와 묶어 큰 작업을 나눠 처리합니다.

팁: 리뷰어 역할 에이전트는 명확한 체크리스트, 제한된 도구, 정해진 출력 형식을 줄수록 잘 동작합니다. "이런 항목만 점검하고, 결과를 이 형식으로 보고해"처럼 역할을 좁고 분명하게 정해주세요. 만들기 전 참고할 설정 모음도 공개돼 있으니 살펴보면 좋습니다.

다른 사람들은 이렇게 씁니다

• 리뷰어 에이전트는 명확한 체크리스트·제한된 툴·정해진 출력 형식에 특히 잘 맞는다. — Claude Code Subagents (Builder.io)
• '함수 호출처 전부 찾기', '서브시스템 동작 요약'처럼 읽기 위주 리서치에 최적이다. — Best practices for subagents (PubNub)
• 100개 이상의 즉시 쓰는 서브에이전트 설정 모음(만들기 전 참고용). — awesome-claude-code-subagents (VoltAgent)

정리

핵심은 한 문장입니다. 큰일은 혼자 말고 전문 일꾼에 나눠라. /agents로 역할별 서브에이전트를 만들어 곁가지·리서치 작업을 맡기고, 여러 일꾼을 병렬로 돌리면 큰 작업이 빨라집니다. 명확한 역할과 출력 형식을 줄수록 잘 동작해요.

기준: Claude Code v2.1.154 (2026.05)