커맨드 = 마크다운 파일

Claude Code에서 커맨드는 별거 아니에요. .claude/commands/ 폴더에 마크다운 파일을 넣으면 끝이에요.

파일 이름이 곧 커맨드 이름이에요. 파일 안에는 Claude가 따라야 할 절차를 적어요.

/commit 커맨드를 처음부터 만들어보자

가장 많이 쓰는 /commit 커맨드를 예시로 만들어볼게요.

Step 1: 파일 생성

Step 2: 내용 작성

Step 3: 바로 사용

이게 끝이에요. Claude가 마크다운에 적힌 절차대로 실행해요.

좋은 커맨드의 3가지 조건

1. 구체적인 절차

"커밋해줘"가 아니라 구체적인 스텝을 적어야 해요.

2. 도구 명시

Claude가 어떤 명령어를 쓸지 정해주면 더 정확해요.

3. 예외 처리

예상되는 문제 상황을 적어두면 Claude가 알아서 대응해요.

실전: 프로젝트 전용 커맨드 만들기

팀마다 반복하는 작업이 다르잖아요. 몇 가지 예시를 보여드릴게요.

/db — DB 스키마 생성

사용법: /db users: name, email, role

/blog — 블로그 글 작성

이렇게 자주 하는 작업을 커맨드로 만들면 매번 설명할 필요가 없어요.

에이전트도 만들 수 있어요

커맨드는 /로 직접 호출하는 거고, 에이전트는 Claude가 자동으로 위임하는 독립 작업자예요.

.claude/agents/ 폴더에 YAML frontmatter가 있는 마크다운을 넣으면 돼요.

에이전트는 독립된 컨텍스트에서 실행되니까, 메인 대화를 방해하지 않아요. 코드 리뷰하는 동안 다른 작업을 계속할 수 있어요.

훅: 자동 안전장치

훅은 이벤트 발생 시 자동 실행되는 쉘 스크립트예요. .claude/hooks/ 폴더에 넣고, .claude/settings.json에 등록해요.

예시: 위험한 명령어 차단

settings.json에 등록

이러면 Claude가 rm -rf /나 git push --force main 같은 위험한 명령어를 실행하려 할 때 자동으로 차단돼요.

커맨드 vs 에이전트 vs 훅

	커맨드	에이전트	훅
파일	`.claude/commands/*.md`	`.claude/agents/*.md`	`.claude/hooks/*.sh`
실행	`/명령어`로 직접 호출	Claude가 자동 위임	이벤트 시 자동 실행
역할	정해진 작업 수행	복잡한 작업을 독립 수행	단순 검증/자동화
예시	`/commit` → 커밋	코드 리뷰 자동 위임	저장 → Prettier 실행

팀에 공유하는 방법

커맨드를 만들었으면 팀원들에게 공유하고 싶잖아요. 두 가지 방법이 있어요.

방법 1: Git에 커밋

.claude/ 폴더를 .gitignore에서 빼고 커밋하면, 팀원들이 pull 받으면 바로 쓸 수 있어요.

방법 2: 별도 레포 + 설치 스크립트

여러 프로젝트에서 공통으로 쓰려면 별도 레포로 관리하는 게 좋아요.

실제로 저도 이 방법으로 claude-settings 레포를 만들었어요. 커맨드 22종 + 에이전트 4종 + 훅 5종이 원라인 설치로 적용돼요.

정리

커맨드: .claude/commands/이름.md 만들면 /이름으로 바로 사용
에이전트: .claude/agents/이름.md에 YAML frontmatter 추가
훅: .claude/hooks/이름.sh 만들고 settings.json에 등록
공유: Git 커밋 또는 별도 레포 + 설치 스크립트

**핵심은 "반복하는 말을 마크다운에 한번만 적자"**예요. 그러면 / 한 글자로 끝나요.

시리즈:

1편: CMS 하루만에 만들기

2편: 슬래시 커맨드 22종

3편: CLAUDE.md 잘 쓰는 법

4편: 나만의 커맨드 만들기 (이 글)

5편: MCP로 노션·피그마 연동

관련 프로젝트:

claude-settings — Claude Code 슬래시 커맨드, 에이전트, 훅 설정 모음

HANUI — KRDS 기반 React 디자인 시스템