클로드 코드 실전 팁 2편 - 멀티 에이전트 활용하기

클로드 코드 한 세션에 조사, 구현, 검증을 계속 쌓으면 로그와 파일 내용도 함께 늘어납니다. 대화가 길어질수록 정작 판단에 필요한 정보가 묻혀요.

멀티 에이전트는 이럴 때 씁니다. 결과만 필요한 작업은 별도 컨텍스트로 보내고 메인 세션에는 결정에 필요한 내용만 남깁니다.

이름보다 중요한 건 왜 컨텍스트를 분리하는지예요. 결과만 받아도 되는지, 작업자끼리 대화해야 하는지, 내가 직접 연 세션끼리 연결하려는지를 먼저 봅니다.

메인 에이전트에게 일을 계속 시키면 대화 기록과 작업 결과가 한 컨텍스트에 쌓입니다. 탐색 결과, 긴 로그, 다시 읽지 않을 파일 내용까지 남길 필요는 없어요. 이런 작업은 별도 에이전트에 맡기고 결론만 받아오면 메인 세션은 중요한 판단에 집중합니다.

서로 기다릴 필요가 없는 일은 여러 에이전트에 나눠 동시에 진행합니다. 조사 두 개를 따로 돌리거나 구현과 검토를 분리하는 식이에요. 앞 작업의 결과가 나와야 다음 작업을 시작할 수 있다면 병렬화해도 빨라지지 않습니다.

Subagent는 하나의 Claude Code 세션 안에서 별도 컨텍스트로 작업한 뒤 결과를 메인 에이전트에 돌려줍니다. 코드베이스 탐색, 로그 분석, 자료 조사처럼 중간 과정 전체를 메인 세션에 남길 필요가 없는 일에 잘 맞아요.

Claude Code가 작업에 맞는 Subagent를 알아서 쓰기도 하지만 원하는 방식으로 나눈다는 보장은 없습니다. 컨텍스트를 분리하고 싶다면 위임 범위와 가져올 결과를 직접 적는 편이 낫습니다.

결론, 근거, 다음 행동이 요약에 다 들어와 있으면 제대로 위임된 것입니다.

하나의 세션이 팀 리드를 맡고 나머지 팀원은 각자 독립된 컨텍스트에서 일하는 방식, 그게 Agent Teams입니다. 팀원들은 공용 작업 목록과 메시지로 발견한 내용을 서로 공유해요.

서로 다른 가설로 버그 원인을 조사하거나 프론트엔드와 백엔드처럼 작업 경계가 나뉘면서도 중간 조율이 필요한 일에 잘 맞아요. 단순히 결과 하나만 받아오면 되는 작업이라면 Subagent가 더 가볍습니다.

프론트엔드, 백엔드, 반대 가설로 담당이 나뉘고 팀원마다 서로 다른 내용을 보고하면 제대로 구성된 것입니다.

팀원마다 별도 Claude 인스턴스를 사용하므로 토큰 사용량과 조율 비용이 큽니다. 순차 작업이나 같은 파일을 함께 고치는 일에는 단일 세션이나 Subagent가 더 잘 맞아요.

Agent Teams가 리드 아래 팀원을 새로 만드는 방식이라면 Cross-session messaging은 이미 실행 중인 독립 세션을 그대로 연결합니다. 사용자가 따로 연 Claude Code 세션끼리 메시지를 주고받는 기능이에요.

한 세션의 결정 사항을 다른 세션에 넘기거나 별도 worktree에서 병렬 작업 중인 세션끼리 변경 사항을 알릴 때 유용합니다. 오래 걸리는 작업의 상태를 다른 세션에서 받아볼 때도 쓸 수 있어요.

macOS, Linux, WSL 2에서는 Claude Code v2.1.224 이상이 필요하고 네이티브 Windows에서는 v2.1.234 이상이 필요합니다. 지원되는 환경과 계정 조건을 만족하면 별도로 켤 설정은 없어요.

이 실습은 Cross-session messaging만 확인합니다. Subagent와 Agent Teams는 한 세션 안에서 시작하므로 목적과 동작 방식이 달라요.

작업이 짧거나 순서대로 진행해야 한다면 메인 세션 하나로 끝내는 편이 빠릅니다. 에이전트를 나누면 지시할 내용과 결과를 합치는 비용도 생겨요. 여러 작업이 정말 독립적인지, 분리해서 얻는 이점이 조율 비용보다 큰지 먼저 봐야 합니다.

기능을 아는 것보다 어떤 일을 메인 세션에 남기고 무엇을 다른 에이전트에 맡길지 가르는 판단이 더 중요합니다. 모닥불 바이브코딩 중급반에서는 바이브코딩 기본기부터 이런 에이전트 활용 방식까지 함께 다룹니다.