Claude Code 슬래시 명령어: 세션을 조작하는 리모컨

에이전트와의 대화는 단순해 보입니다. 평범한 말로 할 일을 적으면 에이전트가 처리하죠. 그런데 같은 입력 줄에는 두 번째 입구가 있습니다. 메시지를 슬래시 /로 시작하면 Claude Code는 자기 명령어 메뉴에서 맞는 항목을 찾습니다.

이 글에서는 무엇보다 세션을 제어하는 명령어를 다룹니다. 실행부터 종료까지, 지금 진행 중인 대화 전체를 다루는 명령어입니다. 이 명령어로 모델을 바꾸고, 대화를 정리하고, 상태를 확인하고, 실패한 시도를 되돌립니다. 가장 이해하기 쉬운 비유는 리모컨입니다. 세션에는 자기 버튼이 따로 있고, 작업 이야기와는 별도로 그 버튼을 누릅니다. 다만 슬래시로 시작하는 줄이 모두 리모컨 버튼은 아닙니다. 같은 메뉴로 연결된 도구의 사전 시나리오와 prompts도 실행됩니다. 인터페이스에서는 이를 skills, workflows라고 부르며, 이들은 에이전트에게 온전한 작업을 넘기고 프로젝트를 바꿀 수 있습니다.

아래에서는 어떤 명령어든 2초 만에 찾는 법, 처음부터 알아 두면 좋은 열두 가지 명령어, 그냥 호기심에 눌러도 괜찮은 것과 디스크의 파일을 고쳐 쓸 수 있는 것을 다룹니다.

에이전트와 대화하는 두 가지 방법

자유로운 텍스트는 작업을 지시합니다. "페이지에 문의 폼을 추가해 주세요"라고 하면 에이전트가 파일을 읽고, 무엇을 바꿀지 판단해서 바꿉니다.

이 절에서 다루는 내장 명령어는 세션을 제어합니다. /model은 모델을 바꾸고, /clear는 대화를 다시 시작하며, /status는 지금 무엇으로 작업 중인지 보여 줍니다. 이때 프로젝트 파일은 대부분 아예 건드리지 않습니다.

혼란의 원인이 되는 기술적 규칙이 하나 있습니다. 명령어는 메시지 맨 앞에서만 인식됩니다. 문장 중간의 슬래시는 그냥 문자일 뿐, 거기에 명령어는 없습니다. 그리고 명령어 이름 뒤에 오는 내용은 전부 그 명령어의 인자가 됩니다.

입력한 내용	에이전트가 읽는 방식
페이지에 문의 폼을 추가해 주세요	평범한 말로 된 작업, 슬래시는 아예 없음
`/compact` 폼 레이아웃에 관한 내용만 남겨 주세요	명령어이며, 이름 뒤의 내용은 모두 인자
경로 `src/main/index.html`을 고쳐 주세요	슬래시는 있지만 맨 앞이 아니라서 명령어가 아님

응답 도중 보낸 명령어는 사라지지 않는다

에이전트가 아직 답하는 중에 명령어를 보내면 대기열에 들어가고, 지금 하는 단계가 끝나는 대로 실행됩니다. 일부 명령어는 다르게 동작해서 답을 끊지 않고 바로 실행됩니다. 예를 들면 /status가 그렇습니다.

원하는 명령어를 찾는 법

목록을 외울 필요는 없습니다. 이 글에서 얻어 갈 것 중 아마 가장 중요한 점일 겁니다 😅. 빈 줄에 /를 입력하면 사용 가능한 모든 명령어가 담긴 메뉴가 열립니다. 글자를 몇 개 더 치면 목록이 좁혀지고, Tab으로 선택된 항목을 받아들입니다.

메뉴 대신 설명이 담긴 도움말을 원한다면 /help가 있습니다. "여기 대체 뭐가 있지"라는 질문에 대한 답입니다.

메뉴에는 내장 명령어만 있는 게 아닙니다. 플러그인과 연결된 도구의 skills, workflows, prompts도 함께 들어갑니다. 이들은 제어 버튼이 아니라 사전 시나리오입니다. 에이전트에게 지시를 전달하고, 도구를 실행하며, 프로젝트를 바꿀 수 있습니다. 그래서 목록은 프로젝트와 함께 늘어나고, 직접 추가할 수도 있지만 이건 이 글이 아니라 다른 주제입니다.

미리 짚고 넘어갈 점 하나. 목록은 사람마다 다릅니다. 일부 명령어는 플랫폼, 요금제, 프로젝트에 연결된 것에 따라 달라집니다. 아래 표에 있는 줄이 본인 화면에 없다고 해도 정상이지, 고장이 아닙니다.

처음에 알아 두면 좋은 기본 세트

오래 쓸 열두 가지 명령어입니다. 외울 필요는 없고, 한 번 읽어 두고 존재한다는 것만 알면 충분합니다.

명령어	하는 일	언제 쓸모 있나
`/help`	도움말과 사용 가능한 명령어 목록	어떤 게 있는지 잊었을 때
`/status`	버전, 모델, 계정, 연결 상태	지금 정확히 무엇으로 작업 중인지 모를 때
`/doctor`	설치와 설정 점검: `PATH`, 중복 설치, 읽을 수 없는 설정 파일. 발견한 문제는 고치자고 제안하지만, 여러분이 확인한 뒤에만 고침	에이전트는 실행되는데 이상하게 동작할 때
`/model`	모델 바꾸기	작업에 다른 모델이 필요할 때
`/ide`	에디터와의 연결 상태	플러그인은 연결됐는데 제대로 동작하지 않을 때
`/context`	컨텍스트 창을 정확히 무엇이 차지하고 있는지	대화가 길어져서 무엇 때문인지 알고 싶을 때
`/clear`	대화를 깨끗한 상태로 다시 시작	작업을 바꿨을 때
`/compact`	대화를 짧게 요약	대화는 길어졌지만 작업은 그대로일 때
`/rewind`	대화나 코드를 이전 시점으로 되돌리기	마지막 시도가 전부 망가뜨렸을 때
`/resume`	저장된 다른 대화로 전환	어제 작업으로 돌아가야 할 때
`/cost`	얼마나 썼는지, `/usage`와 같음	세션 비용이 궁금할 때
`/exit`	종료	작업 끝

/rewind에 대해 따로 짚자면, 이 명령어에는 /undo와 /checkpoint라는 별칭이 있습니다. 그러니 습관적으로 "undo"라고 쳐도 그대로 동작합니다.

명령어가 바꾸는 것, 그리고 보여만 주는 것

표의 명령어 세트는 세 그룹으로 나뉘고, 이 차이는 언뜻 보이는 것보다 중요합니다.

보여만 준다. /help, /status, /context, /cost, /ide. 프로젝트도 대화도 아무것도 바꾸지 않습니다. 원하는 만큼 눌러도 됩니다.
대화나 에이전트 설정은 바꾸지만 프로젝트 파일은 건드리지 않는다. /clear, /compact, /resume은 에이전트 머릿속에 있는 것만 다룹니다. 앞의 두 개는 지금 진행 중인 대화를, 세 번째는 다른 대화로 바꿔치기합니다. /model은 모델을 바꾸고 새 세션을 위해 선택을 기억해 둡니다. /exit는 세션을 닫지만, 대화는 저장된 채로 남습니다.
디스크의 파일을 바꿀 수 있다. /rewind와 /doctor입니다. 첫 번째는 코드를 이전 상태로 되돌리는 유일한 명령어입니다. 두 번째는 코드를 건드리지 않지만 설정은 물론 CLAUDE.md와 프로젝트의 skills 수정도 제안할 수 있고, 이 수정은 여러분이 확인한 뒤에만 적용됩니다.

/rewind은 조심해서

기본 세트에서 디스크의 코드를 바꾸는 명령어는 이것 하나뿐입니다. 메뉴에서 돌아갈 시점과 무엇을 되돌릴지 - 코드, 대화, 혹은 둘 다 - 고르게 됩니다. 누르기 전에 선택한 내용을 확인하세요. 그 시점 이후 에이전트가 자기 편집 도구로 한 수정은 사라집니다. 서브에이전트의 수정은 보통 여기에 포함되지 않습니다. 에이전트가 터미널 명령으로 한 것 - rm, mv, 스크립트 - 과, 에이전트가 건드리지 않은 파일에 여러분이 직접 한 수정은 되돌리기가 건드리지 않으니 다른 방법으로 되돌려야 합니다.

손실 이야기가 나온 김에 하나 더. /clear는 아무것도 지우지 않습니다. 프로젝트 파일도, 지난 대화도요. 파일은 디스크에 있던 그대로 남아 있고, 대화는 저장된 채로 남아서 돌아갈 수 있습니다. 그저 깨끗한 상태에서 다시 시작할 뿐입니다.

명령어, 플래그, 단축키

제어는 세 곳으로 나뉘어 있고, 혼란은 보통 여기서 시작됩니다.

왼쪽은 터미널에 입력, 오른쪽은 이미 열린 에이전트의 입력 줄에 입력

경계선은 실행 시점에 있습니다. 그 왼쪽에는 아직 에이전트가 없고 대화할 상대도 없어서 플래그만 동작합니다. 오른쪽에는 에이전트가 열려 있고, 두 입구 모두 같은 세션으로 이어집니다.

슬래시 명령어는 이미 실행 중인 세션 안에서 동작합니다. 에이전트가 열려 있고, 입력 줄에 직접 입력합니다.

플래그는 세션이 아직 없는 실행 시점에 지정합니다. 에이전트의 입력 줄이 아니라 터미널에, claude 명령어 옆에 씁니다. 독립된 명령어가 아니라 평범한 실행에 붙이는 추가 옵션입니다.

claude              # 보통 실행, 깨끗한 상태로 시작
claude --continue   # 이 폴더의 마지막 대화를 이어서
claude --resume     # 목록에서 대화 선택

에이전트는 어느 쪽이든 시작됩니다. 플래그는 무엇으로 시작할지만 정합니다. 빈 대화로 할지, 예전 대화 중 하나로 할지.

같은 일을 두 군데서 하는 짝을 보면 가장 이해하기 쉽습니다.

claude --resume     # 세션이 시작되기 전, 대화 목록
/resume             # 이미 열린 세션 안에서 같은 목록

단축키는 세 번째 자리입니다. 수는 많지 않지만 명령어보다 자주 여러분을 구해 줍니다.

Esc는 지금 나오는 답을 중단합니다. 작업은 사라지지 않고, 에이전트가 그냥 멈출 뿐입니다.
Esc Esc를 빈 줄에서 누르면 되돌리기 메뉴가 열립니다. /rewind와 같은 것입니다.
Tab은 자동 완성 제안을 받아들입니다.
Shift+Tab은 권한 모드를 전환합니다. 즉 에이전트가 여러분에게 묻지 않고 얼마나 독자적으로 파일을 고칠지를 정합니다.

두 번 누르는 Esc에는 다들 한 번쯤 걸리는 함정이 있습니다. 되돌리기 메뉴는 입력 줄이 비어 있을 때만 열립니다. 뭔가 입력해 둔 상태라면, 처음의 두 번 Esc는 입력한 내용을 지울 뿐입니다. 그렇다고 텍스트가 사라지는 건 아닙니다. 입력 기록으로 들어가고, 위쪽 화살표를 누르면 돌아옵니다.

일상 작업에 왜 필요한가

이 글의 제어 명령어는 작업을 더 잘 설명하는 것과는 상관없습니다. 세션을 작업 가능한 상태로 유지하는 데 도움을 줍니다. 한편 / 메뉴 전체는 그보다 넓습니다. skills와 workflows는 작업 자체를 실행할 수 있습니다. 기억해 둘 만한 몇 가지입니다.

임의의 작업에 대한 답의 품질은 이 제어 명령어로 좋아지지 않습니다. 여전히 평범한 말로 무엇을 썼는지에 달려 있습니다.
뭔가 잘못됐을 때 보통 순서는 정해져 있습니다. 무엇으로 작업 중인지 보려면 /status, 대화가 무엇을 차지하고 있는지 보려면 /context, 그런 다음에야 /clear, /compact, /rewind 중 하나를 고릅니다.
내장 인터페이스 명령어는 여러분이 직접 실행합니다. skill은 설명이 작업에 맞으면 자동으로 연결될 수 있는데, 이건 이미 세션 제어 버튼이 아니라 에이전트에게 주는 지시입니다.
/ 메뉴는 프로젝트와 함께 늘어납니다. 플러그인을 연결하거나 skill을 추가하면, 어제는 없던 줄이 목록에 나타납니다.
/doctor는 따로 기억해 둘 만합니다. 프로젝트 코드가 아니라 에이전트의 설치와 설정을 살펴보고, CLAUDE.md를 줄이자고 제안할 수도 있으며, 여러분의 "네" 없이는 아무것도 바꾸지 않습니다. claude가 실행 직후부터 이상하게 동작한다면 여기서 시작하는 게 합리적입니다. 그리고 claude가 아예 시작되지 않아서 명령어를 입력할 곳이 없다면, 터미널에서 claude doctor를 실행하세요. 이건 아무것도 고치지 않고 진단만 보여 줍니다.

명령어 이름을 외우려 하지 마세요

/와 하고 싶은 일의 첫 글자 몇 개만 입력하세요. 메뉴가 알아서 걸러 줍니다. 정확한 철자를 떠올리는 것보다 빠르고, 인터넷에서 찾는 것보다 확실합니다.

메뉴 구성은 Claude Code 버전, 플랫폼, 요금제에 따라 달라지므로 여러분의 목록은 여기 나온 것과 다를 수 있습니다. 지금 본인 환경의 실제 세트는 언제나 /help가 보여 줍니다.