Claude Code 슬래시 명령 모드

Claude Code 슬래시 명령 모드는 /tally나 /diff처럼 프롬프트에 입력하는 명령을 추가하고, 그 명령에 코드로 답합니다. 핸들러가 Claude Code 내부에서 실행되기 때문에 모드가 수집한 데이터로 즉시 응답하거나, 패널을 열거나, 설정을 바꿀 수 있으며 이 과정에서 모델에 요청을 보내지 않고 토큰도 사용하지 않습니다.

Claude Code 슬래시 명령 모드는 명령을 어떻게 등록하나요?#

모드는 보통 session.start 훅에서 $.command.register({ name, description })를 호출한 다음, 해당 이름에 대한 매처를 붙여 command.run을 처리합니다: on('command.run', { command: 'tally' }, ...). 핸들러가 { text }를 반환하면 답변이 출력되고 대화 기록에 Markdown으로 렌더링되며, {}를 반환하면 아무 출력 없이 끝납니다. 명령 이름에는 영문자, 숫자, _, -를 쓸 수 있고 최대 64자까지 가능합니다.

같은 command.run 이벤트는 다른 모든 명령에 대해서도 발생하므로, 모드는 기본 제공 명령을 감쌀 수도 있습니다. command.describe를 사용하면 명령 목록에서 명령이 표시되는 방식을 바꿀 수 있고, $.command.run을 사용하면 한 모드가 다른 명령을 호출할 수 있습니다. 만들기 가이드에서 /tally 예제를 단계별로 살펴볼 수 있습니다.

설치하기 전에 무엇을 확인해야 하나요?#

명령 모드에는 명령어/도구 추가 배지가 표시됩니다. 이 배지만으로는 위험이 낮습니다. 명령은 직접 입력할 때만 실행되기 때문입니다. 중요한 것은 명령이 실행될 때 무엇을 하느냐이므로 나머지 배지도 읽어 보시기 바랍니다. 모드 상태를 읽어 표를 출력하는 명령이라면 다른 권한이 필요 없습니다. 패널을 여는 명령에는 UI 변경이 추가됩니다. git을 실행하거나, 파일을 읽거나, 서버를 호출하는 명령에는 명령어 실행, 파일 읽기, 네트워크가 표시됩니다.

이름 충돌도 확인하시기 바랍니다. 두 모드가 같은 명령 이름을 등록하려고 할 수 있으므로, 구체적인 이름을 사용하고 그 이름을 페이지에 명시한 모드를 선택하는 것이 좋습니다.

프롬프트 대신 모드 명령을 써야 하는 경우는 언제인가요?#

답이 기계적으로 정해지는 작업이라면 모드 명령을 사용합니다. 개수 세기, 목록 출력, 설정 켜고 끄기, 화면 열기 같은 작업이 여기에 해당합니다. Claude가 답을 생각해 주기를 원한다면 일반 명령 파일이나 스킬을 사용합니다. 유용한 모드 중 상당수는 두 방식을 결합해, 훅에서 데이터를 수집하고 하나의 명령으로 그 결과를 보고합니다.