muaco Tech Note

Claude Codecode.claude.com

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

매번 똑같이 치던 긴 지시를 파일 한 장으로 저장해 두고, 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#커스텀 명령#생산성#SKILL.md#업무 자동화#AI 도구

같은 분류의 글