서브에이전트(Claude Code)

 

https://code.claude.com/docs/ko/sub-agents

사용자 정의 subagent 만들기 - Claude Code Docs

Subagent는 특정 유형의 작업을 처리하는 특화된 AI 어시스턴트입니다. 각 subagent는 자체 컨텍스트 윈도우에서 실행되며 사용자 정의 시스템 프롬프트, 특정 도구 액세스 및 독립적인 권한을 가집니다. Claude가 subagent의 설명과 일치하는 작업을 만나면 해당 subagent에 위임하고, subagent는 독립적으로 작동하여 결과를 반환합니다.

Claude Code로 작업을 하다보면 대화가 길어질수록 컨텍스트가 꼬이게된다.

예를들어 컴포넌트 최적화, 데이터베이스 쿼리 성능 문제, Css 스타일링 문제 이슈등 클로드도 헷갈리고 개발자도 헷갈리고 그래서 이러한 문제들을 특정 유형의 작업을 처리하기 위해 특정 서브에이전트로 이용해서 수행할 수 있다

/agents 부터 엔터를 치다보면 이렇게 선택이 나오는데 1번은 현재 프로젝트에서 사용가능이고, 2번은 모든 프로젝트에서 사용이다. 

저는 1번을 선택하겠습니다!

이번엔 맨위 공식문서를 확인하면 되는데 1번은 공식문서에서 권장하는 방법으로 클로드 코드로 생성하는 방법이고

2번은 수동으로 생성하는 방법이라고합니다 

이번에도 1번을 선택하겠습니다.

그러면 서브에이전트가 무엇을 해야하고 해당 서브에이전트가 언제 사용해야하는지 설명을 해달라고한다.

코드리뷰를 진행하는 서브에이전트를 생성하도록 하겠습니다. (엔터를 쳐주세요)

툴 선택인데 컨티뉴로 엔터를 하겠습니다.

모델은 Sonnet을 하겠습니다

색상 선택은 수행중인 서브에이전트를 명확히 볼 수 있다 Green으로 엔터!

여기서 엔터를 누르게 되면 서브에이전트가 만들어지고 e를 누르게되면 다시 편집을 할 수 있다.

이렇게 서브에이전트가 .claude/agents/code-review-expert.md가 생성됐습니다!

서브에이전트를 명시적으로 해줘서 사용해준다

이렇게 좀 전에 색상 Green으로 설정한 서브에이전트가 실행이 되고 코드 리뷰가  완료됐다! 

이렇게 프로젝트에 수정항목, 결과 요약등으로 개발자 대신 일을 처리하는 모습을 볼 수 있다

그리고 여기서 개선 작업을 이어서 진행할 수 있다