Claude Code의 서브 에이전트를 3개로 분리하여 개인 개발을 진행하는 설정 방법
요약
개인 개발 프로젝트에서 Claude Code 에이전트 하나만으로는 설계, 구현, 검토 등 모든 단계를 완벽하게 처리하기 어렵습니다. 따라서 효율적인 개인 개발 환경을 구축하기 위해 '아키텍트(설계)', '구현자(테스트/실행)', '리뷰어(검토)'의 세 가지 전문 에이전트로 역할을 분할하여 운영하는 방법을 안내합니다. 이 설정은 각 역할별로 별도의 마크다운 파일을 지정된 경로(`~/.claude/agents/`)에 배치하고, 세션 재시작을 통해 적용할 수 있습니다.
핵심 포인트
- 개인 개발 시 단일 에이전트의 한계를 극복하기 위해 역할을 분리하는 것이 중요합니다.
- 최소한 3개의 전문 에이전트로 역할 분담을 추천합니다: architect (설계), implementer (구현/테스트), reviewer (검토).
- 에이전트는 `~/.claude/agents/` 디렉터리에 개별 마크다운 파일로 설정해야 합니다.
- 파일 수정 후에는 반드시 세션을 재시작하여 변경 사항을 적용해야 합니다.
요약 (TL;DR)
- 개인 개발 시 Claude Code 1 에이전트 운영은 한계가 있음 → 3개로 분할
- 역할 분담: architect(설계) / implementer(구현・테스트) / reviewer(리뷰어)
- 설정 파일(
~/.claude/agents/<name>.md) 샘플 포함 - 주의할 점: 파일을 직접 수정했을 경우 세션 재시작 필수
혼자 모든 것을 처리하게 하면, 특히 리뷰가 부실해지기 쉽습니다.
자신이 작성한 코드를 스스로 검토하는 구조에서는 자신의 편견을 벗어나기가 어렵습니다.
게다가 구현 과정에서 요구사항 변경 사항이 제대로 기록되지 않거나, 프로젝트가 어디까지 진행되었는지 다른 세션에서는 알 수 없게 되는 경우도 있습니다...
Best Practice는 테스터, 마케터, UX 등 더 세분화되지만, 개인 개발 환경에서 4개의 제품을 병행(예시)한다는 전제 하에 최소한 3개로 압축했습니다.
자세한 판단 로직은 Zenn 아티클에 작성했습니다.
이 글에서는 설정 방법에만 초점을 맞춥니다.
- 세 개의 파일을
~/.claude/agents/에 배치합니다.
~/.claude/agents/
├── architect.md
├── implementer.md
...
WSL의 경우 /home/<user>/.claude/agents/ 입니다.
Windows와 WSL은 별도의 ~/.claude/ 를 가지므로, 사용하는 환경에 배치해야 합니다.
---
name: architect
description: 신규 제품의 요구사항 정의를 진행합니다. 시장 조사・기능 도출・수용 시나리오・기술 선정・일정 계획까지 담당합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기