[AI] 클로드코드 서브 에이전트 사용 방법 (SubAgent, agents, ClaudeCode, 병렬 처리)

서브 에이전트란?

• 특정 작업 유형을 처리하기위해 클로드코드에서 사용할 수 있는 AI 어시스턴트
• 자주 쓰이는 툴이나, 프롬프트에 사용
  • ex) 코드 리뷰, 성능 병목 지점 탐색, 단위 테스트 누락 확인

서브 에이전트가 필요한 이유

• 에이전트 없이 하나로만 AI를 사용한다면 context가 오염됨 (토큰 효율성 하락)
• 비슷한 작업에 관한 재사용에 용이
• 아래와 같이 병렬 작업이 가능

ex. 병렬작업 (https://tech.hyperithm.com/claude_code_guides_2)

에이전트 만드는 방법

(vscode 사용하여 설명)

• 클로드코드 > /agents 입력 후 엔터

• terminal에서 사용할수 있기에 1번 선택된 상태로 엔터

• 기다리면 자동으로 터미널 명령어 창에 claude /agents가 입력됨

• oh-my-claudecode를 사용하고 있어서 여러개가 나오는데, 새로 만들어볼 것이므로 선택되어 있는 Create new agent 선택 후 엔터
  • oh-my-claudecode는 이전 포스팅 글 참고

• 설치 위치 선택 (자율이지만 간단히 보기 위해 1. Project 선택
  • Project: 해당 프로젝트에만 반영
  • Personal: 전역적으로 사용할 수 있도록 반영

• 1번 클로드코드로 생성 선택

• 설명을 입력
  • 예시) "코드를 분석하여 사람이 이해할 수 있도록 쉽게 자연어로 알려주는 분석 에이전트"

• 툴 입력
  • 사실상 에이전트에게 부여할 권한에 해당
  • Read-only tools (읽기 전용 도구): 파일 내용을 읽거나 데이터를 조회하는 기능. 시스템을 변경하지 않고 정보를 가져오기만 하므로 안전
  • Edit tools (편집 도구): 파일을 수정, 삭제하거나 코드를 변경하는 기능. 에이전트가 직접 결과물을 만들어내야 할 때 필수
  • Execution tools (실행 도구): 작성한 코드를 실제로 실행하거나 터미널 명령어를 입력하는 기능. 프로그램의 동작 여부를 확인할 때 사용
  • MCP tools (Model Context Protocol): 다양한 외부 서비스나 데이터베이스를 표준화된 방식으로 연결해주는 도구. (예: Google Drive, Slack, GitHub 연동 등)
  • Other tools (기타 도구): 위 분류에 속하지 않는 웹 검색이나 특정 API 호출 기능 등이 포함

(편의상 선택되어 있는 All tools을 적용하여 Continue에 커서를 대고 엔터)

• 모델 선택 (디폴트 Sonnet)

• 에이전트가 사용할 색 선택

• 최종 리뷰 -> Enter 누르면 완성

• 최종 Agents목록에서 위에서 만든 "code-explainer" 생성된 것을 볼 수 있음

에이전트 사용 방법

• 클로드 챗에 골뱅이를 붙이고 이름을 입력하면 리스트에 등장

• 엔터를 누르면 적용됨

• 병렬로 진행되게끔 하는 방법
  • 아래처럼 에이전트들을 부른 후 여러줄에 작성하면 사용이 가능

@.claude/agents/code-explainer.md: A부분 코드 분석해줘
@.claude/agents/create-flow-chart.md: B부분 플로우차트 그려줘

* 참고

- https://tech.hyperithm.com/claude_code_guides_2