인프런 커뮤니티 질문&답변

안녕하세요! 🙂

제가 방금 직접 테스트해봤는데요, 서브에이전트 생성 후 /exit하고 다시 claude 실행하니 정상적으로 인식되었어요.

한 가지 확인해 주실 부분이 있는데, 호출할 때 @agent-prd-generator가 아니라 @prd-generator로 입력해 보시겠어요? (첨부한 스크린샷처럼 @test-run까지만 입력해도 자동완성이 뜹니다)

혹시 @prd-generator로도 안 되시면 최신 버전 v2.1.37이 맞는지 확인해 주시겠어요?

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

서브에이전트가 인식되지 않는 문제를 겪고 계시군요. 강의에서 다루는 ‘클로드 코드 완벽 마스터’ 과정에서 발생하는 이슈와 관련된 해결 방법을 찾아보겠습니다.

문제 해결을 위한 접근 방법

1. Agent 파일 경로 및 설정 확인:

   • .claude/agents/prd-generator.md 파일이 올바른 경로에 위치해 있는지, 그리고 내용이 제대로 구성되어 있는지 확인해 보세요. 파일 내의 YAML 형식 및 필수 필드는 정확히 기재되어야 합니다. 예시로 파일 시작에 agent 이름과 설명이 있어야 합니다.
     

   # Agent Name
   - name: prd-generator
   - description: Generates PRD documents.
   

2. CLI에서의 인식 문제:

   • /exit로 클로드를 종료한 후 다시 실행하는 것이 문제를 해결하지 못한다면, 시스템에서 캐시 파일을 삭제하거나 환경 설정을 초기화하는 방법도 도움이 될 수 있습니다.
     
   • settings.local.json에 적절한 설정이 추가되어 있는지 확인해보세요. 필요시 내용을 업데이트 해 보세요.
     

3. 명령어가 동작하지 않는 경우:

   • @agent-prd-generator 명령어 인식 문제는 명령어 정의가 잘못되었거나 파일이 제대로 로드되지 않았을 가능성이 있습니다. 터미널에서 해당 명령어를 입력했을 때 발생하는 정확한 오류 메시지를 확인하여 접근할 수 있습니다.
     

4. MCP 및 CLI 환경 설정 오류:

   • MCP 설치 후에도 설정 파일에 적용되지 않는 문제는 환경 설정 문제일 수 있습니다. 환경 변수를 한번 확인하고, ‘관리자 권한’으로 CLI를 실행해 보세요.
     
   • MCP 또는 CLAUDE CLI의 버전에 따라 사용법이 달라질 수 있으므로, 공식 문서나 릴리즈 노트를 통해 사용 방법의 변경사항이 있는지 확인하는 것도 좋습니다.
     

관련 해결 방법을 찾지 못하거나 명확한 접근법이 확인되지 않은 경우, 아래 관련된 유사한 문제와 해결 방법을 다룬 링크를 참조해주시기 바랍니다:
- @agent-prd-generator 기능 설정 - 관련 기능 구현에 대한 해결책이 제공되어 있습니다.

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