@에이전트 자동완성 기능

Question

서브 에이전트를 생성 서브에이전트 이름 : notion-api-export "당신은 웹에서 노션 API데이터베이스를 활용한 웹을 전문적으로 개발하는 개발자입니다. " 프롬프트이후에 agents/notion-api-export.md 파일은 생성되었는데. "/exit" 이후 새로운 섹션에서 @notion~~~(agent)로 자동 완성이 안되는 이유가 무엇이죠? "@pred-generator(agent) 자동 완성되는데 <- 서브 에이전트로 등록되는데." 현재 터미널에서 "claude"로 클로드를 실행합니다. "code" 확장 프로그램에서 사용하지 않음 그리고 . workspace\.claude\agents\ notion-api-export.md 이용해서 노션 API로 데이터베이스를 사용하는 방법을 분석해 주세요 @notion-api-export (agent) 노션 API로 데이터베이스를 사용하는 방법을 분석해 주세요 1과 2의 결과가 다른거죠? 이미지처럼 결과는 나오네요 당연히 섹션 재시작 후에도 안 되네요.

짐코딩 · Answer

안녕하세요~! notion-api-export 파일은 만들어졌는데 Agent type 'notion-api-export' not found 오류가 발생하는 경우는, 파일은 생성됐지만 Claude Code가 그 파일을 "에이전트"로 인식하지 못했다 는 의미예요. 핵심 단서는 @prd-generator 는 잘 되는데 @notion-api-export 만 안 된다 는 점입니다. 같은 .claude/agents/ 폴더에 있는데 하나만 로드됐다면, 폴더나 세션 재시작 문제가 아니라 notion-api-export.md 파일 자체의 형식(프론트매터) 문제 예요. Claude Code는 파일 존재 여부가 아니라 파일 맨 위의 YAML 프론트매터 를 읽어서 에이전트를 등록합니다. 그래서 아래 형식이 정확히 지켜져야 해요. --- name: notion-api-export description: Notion API로 데이터베이스를 사용하는 방법을 분석하는 에이전트 --- 당신은 웹에서 노션 API 데이터베이스를 활용한 웹을 전문적으로 개발하는 개발자입니다. ... 특히 이 세 가지를 확인해보세요. 맨 위 --- 구분선이 시작·끝 둘 다 있는지 name: 과 description: 이 모두 있는지 name 값이 소문자와 하이픈(-)만 쓰였는지 ( notion-api-export ✅ / Notion_API_Export ❌) 가장 빠른 방법은, 이 파일을 Claude Code에게 그대로 붙여넣고 "형식이 올바른지 검사해줘"라고 요청 하시는 거예요. 아니면 파일을 캡처해서 보여주시면 제가 원인을 짚어드릴게요 🙂 감사합니다!

인프런 AI 인턴 · Answer

안녕하세요, sdkwon님. 인프런 AI 인턴입니다. 서브에이전트 생성 후에도 @notion-api-export 명령어의 자동완성이 되지 않는 문제를 겪고 계시는군요. 비슷한 문제로 이전에 질문이 있던 사례와 해결책을 안내 드립니다. 해결책 및 확인 사항 에이전트 파일 위치 및 내용 확인 : .claude/agents/notion-api-export.md 파일이 정확한 경로에 위치해 있는지 확인해 보세요. 파일의 내용이 올바르게 설정되어 있는지, 특히 YAML 헤더가 올바른지 점검해 보시는 것이 중요합니다. 팻치한 버전 및 업데이트 확인 : 사용 중인 CLI 도구가 최신 버전인지 확인해 보세요. 이전 버전에서는 특정 버그가 존재할 수 있습니다. CLI 재시작 및 캐시 지우기 : /exit 명령어로 클로드를 종료한 후 다시 실행하는 방법으로 해결되지 않을 경우, CLI 캐시를 삭제하거나 환경 설정을 초기화하는 것도 좋은 방법일 수 있습니다. 명령어 입력 및 에이전트 등록 재확인 : @notion-api-export 입력 시 정확한 에이전트 이름이 파일 내 정의와 일치하는지 확인하시길 바랍니다. 자동완성 문제는 함수 명이 파일 내 명세와 다를 때 발생할 수 있습니다. 다행히, 질문해 주신 내용 중 이미지처럼 결과가 나오는 것을 확인하셨다면, notion-api-export 가 올바르게 등록되고 있는 것 같습니다. 다만, 시스템의 환경 설정이나 캐시 관련 문제가 여전히 자동완성에 영향을 미칠 수 있습니다. 같은 질문에 대해 추가적으로 정보나 해결 방법이 필요한 경우, 아래 링크를 참조하시면 도움을 얻을 수 있습니다: - @agent-prd-generator 기능 설정 저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.