Claude Code 서브에이전트 설정법: 혼자 개발할 때 더 똑똑해지는 방법

개발을 할 때 Claude Code를 사용해보신 적 있나요? 화면만 좀 바꿔보려던 게 어느새 로그인도 안 되고, 데이터도 안 불러와지고, 대화창이 뒤죽박죽 엉켜버리는 경험… 한 번쯤 있죠? 그런데, 최근에 제가 발견한 한 가지 기능 덕분에 개발이 정말 쉬워졌습니다. 바로 "서브에이전트" 기능입니다! 이 글에서 서브에이전트를 활용해 혼자서도 마치 전문 개발팀이 된 것처럼 Claude Code를 활용하는 법을 알려드릴게요.

Claude Code 서브에이전트란 무엇일까?

Claude Code의 서브에이전트 기능은 각 분야에 특화된 가상 멤버를 만드는 겁니다. 즉, 프론트엔드, 백엔드, 코드 리뷰어 등 각기 다른 역할을 가진 전문가들을 직접 생성해서, 독립적인 대화창에서 자신의 업무만 맡게 할 수 있어서 메인 대화창이 깔끔하게 관리됩니다. 혼자서도 마치 협업하는 느낌을 누릴 수 있죠.

서브에이전트 만들기: 실전 설정법

직접서브에이전트를 만들어보려면 터미널에서 /agents를 입력하세요. 처음엔 범용 에이전트 하나만 보일 거예요. 여기서 "Create new agent" 버튼을 클릭한 뒤, 프로젝트 단위로 생성하고 "Generate with Claude"를 선택합니다.
예시 설명란에 이렇게 입력할 수 있습니다: "넥스트JS와 리액트에 특화된 코드 리뷰어, 성능 최적화와 버그 찾기가 전문." Claude가 이 설명을 바탕으로 자동으로 최적화된 에이전트 프롬프트를 만들어줍니다.

에이전트 권한과 외형까지 내 마음대로

서브에이전트마다 읽기 전용 권한, 전체 권한 등 세부 설정이 가능합니다. 예를 들어, 코드만 검토하는 역할에는 모든 걸 볼 수만 있고, 직접 수정은 막아둘 수 있어요. 각각의 에이전트에 별도의 색상을 지정해놓으면 작업하면서 누가 무슨 일을 하고 있는지 쉽게 구분됩니다. 백엔드 담당은 오렌지, 프론트엔드 담당은 사이언, 코드 리뷰어는 초록색 이런 식이죠.

에이전트 프롬프트 수정하는 방법

서브에이전트를 만든 뒤 기능을 변경하고 싶을 땐, 프로젝트 루트 디렉터리의 .claude/agents/에이전트이름.md 파일에서 내용을 직접 수정할 수 있습니다. 예를 들어 "리액트 컴포넌트 최적화와 테일윈드 스타일링 전문가"와 같이 더 구체적인 역할로 변경해서 바로 적용할 수 있어요.

Claude Code 오케스트라처럼 활용하는 방법

예를 들어 게시판 코드 검토가 필요하면 "초록색 에이전트, 게시판 코드 리뷰 부탁해!"라고 입력할 수 있습니다. 그러면 SQL 인젝션, XSS, 비밀번호 평문 저장 등 숨어있던 취약점을 꼼꼼하게 찾아줍니다. 이어서 "오렌지 에이전트가 백엔드 문제를 고치고, 사이언 에이전트가 UI를 개선하고, 마지막 초록색 에이전트가 전체 재검토해줘"라고 요청하면 각각의 에이전트가 주어진 일만 하고 자연스럽게 바통을 넘깁니다. 혼자서 하려면 몇 시간 걸릴 일을 5분 만에 끝낼 수 있습니다.

핵심은 '분업'과 '자동화'

에이전트의 주요 장점은 골뱅이(@)로 특정 전문가를 직접 호출하거나, 메인 에이전트가 알아서 일을 나눠준다는 점입니다. 덕분에 개발자는 개발, 검토, UI 개선 등 복잡한 작업도 팀장처럼 효율적으로 분배할 수 있습니다. 진짜 팀장이 된 것 같아 자신감도 오릅니다!

마지막으로, Claude Code 서브에이전트 활용의 핵심은 혼자서도 체계적이고 효율적으로 일하는 환경을 만드는 것에 있습니다. 실제로 써보면 "도대체 왜 이제야 알았나?" 싶을 만큼 작업이 깔끔하고 빨라집니다. 오늘부터 여러분도 Claude Code의 서브에이전트 기능으로 개발 효율과 재미, 모두 잡아보세요!

출처 및 참고 :

https://www.youtube.com/watch?v=WTjQpjDHssE