스타터킷에 있는 서브에이전트들 사용방법

작성한 질문수 2

0

안녕하세요! 🙂

기본적으로 Claude Code가 작업 상황에 따라 포그라운드/백그라운드를 알아서 판단해요. 그래서 스타터킷 파일이 메인에서 실행됐다면 Claude가 해당 작업을 포그라운드로 판단한 거고, 파일 자체가 잘못된 건 아니에요.

만약 항상 백그라운드로 실행하고 싶다면 frontmatter에 background: true를 추가하시면 됩니다.

---
name: prd-generator
description: PRD 문서를 생성하는 에이전트
background: true
---

감사합니다 🙂

0

안녕하세요, 인프런 AI 인턴입니다. 구유성님.

클로드 코드 강의에서 제공하는 스타터킷의 서브에이전트를 활용하는 방법에 대해 궁금하시군요.

서브에이전트 사용 방법

1. 서브에이전트 파일 위치 확인 및 등록:

   • .claude/agents 디렉토리 내에 서브에이전트가 생성되었는지 확인하세요.
     

   • starter-cleaner.md와 prd-generator.md 파일이 각각 dev와 docs 폴더 내에 위치해야 합니다.

   • 예를 들어, agnets/dev/starter-cleaner.md처럼 경로가 정확한지 확인하세요.

2. 서브에이전트 등록:

   • 서브에이전트를 등록하는 과정은 특별한 추가 작업이 필요하지 않으며, 파일 경로에 올바르게 위치시키는 것만으로 충분합니다.
     

3. 클로드 실행 및 서브에이전트 호출:

   • 서브에이전트를 사용하려면 claude 명령어를 통해 CLI를 실행하고 해당 서브에이전트의 명령어를 입력하여 호출할 수 있습니다.
     
   • 주로 @prd-generator 혹은 @starter-cleaner 형식으로 명령어를 CLI에서 호출하면 됩니다.
     
   • 이때, @ 기호 뒤에 자동 완성이 될 수 있으므로 확인해 보세요.
     

해결되지 않는 경우

• 올바른 경로에 파일이 위치했음에도 문제가 발생하면, 터미널에서 종료(exit)하고 다시 시작해 보세요.
  
• MCP 최신 버전 사용 여부도 확인하고, 버전에 맞춰 메뉴얼이 변경되었는지 관련 문서를 참조하세요.
  

이와 관련된 추가적인 설명이나 예시는 다음 게시물에서 확인하실 수 있습니다:
- @agent-prd-generator 기능 설정
- 서브에이전트의 등록 및 호출 방법, 경로 관련 문제에 대한 해결 방법을 다루고 있습니다.

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