읽는 데 약 5분
Claude Code에 일 가르치기
플러그인, 스킬, hooks, mods를 개발자가 아니어도 이해하는 법

Claude Code를 쓰다 보면 “플러그인 깔았어요”, “스킬 하나 만들었어요”, “훅 걸어 뒀어요” 같은 말을 자주 듣게 됩니다. 개발자끼리는 익숙한 말이지만, 처음 보는 사람에게는 다 비슷하게 들립니다.

이 글은 그 네 가지를 개발 지식 없이 이해하는 것을 목표로 합니다. 각각이 무엇인지, 어떻게 설치하는지, 설치가 됐는지 어떻게 확인하는지까지 다룹니다. 설치는 명령어를 외우지 않고 Claude에게 말로 시키는 방법을 위주로 적었습니다.

다음 두 글에서는 제가 실제로 쓰고 있는 것들을 골라 소개합니다. 이 글은 그 글들을 읽기 위한 준비편입니다.

먼저, Claude Code는 새로 온 비서다#

Claude Code는 내 컴퓨터 안에서 일하는 AI 비서라고 생각하면 됩니다. 말로 부탁하면 파일을 열어 보고, 고치고, 프로그램을 실행합니다.

이 비서는 똑똑하지만 우리 집(내 컴퓨터, 내 일하는 방식)에 대해서는 아무것도 모르는 상태로 출근합니다. 그래서 매번 “보고서는 이 양식으로”, “끝나면 꼭 이것 확인해” 같은 말을 반복하게 됩니다.

네 가지 확장은 이 반복을 줄이는 도구입니다. 비유로 정리하면 이렇습니다.

이름비유한 줄 설명
스킬업무 매뉴얼특정 일을 할 때 꺼내 보는 절차서
hooks사무실 규칙과 알람정해진 순간에 비서가 잊어도 무조건 실행되는 규칙
플러그인입사 선물 세트매뉴얼, 규칙, 도구를 한 상자에 담아 한 번에 설치
mods책상과 모니터 꾸미기Claude Code 화면과 표시 방식 자체를 바꾸는 것

하나씩 보겠습니다.

스킬: 업무 매뉴얼#

스킬은 “이런 일을 할 때는 이렇게 해라”를 적어 둔 문서입니다.

회사에 새로 온 사람에게 “회의록은 이 순서로 정리해”, “보고서 문체는 이렇게 맞춰”라고 매번 말하는 대신, 매뉴얼을 서랍에 넣어 두는 것과 같습니다. 비서는 평소에는 매뉴얼 제목만 알고 있다가, 관련된 일이 들어오면 그 매뉴얼을 꺼내 읽고 그대로 따릅니다.

예를 들면 이런 스킬이 있습니다.

  • 어려운 내용을 듣는 사람 수준에 맞춰 쉽게 풀어 주는 스킬(이 글도 그 스킬로 다듬었습니다)
  • 한국어 문서에서 “AI가 쓴 티”를 걷어내는 스킬
  • 블로그 글의 표지 이미지를 만드는 스킬

실체는 폴더 하나에 든 글 문서(SKILL.md)입니다. 프로그램이 아니라 글이라서, 개발자가 아니어도 직접 만들고 고칠 수 있습니다.

핵심: 스킬은 비서가 “필요할 때 스스로 꺼내 보는” 지식입니다. 꼭 따른다는 보장은 없습니다. 상황을 잘못 판단하면 매뉴얼을 안 꺼낼 수도 있습니다.

hooks: 사무실 규칙과 알람#

hooks는 정해진 순간에 자동으로 실행되는 규칙입니다.

스킬과의 차이가 중요합니다. 스킬은 비서가 판단해서 꺼내 보는 것이고, hooks는 비서의 판단과 상관없이 무조건 돌아갑니다. 사무실 출입문에 달린 출입 카드 확인기에 가깝습니다. 직원이 깜빡해도 문은 카드를 확인합니다.

“정해진 순간”에는 이런 것들이 있습니다.

  • 비서가 답변을 끝내려는 순간
  • 비서가 파일을 고치기 직전이나 직후
  • 내가 메시지를 보낸 순간
  • 작업을 시작하거나 끝낸 순간

제가 실제로 쓰는 예를 들면, 비서가 답변을 끝내려는 순간 답변 속 링크가 실제로 열리는지 검사하는 hook이 있습니다. 죽은 링크가 있으면 답변을 끝내지 못하게 막고 고치라고 돌려보냅니다. “링크를 꼭 확인해”라고 매번 말하는 대신, 확인을 건너뛸 수 없게 만든 것입니다.

핵심: “꼭 지켜야 하는 것”은 스킬보다 hooks로 만듭니다. 매뉴얼은 안 읽을 수 있어도 출입문은 피해 갈 수 없습니다.

플러그인: 입사 선물 세트#

플러그인은 스킬, hooks, 명령어, 외부 도구 연결을 한 상자에 담은 묶음입니다.

누군가 “이렇게 일하면 편하다”는 방식을 통째로 포장해 둔 것입니다. 상자 하나를 설치하면 그 안의 매뉴얼과 규칙이 한꺼번에 들어옵니다. 지우고 싶을 때도 상자째 뺍니다.

플러그인은 “마켓플레이스”라는 진열대에서 고릅니다. Anthropic이 운영하는 공식 진열대가 있고, 개인이나 회사가 만든 진열대도 있습니다. 앱 스토어와 비슷하다고 생각하면 됩니다.

핵심: 처음에는 스킬이나 hooks를 직접 만들기보다, 잘 만든 플러그인을 하나 설치해서 써 보는 것이 빠릅니다.

mods: 책상과 모니터 꾸미기#

mods는 Claude Code 화면 자체를 바꾸는 확장입니다.

앞의 셋이 비서의 “일하는 방식”을 바꾼다면, mods는 비서가 일하는 “모습이 보이는 방식”을 바꿉니다. 화면 아래 상태 표시, 입력창 위의 안내 띠, 작업 중에 나오는 문구 같은 것들입니다.

예를 들어 저는 작업 중 문구를 “생각 중”, “실행 중” 같은 한국어로 바꾸고, 비서의 기억 공간이 얼마나 찼는지를 날씨(맑음, 구름, 소나기, 폭풍)로 보여 주는 mod를 만들어 씁니다. 대화가 길어져 비서가 앞의 내용을 잊기 시작할 때가 되면 날씨가 나빠지니 한눈에 알 수 있습니다.

핵심: 일의 결과는 바뀌지 않지만, 지금 무슨 일이 일어나는지 보기가 편해집니다. 넷 중에서는 가장 마지막에 손대도 되는 것입니다.

설치하기: 명령어 대신 말로 시키기#

네 가지 모두 Claude에게 말로 부탁해서 설치할 수 있습니다. 명령어를 몰라도 됩니다. Claude Code를 열고 이렇게 입력하면 됩니다.

플러그인 설치

공식 마켓플레이스에서 쓸 수 있는 플러그인 목록을 보여 주고, 각각 뭘 하는 건지 한 줄씩 설명해 줘.

방금 목록에서 ○○ 플러그인 설치해 줘.

직접 고르고 싶다면 입력창에 /plugin을 치면 설치 화면이 열립니다. 방향키로 고르고 Enter를 누르면 됩니다.

스킬 만들기

내가 회의 녹음 정리를 자주 하는데, 회의록을 항상 “결정 사항, 할 일, 담당자” 순서로 정리하는 스킬을 만들어 줘. 모든 프로젝트에서 쓸 수 있게 해 줘.

남이 만든 스킬을 가져올 때는 이렇게 부탁합니다.

이 GitHub 주소에 있는 스킬을 내 전역 스킬로 설치해 줘. 설치 전에 그 스킬이 무슨 일을 하는지 먼저 요약해 줘.

hook 만들기

답변을 끝낼 때마다 답변에 들어 있는 링크가 실제로 열리는지 검사하는 hook을 만들어 줘. 열리지 않는 링크가 있으면 답변을 끝내지 말고 고치게 해 줘.

mod 만들기

작업 중에 나오는 문구를 한국어로 바꾸는 mod를 만들어 줘.

설치하거나 만든 뒤 바로 반영되지 않으면 Claude Code를 껐다가 다시 켜면 됩니다.

설치됐는지 확인하기#

설치했다고 끝이 아닙니다. 실제로 들어왔는지 확인하는 방법입니다.

확인할 것방법
플러그인입력창에 /plugin을 치고 설치된 목록을 봅니다
hooks입력창에 /hooks를 치면 어떤 순간에 무엇이 걸려 있는지 나옵니다
스킬Claude에게 “지금 쓸 수 있는 스킬 목록 보여 줘”라고 묻습니다
mods화면이 바뀌었는지 눈으로 확인합니다. 안 바뀌었다면 Claude에게 ”○○ mod가 왜 안 보이는지 확인해 줘”라고 묻습니다

가장 확실한 방법은 직접 시험해 보는 것입니다. 회의록 스킬을 만들었다면 회의 메모를 하나 던져서 정한 순서대로 나오는지 봅니다. 링크 검사 hook을 만들었다면 일부러 틀린 링크를 넣어 달라고 해서 막히는지 봅니다.

설치 전에 한 번 생각할 것#

플러그인과 hooks는 내 컴퓨터에서 프로그램을 실행할 수 있습니다. 앱을 아무 데서나 받지 않듯이, 이것도 출처를 보고 설치하는 편이 안전합니다.

  • 공식 마켓플레이스나 많이 쓰이는 저장소의 것부터 씁니다.
  • 남이 만든 스킬이나 플러그인은 설치 전에 Claude에게 “이게 무슨 일을 하는지, 내 파일을 어디까지 건드리는지 요약해 줘”라고 먼저 물어봅니다.
  • 한꺼번에 많이 설치하지 않습니다. 하나씩 넣고 써 보면 무엇이 효과가 있는지 알 수 있습니다.

정리#

  • 스킬: 비서가 필요할 때 꺼내 보는 업무 매뉴얼
  • hooks: 비서가 잊어도 반드시 돌아가는 규칙
  • 플러그인: 매뉴얼과 규칙을 한 상자에 담은 선물 세트
  • mods: Claude Code 화면을 내 취향대로 바꾸는 것

시작은 플러그인 하나를 설치해 써 보는 것으로 충분합니다. 다음 글에서는 제가 매일 쓰는 플러그인 중 추천할 만한 것들을 골라 소개합니다.

Claude Code에 일 가르치기
https://leean.dev/posts/claude-code-extensions-basics/
저자
leean
게시일
2026-10-10
라이선스
CC BY-NC-SA 4.0