클로드 코드 슬래시 명령어(Slash Commands) 알아보기
Claude Code의 대화 입력창에서 /로 시작하는 명령입니다. 도움말 같은 기본 기능을 열거나 미리 등록한 작업 지침을 불러올 때 씁니다.
같은 말:Slash Commands슬래시 커맨드커스텀 명령
목차
이 글은 터미널에서 실행한 Claude Code를 기준으로 설명합니다. 설치 전이라면 설치와 첫 실행에서 연습 폴더부터 준비합니다.
🤔 같은 요청을 다시 쓰고 있다면
‘모임 메모를 날짜, 장소, 준비물 순서로 정리해 줘’라는 요청을 자주 쓴다고 생각해 봅니다. 요청 문장을 저장해 두고 짧은 이름으로 부르면 다시 쓰는 수고를 줄일 수 있습니다. 이것이 사용자 지정 슬래시 명령의 쓰임입니다.
다만 /help처럼 처음부터 있는 명령과 /meetup-summary처럼 직접 등록해야 하는 명령은 다릅니다. 이름만 입력한다고 새 기능이 생기지는 않습니다.
🧰 먼저 기본 명령 두 개 실행하기
앞 수업의 claude-practice 폴더에서 claude를 실행합니다. 운영체제 명령창이 아니라 Claude Code와 대화하는 입력창에 다음 명령을 한 줄씩 입력합니다.
/help도움말이 열리는지 확인합니다. 닫는 방법은 화면의 안내를 따릅니다. 이어서 다음 명령을 입력합니다.
/usage사용량 화면이 열리면 계정에서 보여 주는 항목을 확인합니다. 결제 방식과 버전에 따라 표시 정보가 다를 수 있습니다. 이것은 파일을 요약하라는 요청이 아니라 Claude Code의 기능을 여는 명령입니다.
명령이 보이지 않으면 /만 입력해 현재 사용 가능한 목록을 봅니다. 일반 문장 뒤에 붙이지 말고 입력의 맨 앞에 /를 둡니다. 터미널에서 ‘명령을 찾을 수 없다’고 나오면 Claude Code를 실행하기 전 운영체제 명령창에 넣었는지 확인합니다.
| 명령 | 언제 쓰나 | 주의할 점 |
|---|---|---|
/help | 조작 방법을 찾을 때 | 현재 환경의 안내를 확인 |
/usage | 사용량을 확인할 때 | 표시 정보는 인증 방식 등에 따라 다름 |
/clear | 새 대화를 시작할 때 | 파일 삭제나 이미 한 작업의 취소가 아님 |
/plan | 수정 전에 계획을 볼 때 | 계획 모드 수업에서 연습 |
/init | 프로젝트 지침 초안을 만들 때 | CLAUDE.md라는 실제 파일을 만들 수 있어 내용 검토 필요 |
/clear를 써도 프로젝트 지침이 사라지지는 않으며 이전 대화가 영구 삭제된다고 가정하지 않습니다. 재개 가능한 기록과 현재 대화의 맥락은 구분합니다.
✨ 반복 요청을 짧은 이름으로 부르기
현재 Claude Code에서는 사용자 지정 명령을 스킬로 만들 수 있습니다. 스킬은 작업 지침과 필요한 자료를 묶은 폴더이며 /이름으로 직접 부를 수도 있고 설정에 따라 Claude가 작업에 맞춰 불러올 수도 있습니다.
기본 명령을 쓸 수 있으면 여기서 멈춰도 됩니다. 아래는 같은 요약을 다시 쓸 필요가 있을 때 해 보는 선택 연습입니다. 실제 업무 폴더 대신 기존 claude-practice 폴더만 사용합니다.
Claude Code에 아래 상자 안의 내용을 모두 복사해 요청합니다. 답변으로 코드만 받았다면 실제 파일을 만들었는지 경로를 확인합니다.
현재 연습 폴더 안에 .claude/skills/meetup-summary/SKILL.md 파일 하나를 만들어 줘.
필요한 하위 폴더만 만들고 기존 파일이 있으면 덮어쓰지 말고 알려 줘.
다른 파일이나 개인 공통 설정은 바꾸지 마.
파일 내용은 아래와 같아.
---
name: meetup-summary
description: 사용자가 준 모임 메모를 세 항목으로 정리합니다.
disable-model-invocation: true
---
입력 메모: $ARGUMENTS
입력 메모만 보고 날짜와 시각, 장소, 준비물을 세 줄로 답합니다.
언급되지 않은 항목은 미정으로 적습니다.
파일을 읽거나 만들지 않고 외부 도구도 사용하지 않습니다..claude는 프로젝트 안의 설정 폴더 이름입니다. skills 아래 meetup-summary 폴더를 두고 그 안에 이름이 정확히 SKILL.md인 파일을 만듭니다. 맨 위 두 --- 사이에는 이름과 설명 같은 설정을 적습니다. disable-model-invocation: true는 이 스킬을 Claude가 임의로 부르지 않고 사용자가 직접 호출하도록 하는 설정입니다.
$ARGUMENTS에는 명령 뒤에 쓴 문장이 들어갑니다. 파일 생성 권한을 확인하는 화면이 나오면 경로가 연습 폴더 안인지 봅니다. 숨김 폴더가 보이지 않으면 Claude Code에 해당 파일 전체를 읽어 보여 달라고 요청해 위 내용과 대조합니다. 경로가 .claude/skills/meetup-summary/SKILL.md인지도 확인합니다. /exit로 종료한 뒤 같은 폴더에서 claude를 다시 실행합니다.
/meetup-summary 10월 12일 오후 2시 모임. 준비물은 책 한 권.답에는 10월 12일 오후 2시 / 장소 미정 / 책 한 권이 있어야 합니다. 실제 장소를 찾아오거나 파일을 추가로 만들 필요는 없습니다. 명령이 보이지 않으면 현재 폴더, SKILL.md 철자와 경로부터 확인합니다. 장소를 지어냈다면 원문에 장소가 없다는 점을 짚어 다시 요청합니다. 지침을 저장했다고 매번 정확한 결과가 보장되지는 않습니다.
📁 기존 .claude/commands 형식은 어떻게 하나요?
예전 방식인 .claude/commands/review-pr.md도 지원됩니다. 이 파일은 /review-pr로 부르는 지침이며 PR은 다른 사람에게 코드 변경을 검토해 달라고 보내는 요청입니다. 아래 그림은 그 형식을 보여 줍니다. 처음 배우는 지금 PR 검토나 배포 명령까지 만들 필요는 없습니다.
기존 명령 파일 형식의 예입니다. /review-pr 1234의 1234가 지침의 $ARGUMENTS로 전달되며 실제 검토 결과를 보장하지 않습니다.
새로 만들 때는 보조 자료를 함께 두기 좋은 .claude/skills/이름/SKILL.md 형식을 사용할 수 있습니다. ‘명령은 수동, 스킬은 자동’으로 나누는 것은 현재 방식과 맞지 않습니다. 프로젝트의 스킬 파일을 팀에 공유하려면 팀이 쓰는 변경 이력 도구인 Git 등의 전달 절차가 필요합니다. 내 컴퓨터에 저장한 것만으로 동료 환경에 생기지는 않습니다.
⚠️ 명령을 늘리기 전에 확인하기
반복할 가치가 있는 작업 하나부터 만듭니다. 지침에는 입력 자료, 출력 형식과 확인 기준을 적습니다. 외부 발송이나 배포처럼 실제 영향을 주는 작업은 요약 명령과 구분해 권한과 검토 절차를 정합니다.
비밀번호와 API 키는 지침이나 공유 파일에 넣지 않습니다. 연습용 모임 요약에는 그런 값이 전혀 필요하지 않습니다. 환경 변수를 쓴다는 이유만으로 비밀값 노출이 자동으로 방지되지는 않습니다.
🔁 입력 하나를 바꿔 혼자 다시 해 보기
기본 명령만 연습했다면 /help를 다시 열어 /clear가 파일 삭제 명령인지 확인하고 두 기능의 차이를 설명해 봅니다.
사용자 지정 스킬까지 만들었다면 /meetup-summary 뒤의 메모를 10월 13일 오후 3시 도서관 2층 모임으로 바꿉니다. 답은 새 날짜와 시각, 도서관 2층, 준비물 미정이어야 합니다. 앞 메모의 책 한 권이 남으면 현재 입력만 쓰도록 다시 확인합니다.
사용자 지정 스킬 연습은 기본 명령과 직접 만든 명령을 각각 하나 설명하고 입력이 바뀐 결과를 대조하면 마칩니다.
📋 3줄 요약
-
슬래시 명령은 Claude Code 입력창에서 /로 시작하며 기본 기능을 열거나 등록한 작업 지침을 불러옵니다.
-
기본 명령 두 개를 먼저 실행하고 반복할 작업이 생기면 작은 사용자 지정 스킬을 만듭니다.
-
스킬은 직접 호출할 수도 있으며 결과를 원문과 비교하고 명령이 안 보이면 파일 경로와 이름을 확인합니다.
📚 참고 자료
2026년 10월 3일 공식 자료를 확인했습니다.
제대로 이해했는지 한 문제로 확인해 볼까요?
답을 고르면 바로 풀이가 나와요.
/clear를 입력하면 무엇이 달라질까요?
예제나 확인 질문을 직접 시도한 뒤 완료 표시해요. 더 연습할 내용이 남으면 표시하지 않고 다음 글을 읽어도 됩니다. 완료 버튼은 이해도를 채점하지 않으며 잘못 표시하면 취소할 수 있어요.
