혼자 일하며 서브에이전트 3개를 동시에 돌리는 법
서브에이전트를 하나씩 순서대로만 쓰며 기다리는 분께 맞는 글입니다. 서브에이전트 정의, 역할 분담, 구체적으로 요청하는 3단계와 파일이 겹치는 실패를 피하는 체크리스트를 정리했습니다.
서브에이전트 여러 개를 동시에 돌리면 혼자서도 더 많은 일을 같은 시간에 진행할 수 있지만, 사람을 대신하는 것은 아닙니다. 서로 겹치지 않게 나누고, 개수와 범위를 구체적으로 요청하고, 결과는 반드시 직접 확인해야 합니다.
이 작업을 서브에이전트 세 개로 나눠서 동시에 처리해 줘. - 조사, 제작, 검수처럼 성격이 다른 역할로 나눠 줘 - 서브에이전트끼리 같은 파일이나 같은 자원을 건드리지 않게 범위를 정해 줘 - 각 서브에이전트가 끝나면 요약만 돌려주고, 나는 실제 결과를 확인할 수 있게 해 줘
서브에이전트는 지금 하는 대화와는 별개의 컨텍스트 창(자기만의 작업 공간)에서 특정 작업을 맡아 처리하고, 끝나면 요약만 돌려주는 보조 작업자입니다.
공식 문서의 표현으로는 "지금 작업하는 메인 대화 안에서 만들어지는 추가 작업자"입니다.
혼자 일하면서도 서브에이전트 여러 개를 동시에 굴리면, 한 번에 하나씩 순서대로 하는 것보다 더 많은 일을 같은 시간에 진행할 수 있습니다. 다만 "직원 3명"이라는 표현처럼 사람 손을 완전히 대신하는 건 아닙니다. 결과 확인과 최종 판단은 여전히 사람의 몫입니다.
왜 필요한가요
저는 처음엔 서브에이전트를 하나씩 순서대로만 썼습니다. 조사 하나 끝나야 다음 작업을 시켰습니다. 그러다 보니 정작 제가 할 일은 서브에이전트가 끝날 때까지 기다리는 것뿐이었습니다.
공식 문서는 "요청이 구체적일수록 병렬 처리가 잘 된다"고 안내합니다. "이 작업을 나눠서 하라"처럼 막연하게 시키는 것보다 "모듈별로 서브에이전트 세 개를 써라"처럼 숫자와 범위를 명확히 하는 쪽이 효과적이라는 뜻입니다.
Claude는 기본적으로 병렬 실행에 보수적으로 접근하므로, 진짜 여러 작업을 동시에 벌이고 싶으면 그렇게 하라고 구체적으로 요청해야 합니다.
서브에이전트 정의하기
.claude/agents/ 폴더(프로젝트 전용)나 ~/.claude/agents/(모든 프로젝트 공용)에 마크다운 파일로 만듭니다. 각 파일에는 이름, 역할, 쓸 수 있는 도구, 사용할 모델을 정합니다.
역할을 나눠 맡기기
조사·제작·검수처럼 성격이 다른 작업을 각각 다른 서브에이전트에 맡깁니다. 같은 역할 두 개를 동시에 돌리면 결과가 겹치기만 하고 시간은 그대로 듭니다.
구체적으로 요청하기
"이 세 파일을 각각 다른 서브에이전트가 검토하게 해줘"처럼 개수와 범위를 명확히 말합니다. 막연한 요청은 병렬로 처리되지 않을 수 있습니다.
체크리스트
서브에이전트를 여러 개 켜기 전에 아래를 확인합니다.
자주 하는 실수
저는 처음에 서브에이전트 세 개를 띄워 놓고 자리를 비웠습니다. 돌아와 보니 세 개 다 같은 파일을 건드리고 있어서 결과가 뒤섞여 있었습니다.
서브에이전트마다 다른 컨텍스트에서 일한다고 해서, 같은 파일을 동시에 고쳐도 안전한 건 아니었습니다. 그다음부터는 서로 겹치지 않는 파일·주제로만 나눠서 맡깁니다. 겹칠 위험이 있으면 하나가 끝난 뒤에 다음을 시작합니다.
자주 묻는 질문
서브에이전트를 몇 개까지 동시에 돌릴 수 있나요?
공식 문서에 정해진 상한을 명시한 부분은 확인하지 못했습니다. 다만 여러 세션·서브에이전트를 동시에 쓰면 토큰 사용량이 함께 늘어난다는 점은 공식적으로 안내돼 있습니다.
서브에이전트가 정말 사람 직원을 대신하나요?
아닙니다. 결과를 검수하고 최종 판단을 내리는 건 여전히 사람의 역할입니다. 서브에이전트는 무거운 작업을 맡아 처리하고 요약만 돌려주는 역할입니다.
같은 서브에이전트를 여러 개 동시에 돌려도 되나요?
같은 자원(같은 파일 등)을 건드리지 않는다면 가능합니다. 겹치는 자원이 있다면 순서를 나누는 게 안전합니다.
정리
서브에이전트 여러 개를 동시에 돌리는 힘은 "일을 나눠 맡긴다"는 데서 나오지, "사람을 대신한다"는 데서 나오지 않습니다. 겹치지 않게 나누고, 구체적으로 요청하고, 결과는 반드시 확인하면 됩니다.