Claude Code 슬래시 명령 만들기파일 위치와 인자 넘기기

안녕하세요, muaco입니다.

이 글로 무엇이 되나요

Claude Code에 나만 쓰는 슬래시 명령을 하나 만들어 봐요. 슬래시 명령은 대화창에 /를 치면 뜨는 짧은 이름이에요. 매일 똑같이 치던 다섯 줄짜리 지시를 파일 한 장에 넣어 두면, 다음부터는 /standup처럼 한 번만 불러도 같은 지시가 그대로 들어가요.

프로그래밍은 필요 없어요. 폴더를 하나 만들고 글자 파일 하나를 쓰면 끝이에요. 이 글은 2026년 9월 기준 Claude Code 공식 문서를 따라 썼어요.

미리 갖춰야 할 것들

여기서 걸리면 아래를 다 읽어도 소용없으니 먼저 확인해요.

• 터미널. 검은 화면에 글자를 쳐서 컴퓨터에 말을 거는 창이에요. 맥은 터미널, 윈도우는 PowerShell이에요.
• 계정. 공식 문서는 Claude 구독(Pro, Max, Team, Enterprise)이나 Claude Console 계정, 또는 지원되는 클라우드 사업자를 통한 접근이 필요하다고 적어요.
• Claude Code 설치. 맥과 리눅스, WSL은 curl -fsSL https://claude.ai/install.sh | bash를 쳐요. 윈도우 PowerShell은 irm https://claude.ai/install.ps1 | iex예요.
• 설치 확인. claude --version을 쳤을 때 버전 숫자 뒤에 (Claude Code)가 보이면 됐어요.
• 글자 편집기. 메모장이나 VS Code면 충분해요.

따라 하기: 파일 한 장이면 돼요

준비: 명령이 살 자리를 정해요

1. 나 혼자 모든 프로젝트에서 쓸 명령이면 ~/.claude/skills/ 아래에 둬요. 집 서랍에 넣어 두는 셈이라 어느 폴더에서 Claude Code를 켜도 따라와요.
2. 맥과 리눅스, WSL 터미널에는 mkdir -p ~/.claude/skills/standup을 쳐서 폴더를 만들어요. standup 자리가 앞으로 부를 이름이에요.
3. 윈도우 PowerShell에서는 같은 줄이 오류로 끊겨요. 여기서 mkdir은 New-Item의 다른 이름이라 -p를 매개변수로 받지 않아요. mkdir ~/.claude/skills/standup처럼 빼고 치면 중간 폴더까지 알아서 함께 생겨요.
4. 팀과 함께 쓸 명령이면 프로젝트 폴더 안의 .claude/skills/standup/에 두고 저장소에 같이 올려요. 그러면 동료가 내려받는 순간 같은 명령을 써요.
5. 폴더 이름이 곧 명령 이름이에요. standup 폴더를 만들었으면 나중에 /standup으로 불러요.

작성: 머리말과 지시문을 채워요

1. 방금 만든 폴더 안에 SKILL.md라는 파일을 만들어요. 공식 문서가 전부 대문자 표기로만 쓰니 그대로 맞춰요.
2. 메모장으로 쓴다면 저장할 때 두 군데를 챙겨요. 파일 형식을 모든 파일로 바꿔요. 그냥 저장하면 이름이 SKILL.md.txt가 돼서 Claude Code가 지나쳐요. 그리고 파일 이름 칸에 %USERPROFILE%\.claude\skills\standup\SKILL.md를 통째로 붙여 넣어요. 점으로 시작하는 폴더는 탐색기에 잘 안 보이니 경로를 직접 적는 편이 빨라요. 인코딩은 UTF-8로 둬요.
3. 파일 첫 줄부터 줄 세 개(---) 사이에 머리말을 넣어요. 이름표를 붙이는 자리라고 보면 돼요. 아래를 그대로 옮겨 적고 내용만 바꿔요.

   ---
   name: standup
   description: 오늘 한 일을 팀 공유용 세 줄로 정리해요
   argument-hint: [브랜치이름]
   ---
   오늘 작업한 내용을 팀에 공유할 세 줄로 정리해 주세요.
   어려운 말은 빼고, 무엇이 끝났고 무엇이 남았는지 적어 주세요.

4. description은 Claude가 이 명령을 언제 꺼내 쓸지 판단하는 줄이에요. 공식 문서가 권장 항목으로 표시했으니 꼭 적어요.
5. argument-hint는 자동완성에서 보이는 힌트예요. [issue-number]처럼 무엇을 뒤에 붙이면 되는지 알려줘요.
6. 줄 세 개 아래부터는 평소 대화창에 치던 지시를 그대로 옮겨 적고 저장해요. 새 문법을 배울 필요가 없어요.

인자: 매번 달라지는 값에 구멍을 뚫어요

1. 지시문에 $ARGUMENTS라고 쓰면, 명령 뒤에 붙인 말이 통째로 그 자리에 들어가요. /fix-issue 123을 부르면 123이 들어가요.
2. 값을 여러 개 따로 받고 싶으면 $0, $1, $2를 써요. 공식 문서 기준으로 0부터 셉니다. 첫 번째 값이 $0이에요. $ARGUMENTS[0]이라고 써도 같아요.
3. 숫자가 헷갈리면 머리말에 arguments: [issue, branch]를 적고 본문에서 $issue, $branch처럼 이름으로 불러요. 나중에 읽기가 훨씬 편해요.
4. 값을 붙여 불렀는데 받을 자리가 하나도 없으면, Claude Code가 내용 끝에 ARGUMENTS:를 붙여 값을 넘겨요. 사라지지는 않지만 원하는 자리에 들어가지 않으니 구멍을 뚫어 두는 편이 나아요.

확인: 제대로 걸렸는지 봐요

1. 터미널에서 claude를 다시 켜요. 문서는 스킬 폴더를 지켜보다가 바뀌면 재시작 없이 반영한다고 적어요. 세션을 켤 때 없던 최상위 스킬 폴더를 새로 만든 경우에만 다시 켜라고 안내해요. ~/.claude/skills/를 이번에 처음 만들었으니 이번 한 번만 다시 켜면 되고 다음부터는 저장만 해도 바로 떠요.
2. 대화창에 /만 쳐요. 목록에 standup이 뜨면 자리를 제대로 잡은 거예요.
3. /skills를 치면 지금 쓸 수 있는 목록이 설명과 함께 펼쳐져요.
4. /standup main처럼 값을 붙여 실제로 불러 봐요. 지시문이 그대로 들어갔는지 답을 보고 확인해요.
5. /context를 치면 Skills 줄이 보여요. 명령이 대화에 얼마나 자리를 차지하는지 알 수 있어요.

여기서 자주 막혀요

목록에 이름이 안 떠요. 세 곳을 순서대로 봐요. 파일 이름이 SKILL.md가 맞는지, 폴더가 ~/.claude/skills/이름/ 안에 있는지, 세션을 새로 켰는지예요. 세 개 중 하나가 어긋난 경우가 대부분이에요.

명령 안에 실행 결과를 넣었더니 호출이 통째로 멈춰요. 지시문에 느낌표와 백틱으로 감싼 셸 명령을 넣으면 Claude가 글을 보기 전에 먼저 실행돼요. 이때 명령이 실패하면 호출 전체가 중단돼요. 문서는 || true를 붙여 실패를 눌러 두라고 안내해요. 명령당 제한 시간은 2분이라고 밝히고 있어요.

이름이 겹쳐요. 같은 이름이 프로젝트 뿌리와 하위 폴더에 둘 다 있으면 경로가 이름표에 붙어요. 공식 문서 예시는 apps/web/.claude/skills/deploy/SKILL.md가 /apps/web:deploy로 불린다고 적어요.

예전 방식으로 만든 파일이 있어요. .claude/commands/이름.md 형식도 여전히 /이름으로 불려요. 다만 문서가 스킬 형식을 권장하고 있으니 새로 만들 때는 SKILL.md 쪽으로 가요.

더 나아가려면

손에 익으면 머리말을 조금씩 늘려 봐요. allowed-tools에 도구를 적어 두면 그 명령을 부른 턴에 한해 확인을 묻지 않고 바로 써요. 이 허용은 다음 메시지에서 풀리니 부담이 적어요. disable-model-invocation을 true로 두면 Claude가 알아서 꺼내 쓰지 않고 내가 부를 때만 돌아요. 배포처럼 조심스러운 작업에 어울려요.

이상으로 글을 마칠게요.

출처

• Claude Code Docs: Slash commands
• Claude Code Docs: Skills
• Claude Code Docs: Quickstart