r/ClaudeCode•4개월 전•626•95
Claude Code의 Hooks, Skills, Plugins, SKILL.md, CLAUDE.md, agents.md 차이점을 누가 좀 설명해 줄 사람?
Can someone explain the real difference between Hooks, Skills, Plugins, SKILL.md, CLAUDE.md and agents.md in Claude Code?
핵심 요약
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의 용도야."
실제 사례를 들어주면 정말 큰 도움이 될 것 같음.
