클로드 코드가 하나의 대화 안에서 모든 일을 처리하다 보면, 작업이 길어질수록 앞의 내용을 잊거나 품질이 떨어질 수 있습니다. 이럴 때 써먹는 것이 서브에이전트(subagent) 위임입니다. 팀장이 각 전문가 팀원에게 일을 나눠 맡기는 것과 같습니다. 클로드가 독립된 컨텍스트로 별도 에이전트를 띄워 해당 작업만 집중적으로 처리하게 합니다.
서브에이전트에게 위임하기
별도 설정 없이 자연어로 '동시에', '병렬로', '각각 맡겨서' 같은 표현을 쓰면 클로드가 내부적으로 작업을 나눠 처리합니다. 서로 독립적인 작업일수록 효과가 큽니다.
두 작업을 병렬로 위임하는 예시
아래 두 작업을 동시에 진행해 줘.
작업 A: src/components/ 폴더 전체를 훑어서 console.log가 남아 있는 파일 목록을 뽑아 줘.
작업 B: src/utils/ 폴더에서 어떤 파일도 import하지 않는 사용되지 않는 함수 목록을 만들어 줘.
두 결과를 합쳐서 우선순위 순으로 정리해 줘.커스텀 /명령 만들기
.claude/commands/ 폴더에 마크다운 파일을 만들면 대화창에서 쓸 수 있는 나만의 슬래시 명령어가 생깁니다. 예를 들어 .claude/commands/review.md 파일을 만들면 /review를 입력할 때마다 그 파일에 적힌 지시를 자동으로 실행합니다. 긴 프롬프트를 매번 다시 입력할 필요가 없어집니다.
.claude/commands/review.md — 나만의 /review 명령 만들기
# 코드 리뷰
현재 브랜치의 변경 사항을 깐깐한 시니어 개발자 시각으로 리뷰해 줘.
체크 항목:
- 버그 및 엣지 케이스 누락 여부
- 보안 취약점 (입력 검증, 민감 정보 노출)
- 불필요한 복잡도 또는 중복 코드
- 타입 안전성 (any 사용, 타입 누락)
심각도(높음 / 중간 / 낮음)를 붙여서 목록으로 정리해 줘.
칭찬은 생략하고 개선이 필요한 부분만 알려 줘.
전체 품질을 10점 만점으로 평가해 줘.커스텀 명령 폴더와 파일 만들기
# 명령 폴더 생성 (없으면)
mkdir -p .claude/commands
# 원하는 명령 파일 만들기
touch .claude/commands/review.md
touch .claude/commands/health.md
# 클로드 코드 대화창에서 사용
# /review
# /health병렬 분석으로 속도 올리기
세 가지 독립 분석을 동시에 요청하는 예시
세 가지를 병렬로 조사해 줘.
1. package.json에서 1년 이상 업데이트가 없는 의존성 목록
2. 테스트 파일이 전혀 없는 src 폴더 내 파일 목록
3. TODO 또는 FIXME 주석이 남아 있는 파일과 줄 번호
조사가 끝나면 처리 우선순위 순서로 정리해 줘.커스텀 명령 파일 안에 $ARGUMENTS를 넣으면 실행할 때 인자를 받을 수 있습니다. 예를 들어 /deploy staging, /deploy production처럼 환경 이름을 인자로 넘기는 명령을 파일 하나로 만들 수 있습니다. 반복 워크플로우를 명령 하나로 줄이는 데 유용합니다.
병렬로 여러 에이전트가 같은 파일을 동시에 수정하면 충돌이 납니다. 병렬 처리는 읽기·분석·독립된 파일 작업에 적합하고, 같은 파일을 수정하는 작업은 순서대로 진행해야 합니다. 헷갈리면 먼저 계획을 세우게 한 뒤 충돌 가능성을 확인하세요.