클로드 코드 슬래시 명령이란 — 입력창 맨 앞의 / 하나로 여는 메뉴
공식 문서는 명령을 «세션 안에서 Claude Code를 다루는 것»이라고 설명한다. 모델 바꾸기, 권한 관리, 맥락 비우기, 워크플로 실행 같은 일을 빠르게 하는 길이다. /만 치면 지금 쓸 수 있는 명령이 보이고, / 뒤에 글자를 더 치면 목록이 좁혀진다. 이 메뉴에는 클로드 코드에 들어 있는 내장 명령만 있는 것이 아니라, 함께 들어 있는 스킬과 사용자가 만든 스킬, 플러그인과 MCP 서버가 더한 명령도 같이 나온다.
규칙 하나를 먼저 알아 두면 헷갈릴 일이 줄어든다. 명령은 메시지 맨 앞에 있을 때만 알아듣고, 명령 이름 뒤에 쓴 글자는 그 명령의 인수(argument)가 된다. 예를 들어 /plan 로그인 오류 고치기라고 보내면 계획 모드로 들어가면서 «로그인 오류 고치기»를 바로 첫 일로 받는다. 문서의 표에서 <arg>는 꼭 넣어야 하는 인수이고 [arg]는 넣어도 되고 안 넣어도 되는 인수다.
내장 명령 · 번들 스킬 · 워크플로, 그리고 메뉴가 거르는 방식
공식 명령 표에는 세 종류가 섞여 있다. 대부분은 동작이 CLI 안에 코드로 들어 있는 내장 명령이다. 표에 «Skill»이라고 표시된 줄은 번들 스킬로, 사용자가 직접 쓰는 스킬처럼 클로드에게 건네는 프롬프트다. «Workflow»라고 표시된 줄은 여러 하위 에이전트에 일을 나눠 뒤에서 돌리는 동적 워크플로다. /code-review · /simplify · /batch · /loop이 스킬 쪽이고, /deep-research가 워크플로 쪽이다.
메뉴가 글자를 거르는 방식도 정해져 있다. / 뒤 글자가 명령 이름이나 별칭의 처음, 또는 이름 안 낱말의 처음과 맞을 때만 맨 위 후보가 강조되고, 이때 Enter를 누르면 그 후보가 실행된다. 구분 기호 : · _ · -는 무시하므로 /adddir을 치면 /add-dir이 강조되고, /new를 치면 별칭을 따라 /clear가 강조된다. 오타가 나면 아무것도 강조되지 않고, 비슷한 후보는 목록에 남지만 그대로 Enter를 누르면 친 글자 그대로 보내져 Unknown command가 뜬다. 그래서 오타가 났을 때는 Tab이나 화살표로 후보를 고른 뒤 보낸다.
응답 중에 보낸 명령은 대기열에 들어가 지금 턴이 끝난 뒤 돈다. 다만 /status · /tasks · /usage 같은 몇몇 명령은 응답을 끊지 않고 바로 돈다. 입력창 맨 앞의 다른 기호도 같이 알아 두면 좋다. !로 시작하면 셸 명령을 바로 돌려 그 출력을 세션에 넣고, @를 치면 파일 경로 자동 완성이 뜬다.
처음에는 세 종류를 외울 필요는 없다. 다만 «스킬» 표시가 붙은 명령은 클로드가 프롬프트를 받아 일하는 것이라 모델 사용량을 쓰고, 내장 명령은 화면을 열거나 설정을 바꾸는 쪽이 많다는 정도만 기억해 두면 된다. 사용량이 어떻게 계산되는지는 클로드 사용 한도 이해하기 — 왜 빨리 닳고 언제 풀리나에 따로 정리했다.
상황별로 자주 쓰는 클로드 코드 명령어 — 처음 · 작업 중 · 끝내기 전
공식 명령 문서는 명령을 세션의 시점별로 묶어 소개한다. 그 묶음을 처음 쓰는 사람 쪽으로 다시 추리면 다음과 같다. 여러 에이전트를 한꺼번에 돌리는 묶음(/batch · /background · /fork)은 시리즈 뒤쪽의 하위 에이전트 편으로 미루고, 여기서는 혼자 한 저장소에서 일할 때 손이 자주 가는 것만 남겼다.
처음 저장소를 열었을 때. /init으로 CLAUDE.md 초안을 만들고 /memory로 다듬는다. 프로젝트에 필요한 외부 도구 서버는 /mcp로 붙이고, /permissions로 승인 규칙을 정한다. /init이 만든 초안에서 무엇을 지우고 남길지는 클로드 코드 CLAUDE.md 쓰는 법 — 무엇을 적고 어디에 두나에, 허용 · 확인 · 거부 규칙은 클로드 코드 권한 모드 — 묻게 할 일과 맡길 일 나누기에 자세히 적었다.
작업하는 중에. 큰 변경 전에는 /plan으로 계획 모드에 들어간다. /model과 /effort는 쓰는 모델과 추론에 들이는 양을 바꾼다. /model은 고른 모델을 새 세션의 기본값으로 저장하는데, 목록에서 s를 누르면 지금 세션에만 바꾼다. /effort는 low부터 xhigh, max, auto 가운데 고르고, max는 그 세션에만 적용된다. 대화가 길어지면 /context로 무엇이 맥락 창을 채우는지 색깔 격자로 보고, /compact로 지금까지의 대화를 요약해 자리를 비운다. /compact 결정한 것과 남은 할 일 위주로처럼 요약할 방향을 같이 넘길 수도 있다.
곁질문은 /btw, 끝내기 전에는 /diff와 /code-review
작업 중에 «아까 그 설정 파일 이름이 뭐였지?»처럼 잠깐 묻고 싶을 때 쓰는 것이 /btw다. 곁질문과 답은 대화 기록에 들어가지 않고, 터미널에서는 닫을 수 있는 겹창으로 뜬다. 클로드가 응답을 쓰는 중에도 물을 수 있고, 본 작업을 끊지 않는다. 대신 도구를 쓰지 못한다. 이미 대화에 있는 내용만으로 답하고, 파일을 읽거나 명령을 돌리거나 검색하지 않는다. 뒤이은 곁질문은 앞의 곁질문도 보는데, 물을 때마다 가장 나중의 20번 주고받기를 다시 보낸다. 겹창에서 x를 누르면 그 기록이 지워지고, f를 누르면 그 질문과 답을 도구를 쓸 수 있는 하위 에이전트로 넘긴다.
일을 마무리할 때는 /diff로 바뀐 내용을 본다. 클로드가 고친 것과 아직 커밋하지 않은 다른 변경이 함께 보인다. 전체 화면 렌더링에서는 대화 옆에 계속 열려 있는 패널로, 기본 렌더러에서는 입력창 위의 대화 상자로 열린다. 패널을 쓰려면 git 저장소, 110칸 이상 너비의 터미널, Claude Code v2.1.287 이상이 필요하다. 그다음 /code-review로 지금 변경에서 정확성 버그를 찾고, --fix를 붙이면 찾은 것을 고치게 한다. /review는 같은 명령의 별칭이다. 보안 쪽은 /security-review가 맡는데, 지금 브랜치와 origin의 기본 브랜치 사이 차이를 보므로 origin 원격 저장소가 있어야 한다.
세션 사이와 문제가 생겼을 때. /clear는 맥락을 비우고 새 대화를 시작하되 프로젝트 메모리는 남긴다. 비운 대화는 /resume으로 다시 불러올 수 있다. /branch는 지금 대화를 그 자리에서 갈라 다른 방향을 시험하게 하고, 원래 대화는 /resume으로 돌아갈 수 있게 남긴다. 일이 틀어지면 /rewind로 코드와 대화를 체크포인트로 되돌린다. 설치나 설정이 이상하면 /doctor가 점검하고 고칠 것을 제안하며, 고치기 전에 확인을 받는다.
인용 — Claude Code Docs «Commands»«A command is only recognized at the start of your message.» — 명령은 메시지 맨 앞에 있을 때만 알아듣는다.
문서는 이어서 명령 이름 뒤에 오는 글자는 그 명령의 인수가 된다고 적었다. 문장 중간에
/compact를 써 넣어도 그 자리에서 대화가 요약되지는 않는다.
슬래시 명령이 안 먹힐 때 — Unknown command와 안 보이는 명령
가장 흔한 것은 Unknown command: /hepl. Did you mean /help? 같은 메시지다. 대화형 터미널 세션에서 지금 세션의 어떤 명령과도 맞지 않는 이름을 보내면, 클로드 코드는 아무것도 돌리지 않고 이 메시지를 띄우며 가장 가까운 이름을 제안한다. 오류 문서는 원인을 세 가지로 든다. 첫째는 단순한 오타다. 둘째는 명령은 있지만 플랫폼 · 요금제 · 인증 방식 같은 조건이 맞지 않아 이 세션에서 쓸 수 없는 경우다. 셋째는 플러그인이나 MCP 서버가 더하는 명령인데 그 플러그인이 설치되지 않았거나 서버가 연결되지 않은 경우다.
조건이 붙은 명령은 생각보다 많다. 공식 문서는 모든 명령이 모든 사용자에게 보이지는 않는다고 적고, /desktop은 macOS와 x64 Windows에서 Claude 구독으로 로그인했을 때만, /upgrade는 Enterprise 요금제에서는 보이지 않는다는 예를 든다. /privacy-settings는 Pro · Max · Ultra 구독에서만 쓸 수 있다. 쓸 수 없는 명령은 메뉴에서 빠지고, 맞는 것이 하나도 없으면 No commands match "/name"이 뜬다.
숨긴 명령, 없어진 명령, 그냥 메시지로 가는 경우
일부러 메뉴에서 숨긴 명령도 있다. /heapdump가 그런 예로, 이름 일부만 쳐서는 메뉴에 나타나지 않고 전체 이름을 다 쳐야 목록에 뜨고 실행된다. /setup-bedrock · /setup-vertex도 해당 환경 변수를 켜기 전까지는 메뉴에 안 보인다.
블로그나 예전 영상에서 본 명령이 안 되는 경우도 있다. 공식 표에는 없어진 명령이 대신 쓰는 길과 함께 남아 있다. /vim은 v2.1.92에서 없어졌고, Vim과 일반 편집 모드는 /config의 Editor mode에서 바꾼다. /pr-comments는 v2.1.91에서 없어졌으니 풀 리퀘스트 댓글은 클로드에게 직접 보여 달라고 하면 된다. /ultraplan도 없어졌고 계획 모드를 대신 쓴다. 이름은 그대로인데 하는 일이 바뀐 것도 있다. /agents는 v2.1.197까지는 하위 에이전트를 만드는 화면을 열었지만, 지금은 클로드에게 만들어 달라고 하거나 .claude/agents/ 폴더를 직접 고치라는 안내만 출력한다. 명령이 문서와 다르게 동작한다면 /release-notes로 판마다 바뀐 점을 보거나 /status로 지금 판을 확인한다.
세션 종류에 따라 반응도 다르다. Unknown command는 대화형 터미널에서만 뜬다. -p로 돌리는 실행, Agent SDK, 데스크톱 앱의 Code 탭, VS Code 확장의 채팅 패널, 클라우드 세션에서는 맞지 않는 / 이름을 일반 메시지로 클로드에게 보내면서, 명령이 돌지 않았다는 알림과 그 세션에서 쓸 수 있는 명령 목록을 붙인다. 또 / 바로 뒤가 문장 부호로 시작하거나 /var/log/syslog처럼 경로이면 명령으로 보지 않고 일반 메시지로 보낸다.
표의 위 세 줄은 «그 명령이 이 세션의 메뉴에 있느냐»의 문제이고, 아래 세 줄은 «언제 · 어디서 · 어느 판에서 보내느냐»의 문제다. 메뉴에 없는 명령을 글로 찾아 헤매기보다 /를 치고 몇 글자를 넣어 지금 세션의 목록을 먼저 보는 쪽이 빠르다. 설치 직후라 기본 명령조차 낯설다면 클로드 코드 설치·요금제·첫 사용 (2026) — Windows에서 시작하기에서 첫 실행과 /help · /resume 부분을 먼저 보면 된다.
내 명령어 만들기와 알아 둘 주의 — 스킬 · 인수 · 되돌리기
자주 치는 요청이 있다면 내 명령으로 만들 수 있다. 공식 스킬 문서는 사용자 명령이 스킬로 합쳐졌다고 적었다. .claude/commands/deploy.md 파일과 .claude/skills/deploy/SKILL.md 스킬은 둘 다 /deploy를 만들고 같은 방식으로 돈다. 예전에 만든 .claude/commands/ 파일도 계속 쓸 수 있지만, 새로 만든다면 보조 파일 폴더를 둘 수 있는 스킬 쪽을 권한다.
스킬 폴더 이름(또는 머리말의 name)이 입력창에 치는 명령 이름이 된다. 홈 폴더의 ~/.claude/skills/에 두면 이 PC의 모든 프로젝트에서, 프로젝트의 .claude/skills/에 두면 그 저장소에서 쓴다. 같은 이름이 겹치면 개인 스킬이 프로젝트 스킬을 이기고, 스킬과 .claude/commands/ 파일이 겹치면 스킬이 이긴다. 머리말에 disable-model-invocation: true를 넣으면 클로드가 알아서 부르지 않고 사용자가 /이름으로 부를 때만 돈다. 예를 들어 회의 메모를 늘 같은 틀로 정리하고 싶다면 프로젝트의 .claude/skills/meeting-notes/SKILL.md를 이렇게 만들 수 있다.
---
description: 회의 메모 파일을 읽고 결정 · 할 일 · 확인할 것으로 정리한다.
disable-model-invocation: true
---
$ARGUMENTS 파일을 읽고 다음 세 칸으로 정리해 줘.
1. 결정된 것
2. 할 일과 담당
3. 다음 회의 전에 확인할 것
원문에 없는 내용은 쓰지 말 것.
인수 넘기기, 여러 스킬 잇기, 지우거나 되돌리기 전 확인
위 파일을 만든 뒤 /meeting-notes 회의메모.md라고 보내면 $ARGUMENTS 자리에 회의메모.md가 들어간다. 인수를 하나씩 따로 쓰고 싶으면 $ARGUMENTS[0]이나 줄여서 $0 · $1을 쓰고, 띄어쓰기가 든 값은 따옴표로 묶어 하나로 넘긴다. 터미널 입력창에서는 /skill-a /skill-b 할 일처럼 메시지 맨 앞에 스킬을 여러 개 이어 쓸 수 있고, 최대 6개까지 잇는다. 단 claude -p나 Agent SDK에서는 첫 스킬만 불러오고 나머지 줄은 그 스킬의 인수로 넘어간다. 스킬을 고치거나 더한 뒤에는 /skills로 목록을 보고, 디스크에서 바꾼 스킬이 안 잡히면 /reload-skills로 다시 읽힌다. 스킬을 쓰는 법 자체는 클로드 스킬 — 반복하는 일을 규칙으로 저장하고 꺼내 쓰는 법에서 더 자세히 다뤘다.
명령 가운데 결과가 큰 것은 누르기 전에 한 번 더 본다. /clear는 맥락을 비우고 새 대화를 시작하므로, 이어 가던 일이 있다면 /compact가 맞는지 먼저 따진다. 비운 대화는 /resume으로 다시 열 수 있고, /clear 로그인 수정처럼 이름을 붙여 두면 /resume 목록에서 찾기 쉽다. /rewind는 코드와 대화를 앞선 지점으로 되돌리거나 고른 메시지부터 요약하므로, 무엇을 어디까지 되돌리는지 확인하고 넘어간다.
밖으로 무엇이 나가는 명령도 있다. /bug와 /feedback은 세션 기록을 얼마나 넣을지 고르고, 보내기 전에 동의 화면에서 확인을 받는다. /heapdump가 만드는 파일 가운데 .heapsnapshot에는 대화 전체와 인증 정보가 들어 있으므로 남에게 보내지 말고, 메모리 문제를 알릴 때는 -diagnostics.json 파일만 붙이라고 문서가 못 박았다. /export는 대화를 글 파일로 내보내고 /copy는 마지막 답을 클립보드에 넣으므로, 회사 코드나 개인 정보가 섞인 대화라면 붙여 넣을 곳을 한 번 더 확인한다.
처음 쓰는 사람이라면 내 명령은 한두 개면 충분하다. 매번 같은 말로 시작하는 요청 하나를 골라 스킬로 옮겨 보고, 그 명령이 원하는 대로 돌면 그다음 것을 더한다. 명령을 많이 만들수록 / 메뉴도 길어지므로, /skills에서 t를 눌러 맥락을 많이 차지하는 순서로 보고 안 쓰는 것을 정리한다.
자주 묻는 것
클로드 코드 명령어 전체 목록은 어디서 보나요?
입력창에 /를 치면 지금 세션에서 쓸 수 있는 명령이 나오고, 글자를 더 치면 목록이 좁혀집니다. /help도 도움말과 쓸 수 있는 명령을 보여 줍니다. 요금제나 플랫폼에 따라 보이는 명령이 다르므로, 전체 표는 Claude Code 공식 Commands 문서에서 확인합니다.
/clear와 /compact는 무엇이 다른가요?
/clear는 맥락을 비우고 새 대화를 시작하며 프로젝트 메모리는 남깁니다. 비운 대화는 /resume으로 다시 열 수 있습니다. /compact는 같은 대화를 이어 가면서 지금까지의 내용을 요약해 맥락 자리를 비우고, 요약할 방향을 함께 넘길 수 있습니다.
문장 중간에 슬래시 명령을 써도 되나요?
명령은 메시지 맨 앞에 있을 때만 실행됩니다. 문장 중간에서 /와 첫 글자를 치면 명령 이름 자동 완성은 되지만, 그 자리에서 명령이 돌지는 않습니다.
예전 글에서 본 명령이 Unknown command로 나와요.
오타가 아니라면 이 세션의 요금제 · 플랫폼 · 인증 조건이 맞지 않거나, 플러그인 · MCP 서버가 연결되지 않았거나, 없어진 명령일 수 있습니다. 예를 들어 /vim은 v2.1.92에서 없어졌고 /config의 Editor mode로 바뀌었습니다.
내 명령은 어떻게 만드나요?
.claude/skills/이름/SKILL.md 파일을 만들면 /이름으로 부를 수 있습니다. 예전 형식인 .claude/commands/이름.md도 계속 동작하며, 명령 뒤에 쓴 글자는 $ARGUMENTS 자리에 들어갑니다.
정리 — 명령은 맨 앞에, 목록은 / 한 글자로
슬래시 명령은 세션 안에서 클로드 코드를 다루는 명령이고, 메시지 맨 앞에 있을 때만 알아들으며 뒤에 쓴 글자는 인수가 된다. 처음 저장소에서는 /init · /memory · /permissions, 작업 중에는 /plan · /context · /compact · /btw, 끝내기 전에는 /diff · /code-review, 세션 사이에는 /clear · /resume · /rewind가 손이 자주 가는 묶음이다. Unknown command가 뜨면 오타, 요금제 · 플랫폼 조건, 플러그인 · MCP 연결, 없어진 명령 순서로 본다. 자주 쓰는 요청은 .claude/skills/의 SKILL.md로 내 명령을 만들고 $ARGUMENTS로 값을 넘긴다. 명령 이름과 기본 동작은 판마다 자주 바뀌므로 이 글은 2026년 10월 31일 기준으로 읽고, 쓰기 전에 공식 문서나 /release-notes를 한 번 더 확인한다. 지금 하나만 해 본다면, 대화가 길어졌을 때 /context로 맥락 창이 무엇으로 차 있는지부터 열어 보자.
참고 자료
- Claude Code Docs. Commands — 명령은 메시지 맨 앞에서만 인식 · 뒤 글자는 인수 · 스킬 최대 6개 잇기 · 응답 중이면 대기열 · /status · /tasks · /usage 즉시 · 시점별 명령 묶음 · 전체 명령 표(별칭 · 요구 판 · 없어진 명령) · 메뉴가 거르는 방식(강조 · 오타 · 안 보이는 명령 · 숨긴 명령) · 꺾쇠(필수) · 대괄호(선택) 인수 표기(2026-10-31 확인). code.claude.com
- Claude Code Docs. Interactive mode — / 메뉴에 내장 명령 · 스킬 · 플러그인 · MCP 명령이 함께 나옴 · 문장 중간 명령 완성 · ! 셸 모드 · @ 파일 · /diff 패널과 대화 상자 · /btw 곁질문(도구 없음 · 기록에 안 남음 · 가장 나중의 20번 주고받기 다시 보냄 · x · f)(2026-10-31 확인). code.claude.com
- Claude Code Docs. Extend Claude with skills — 사용자 명령이 스킬로 합쳐짐 · .claude/commands 파일 계속 동작 · 스킬 위치와 이름 · 같은 이름일 때 우선순위 · disable-model-invocation · $ARGUMENTS · $N · 따옴표 · -p는 첫 스킬만(2026-10-31 확인). code.claude.com
- Claude Code Docs. Error reference — Unknown command — Unknown command 메시지와 Did you mean · 원인(오타 · 요구 조건 · 플러그인 · MCP) · -p · Agent SDK · 데스크톱 Code 탭 · VS Code 채팅 · 클라우드에서는 일반 메시지로 보냄 · 경로처럼 생긴 /는 명령 아님(2026-10-31 확인). code.claude.com
- Claude Code 문서. 명령 — 한국어판 «명령» «번들 스킬» «대기열» 용어와 시점별 묶음 설명(2026-10-31 확인). code.claude.com
