서브에이전트로 클로드 코드 성능 높이는 법

클로드 코드(Claude Code) 같은 AI 코딩 에이전트에서 더 나은 결과를 얻는 열쇠로 '서브에이전트'를 꼽은 단계별 실전 가이드가 나왔다. 개발 블로그 '소프트웨어 더 하드 웨이(Software the Hard Way)'에 7월 13일 게재된 이 글은 스펙 주도 개발 같은 추상적 담론 대신, 개인 개발자가 바로 따라 할 수 있는 절차에 초점을 맞췄다. 저자는 클로드 코드를 6개월간 써 온 개발자다.

배경 — 컨텍스트 창이 곧 작업 품질이다

글의 출발점은 컨텍스트 창 관리다. 에이전트는 프롬프트를 주고받고 작업을 수행할 때마다 컨텍스트 창을 소모하는데, 창이 차오를수록 에이전트의 성능은 눈에 띄게 떨어진다. 사람의 인지 부하와 닮은 현상이다. 그래서 무관한 새 작업을 시작하기 전 /clear로 창을 비우는 것이 기본기다. 다만 무작정 비우면 1분 전 대화도 기억 못 하는 상대와 일하는 꼴이 되므로, 중요한 것은 남기고 낭비만 줄이는 전략이 필요하다는 것이다.

핵심 짚어보기 — 서브에이전트 활용 3원칙

첫째, 탐색 작업의 위임이다. 특정 기능 관련 정보를 코드베이스에서 찾을 때 메인 에이전트가 직접 검색과 파일 읽기를 반복하면 창이 잡동사니로 가득 찬다. 대신 검색 전담 서브에이전트를 띄우면 쓸모없는 정보는 서브에이전트의 창에만 쌓이고, 메인 에이전트에는 정제된 핵심만 돌아온다.

둘째, 중간 산출물의 파일화다. 여러 에이전트가 결과를 말로 전달하다 보면 '전화 게임'처럼 정보가 왜곡된다. 각 에이전트가 결과를 텍스트 파일로 남기게 하면 다른 에이전트가 원본을 직접 읽을 수 있고, 사람이 각 단계를 감사하고 오류의 뿌리를 찾기도 쉬워진다.

셋째, 신선한 시각의 활용이다. 같은 에이전트에 같은 지시를 줘도 결과가 달라지는 비일관성을 역이용하는 것인데, 에이전트는 자기 결과물을 리뷰할 때 방어적으로 굴지만 새 컨텍스트로 띄운 서브에이전트에 '다른 에이전트의 작업'이라며 검토를 맡기면 같은 모델이라도 오류를 더 잘 찾아낸다. 대부분의 개발팀이 PR 리뷰를 작성자가 아닌 사람에게 맡기는 것과 같은 원리다.

1인기업 실전 적용 포인트

• 코드베이스 탐색·자료 조사는 기본적으로 서브에이전트에 위임하고, 메인 창은 판단과 종합에만 쓴다.
• 에이전트 산출물은 마크다운 파일로 남기게 하라. 에이전트 간 전달 정확도가 오르고, 나중에 사람이 검수할 수 있는 감사 기록이 된다.
• '만드는 에이전트'와 '검수하는 에이전트'를 분리하라. 코드만이 아니라 블로그 초안, 마케팅 카피 자동화에도 그대로 통하는 구조다.
• 무관한 작업으로 전환할 때는 /clear부터. 돈 안 드는 가장 쉬운 성능 개선이다.

전망 / 주의점

저자 스스로 새 모델과 에이전트가 나오면 이 설정은 금세 낡을 것이라고 인정한다. 다만 컨텍스트 절약, 산출물 파일화, 교차 검증이라는 원칙 자체는 도구가 바뀌어도 유효할 가능성이 크다. 서브에이전트를 남발하면 오히려 조율 비용이 커질 수 있으니, 작업 덩어리가 충분히 클 때 쪼개는 것이 요령이다.

출처: Software the Hard Way (https://software.rajivprab.com/2026/07/13/using-subagents-to-improve-claude-code/)