서브에이전트 활용 질문입니다.

작성한 질문수 4

0

안녕하세요! 🙂 질문 남겨주셔서 감사합니다.

먼저 짚고 가면 좋을 부분이 있어요. 서브에이전트는 프롬프트로 불러오는 게 아니라 파일로 존재하는 설정입니다. 클로드 코드는 실행한 프로젝트 폴더의 .claude/agents/와 사용자 홈의 ~/.claude/agents/, 이 두 곳을 읽어요. 그래서 "스타터킷을 참고해줘"라거나 "스타터킷의 서브에이전트를 그대로 반영해줘"라고 요청하신다고 해서 다른 폴더에 있는 서브에이전트가 자동으로 딸려오지는 않습니다.

그래서 경우가 나뉘어요.

스타터킷을 복사해서 새 프로젝트를 시작하셨다면 .claude/agents/ 폴더도 함께 복사되기 때문에 그대로 동작합니다. 다시 설정하실 필요 없어요.

스타터킷은 따로 두고 프로젝트를 새로 만드셨다면, 스타터킷 폴더의 .claude/agents/ 안에 있는 파일을 새 프로젝트로 복사해 주시면 됩니다. 이때는 클로드 코드에게 "스타터킷 폴더의 .claude/agents 파일들을 이 프로젝트로 복사해줘"라고 경로까지 알려주시면 알아서 옮겨줘요. 파일을 옮기는 작업이라 이건 깔끔하게 처리합니다.

그리고 매 프로젝트마다 반복해서 쓰시는 서브에이전트라면 아예 ~/.claude/agents/에 두시는 걸 권해드려요. 이 위치는 모든 프로젝트에서 공통으로 읽히기 때문에 프로젝트마다 복사하실 필요가 없습니다. 그 프로젝트에서만 의미 있는 에이전트는 프로젝트 안에, 어디서나 쓰는 에이전트는 홈에 두는 식으로 나누시면 관리가 편해요.

지금 어떤 서브에이전트가 잡혀 있는지는 /agents 명령어로 바로 확인하실 수 있으니, 프로젝트 시작하실 때 한 번 확인해 보시는 것도 좋습니다.

감사합니다 🙏

0

그러면 클로드코드에게 요청을 할 때 스타터킷에 있는 서브에이전트를 그대로 반영해줘 라고 하여 반영을 해도 될까요?

0

안녕하세요, 인프런 AI 인턴입니다. 홍민애님.

스타터킷에 서브에이전트 설정을 해두었다고 해서, 새로운 프로젝트에서 “스타터킷을 참고해줘”라고만 요청하면 서브에이전트가 항상 자동으로 다시 설정되거나 실행되는 것은 아닙니다.

서브에이전트를 재사용하려면 다음과 같이 구성해야 합니다.

• 서브에이전트 정의 파일을 새 프로젝트의 .claude/agents/에 복사하거나
  
• 스타터킷의 CLAUDE.md에 서브에이전트의 역할과 구성 방법을 작성한 뒤, 새 프로젝트에서도 해당 지침을 사용할 수 있도록 구성해야 합니다.
  
• 단순히 스타터킷을 참고하라고 요청하는 것만으로는 새 프로젝트의 Claude Code가 스타터킷 내부의 서브에이전트 설정을 자동으로 인식한다고 보장하기 어렵습니다.
  

서브에이전트 자체가 영구적으로 설치되는 개념이라기보다는, 프로젝트의 설정 파일과 지침을 통해 필요할 때 구성되는 방식에 가깝습니다. 따라서 프로젝트마다 사용할 수 있도록 서브에이전트 정의 또는 구성 지침을 준비해두는 것이 안전합니다.

관련 답변은 아래 게시글을 참고해 주세요.

• Agent team / subagent 생성시 재사용 가능 여부
  서브에이전트와 에이전트팀의 재사용 방식, CLAUDE.md를 활용한 프로젝트별·전역 설정에 대해 설명하고 있습니다.

• subagents에 관한 질문이 있습니다.
  .claude/agents/ 폴더와 서브에이전트 파일 생성 방식, Claude Code 업데이트에 따른 동작 차이를 확인할 수 있습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.