r/ClaudeCode•10일 전•626•95
Claude Code의 Hooks, Skills, Plugins, SKILL.md, CLAUDE.md, agents.md 차이점을 누가 좀 설명해 줄 사람?
핵심 요약
Claude Code에서 혼용되는 다양한 설정 파일과 기능들의 명확한 차이와 용례를 묻는 질문.
- 용어 혼란 — 튜토리얼에서 무분별하게 사용되는 Hooks, Skills, Plugins 등의 개념이 모호함.
- 설정 파일 — CLAUDE.md, SKILL.md, AGENTS.md의 역할과 실제 동작 방식에 대한 의문.
- 실무 예시 — 이론적인 설명보다 실제 상황에서 어떻게 구분해서 사용하는지 알고 싶어 함.
- 문서화 부족 — 공식 문서가 있음에도 불구하고 실무적인 차이점을 이해하기 어렵다는 의견.
튜토리얼이나 영상에서 이런 용어들이 계속 나오는데, 차이점을 확실하게 알 수 있는 구체적인 예시를 본 적이 없음.
다들 이렇게 말함:
• "그냥 그거용 스킬 하나 만들어"
"여기서는 훅을 써"
"플러그인 설치해"
"CLAUDE.md에 넣어둬"
근데 더 파고들면 설명이 항상 모호하거나 너무 이론적임.
마크다운 파일도 마찬가지임. CLAUDE.md, SKILL.md, agents.md를 다들 당연하다는 듯이 언급하는데 아무도 설명 안 해줌:
• 각각에 정확히 뭐가 들어가는지?
그냥 문서일 뿐인지, 아니면 Claude의 동작 방식을 실제로 바꾸는지?
• Claude는 도대체 언제 이걸 읽는 건지?
내가 원하는 건 이런 거임:
"X를 생각 중이라면 그건 아마 훅일 거야. Y를 생각 중이라면 그건 스킬이고. Z가 필요하다면 그게 바로 CLAUDE.md의 용도야."
실제 사례를 들어주면 정말 큰 도움이 될 것 같음.
