핫 리로드와 디버깅
로딩과 동작을 나누어 확인하기
먼저 plugin.json, hooks.json, 모듈 경로를 검증한 다음 이벤트와 렌더링 로직을 확인하세요. 상대 경로는 hooks manifest 디렉터리를 기준으로 해석됩니다. 확장자와 내보내기 방식은 현재 도구 체인에 맞아야 합니다.
로컬 CLI 사용하기
claude plugin validate ./your-plugin
claude plugin test --help
명령 지원 여부와 테스트 인자는 버전에 따라 달라질 수 있습니다. 먼저 claude plugin --help를 확인하세요. 이 사이트는 수집한 mod를 자동 실행하지 않으며 검증은 동작 테스트를 대체하지 않습니다.
핫 리로드
현재 공식 문서에 따라 개발 모드를 켜세요. 모듈을 다시 불러올 때마다 타이머, 구독, 프로세스, 네트워크 연결을 해제하여 이벤트가 중복 등록되지 않도록 하세요.
유용한 디버깅 기록
CLI 버전, mod 버전, 발생 이벤트, 기대 동작, 실제 동작을 기록하세요. 최소 저장소에서 재현하고 API 키, 사용자 코드, 전체 대화를 로그에 남기지 마세요.