참고 가이드

Claude Code 명령어

Claude Code에서 사용할 수 있는 모든 슬래시 명령어의 완전한 참고 가이드입니다. 내장 명령어를 배우고, 커스텀 명령어를 만들고, Claude Code 명령어로 효율적인 워크플로우를 구축하세요.

Claude Code 명령어란?

Claude Code 명령어는 Claude Code CLI에서 직접 입력하여 특정 작업을 수행하는 슬래시 명령어입니다. 모든 명령어는 슬래시(/)로 시작하며 그 뒤에 명령어 이름이 옵니다. 슬래시 명령어를 입력하면 Claude Code는 대화형 프롬프트가 아닌 즉시 해당 작업을 실행합니다.

Claude Code 명령어는 AI 코딩 어시스턴트의 제어 레이어라고 생각하면 됩니다. 자연어 프롬프트가 Claude에게 무엇을 만들지 알려주는 반면, 슬래시 명령어는 도구 자체의 동작을 제어합니다. 세션을 관리하고, 모델을 전환하고, 권한을 제어하고, 터미널을 떠나지 않고 특정 워크플로우를 트리거할 수 있습니다.

Claude Code에는 가장 일반적인 작업을 처리하는 내장 슬래시 명령어가 포함되어 있습니다. /clear와 /compact 같은 세션 관리 명령어, /model과 /permissions 같은 구성 명령어, /cost와 /review 같은 유틸리티 명령어가 포함됩니다.

내장 옵션 외에도 Claude Code는 직접 정의하는 커스텀 슬래시 명령어를 지원합니다. .claude/commands/ 디렉토리에 마크다운 파일을 추가하면 프로젝트에 맞춤화된 재사용 가능한 명령어 템플릿을 만들 수 있습니다. 커스텀 Claude Code 명령어는 팀 전체가 한 번의 슬래시로 호출할 수 있는 팀 전용 워크플로우를 인코딩하는 데 특히 유용합니다.

내장 Claude Code 명령어

Claude Code에는 세션 관리, 구성, 인증, 개발 워크플로우를 다루는 15개의 내장 슬래시 명령어가 포함되어 있습니다. 이러한 명령어는 별도의 설정 없이 모든 Claude Code 세션에서 사용할 수 있습니다. 현재 세션에서 사용 가능한 모든 Claude Code 명령어 목록을 보려면 언제든지 /help를 입력하세요.

/help

도움말 보기 및 사용 가능한 명령어 확인

사용 가능한 모든 Claude Code 명령어의 목록과 간단한 설명을 표시합니다. 새로운 사용자가 처음으로 실행해야 할 명령어입니다.

/clear

대화 기록 초기화

현재 대화를 초기화하여 컨텍스트에서 이전 메시지를 모두 제거합니다. 이전 작업의 잔여 컨텍스트 없이 새로 시작하고 싶을 때 유용합니다.

/compact

대화를 압축하여 컨텍스트 절약

현재 대화를 더 짧은 표현으로 요약하여 컨텍스트 윈도우 공간을 확보합니다. 토큰 제한에 가까워지는 긴 세션에서 필수적인 명령어입니다.

/cost

토큰 사용량 및 비용 표시

현재 세션에서 소비된 토큰의 분석과 예상 비용을 표시합니다. 지출을 모니터링하고 Claude Code 명령어 사용을 최적화하는 데 도움이 됩니다.

/doctor

Claude Code 구성 확인

Claude Code 설치에 대한 진단 검사를 실행하여 인증, 구성 파일, 환경 설정을 확인합니다. 문제 해결 시 먼저 이 명령어를 실행하세요.

/init

CLAUDE.md로 프로젝트 초기화

권장 구조와 설정으로 프로젝트 루트에 CLAUDE.md 파일을 생성합니다. 이 파일은 Claude가 자동으로 읽는 영구적인 프로젝트 수준 지시사항을 제공합니다.

/login

Anthropic 인증

Claude Code 세션을 Anthropic 계정에 연결하는 인증 흐름을 시작합니다. API와 상호작용하는 Claude Code 명령어를 사용하기 전에 필요합니다.

/logout

현재 세션에서 로그아웃

현재 Claude Code 세션에서 Anthropic 계정을 연결 해제합니다. 계정 간 전환이나 공유 머신에서 사용할 때 유용합니다.

/mcp

MCP 서버 관리

Model Context Protocol (MCP) 서버 연결을 나열, 추가 또는 제거합니다. MCP 서버는 데이터베이스, API, 파일 시스템 등의 외부 도구 접근으로 Claude Code를 확장합니다.

/memory

메모리 보기 및 관리

CLAUDE.md 메모리 파일의 내용을 표시하고 영구 지시사항을 편집할 수 있게 합니다. 메모리는 세션 간에 유지되어 Claude Code 명령어의 강력한 보완 도구가 됩니다.

/model

모델 전환

Claude Code에서 사용하는 기본 모델을 변경합니다. 빠른 작업에는 Haiku, 코딩에는 Sonnet, 깊은 추론에는 Opus 사이를 세션을 떠나지 않고 전환할 수 있습니다.

/permissions

도구 권한 관리

Claude Code가 자동으로 사용할 수 있는 도구와 확인이 필요한 도구를 제어합니다. 파일 편집, 명령어 실행 등의 작업에 대한 권한을 세밀하게 조정합니다.

/review

코드 변경 사항 리뷰

현재 변경 사항에 대한 코드 리뷰를 트리거하여 버그, 스타일 문제, 잠재적 개선 사항을 분석합니다. 품질 보증을 위해 가장 자주 사용되는 Claude Code 명령어 중 하나입니다.

/status

세션 상태 표시

활성 모델, 토큰 사용량, 연결된 MCP 서버, 설치된 스킬을 포함한 현재 Claude Code 세션의 정보를 표시합니다.

/vim

Vim 모드 전환

Claude Code 인터페이스에서 vim 스타일 키 바인딩을 활성화하거나 비활성화합니다. Vim 내비게이션을 선호하는 개발자를 위해 편집 경험을 자연스럽게 만들어줍니다.

Claude Code의 커스텀 슬래시 명령어

Claude Code 명령어의 가장 강력한 기능 중 하나는 직접 커스텀 슬래시 명령어를 만들 수 있다는 것입니다. 커스텀 명령어를 사용하면 자주 사용하는 프롬프트, 워크플로우, 템플릿을 팀 누구나 호출할 수 있는 재사용 가능한 단축키로 만들 수 있습니다.

커스텀 명령어를 만들려면 .claude/commands/ 디렉토리에 마크다운 파일을 추가하세요. 이 디렉토리를 프로젝트 루트에 배치하면 프로젝트별 명령어로, 홈 디렉토리에 배치하면 모든 프로젝트에서 사용할 수 있는 전역 명령어로 사용할 수 있습니다. 파일 이름이 명령어 이름이 됩니다 — 예를 들어 deploy.md는 /deploy 명령어를 생성합니다.

마크다운 파일의 내용은 프롬프트 템플릿으로 사용됩니다. 누군가 커스텀 명령어를 실행하면 Claude Code는 마크다운을 읽고 지시사항으로 사용합니다. $ARGUMENTS 플레이스홀더를 포함하면 동적 입력을 받을 수 있습니다 — 예를 들어 파일 경로를 인수로 받는 커스텀 /review 명령어를 만들 수 있습니다.

커스텀 Claude Code 명령어는 코드베이스와 함께 버전 관리됩니다. .claude/commands/ 디렉토리를 리포지토리에 커밋하면 모든 팀 멤버가 자동으로 동일한 프로젝트별 명령어 세트를 얻게 됩니다. 이것은 팀 전체의 워크플로우를 표준화하는 훌륭한 방법입니다.

예제: 커스텀 배포 명령어 만들기

1. 명령어 파일 생성

# File: .claude/commands/deploy.md


Run the deployment pipeline for this project:


1. Run all tests and ensure they pass

2. Build the production bundle

3. Deploy to the $ARGUMENTS environment

4. Verify the deployment was successful

5. Report the deployment URL

2. 커스텀 명령어 사용

# In Claude Code, type:


/deploy staging


# Claude reads deploy.md and replaces

# $ARGUMENTS with "staging", then

# executes the deployment workflow.

더 많은 커스텀 명령어 아이디어

/test 특정 모듈의 테스트 실행
/pr 요약과 함께 풀 리퀘스트 생성
/migrate 데이터베이스 마이그레이션 생성
/refactor 컴포넌트 또는 모듈 리팩토링
/doc 파일에 대한 문서 생성
/fix 보고된 버그 진단 및 수정

Claude Code 명령어 vs 스킬

Claude Code 명령어와 에이전트 스킬은 모두 Claude Code 경험을 향상시키지만, 서로 다른 목적으로 사용됩니다. 각각을 언제 사용해야 하는지 이해하면 가장 효율적인 워크플로우를 구축할 수 있습니다.

항목Claude Code 명령어스킬
목적빠른 작업 즉시 실행지속적인 지식 자동으로 로드
활성화사용자가 슬래시 명령어 입력작업이 일치할 때 Claude가 로드
범위호출당 단일 작업세션 전체에 걸친 지속적 안내
형식.claude/commands/의 마크다운 파일.claude/skills/의 SKILL.md 파일
적합한 용도배포, 리뷰, 일회성 작업코딩 표준, 패턴, 도메인 지식

실제로 가장 생산적인 개발자는 둘 다 사용합니다. Claude Code 명령어는 필요할 때 트리거하는 명시적 작업을 처리하고, 스킬은 모든 응답을 형성하는 배경 지식을 제공합니다. 예를 들어 배포에는 /deploy 커스텀 명령어를 사용하고, "React 모범 사례" 스킬은 Claude가 생성하는 모든 컴포넌트를 안내합니다. Claude Skills 마켓플레이스에서 전체 스킬 라이브러리를 탐색해보세요.

Claude Code 명령어 사용 팁

이 팁들은 기초를 배우는 초보자부터 워크플로우를 최적화하려는 경험 많은 사용자까지 Claude Code 명령어를 최대한 활용하는 데 도움이 됩니다.

모든 프로젝트를 /init으로 시작하세요

새 프로젝트마다 /init을 실행하여 CLAUDE.md 파일을 만드세요. 이를 통해 Claude에게 프로젝트 구조, 코딩 표준, 선호도에 대한 영구적인 컨텍스트를 제공합니다. 응답 품질을 향상시키는 가장 영향력 있는 Claude Code 명령어 중 하나입니다.

긴 세션에서는 /compact 사용하세요

복잡한 기능을 작업할 때 대화가 커질 수 있습니다. /compact를 사용하여 대화를 요약하고 컨텍스트 윈도우 공간을 확보하세요. 이는 Claude Code의 응답성을 유지하고 컨텍스트 제한 근처에서 발생할 수 있는 품질 저하를 방지합니다.

모델을 전략적으로 전환하세요

/model을 사용하여 작업에 맞는 모델을 선택하세요. Haiku는 빠른 편집과 간단한 코드 생성에 적합합니다. Sonnet은 복잡한 코딩 작업에 뛰어납니다. Opus는 깊은 아키텍처 추론에 가장 적합합니다. 모델 전환은 가장 활용도가 낮은 Claude Code 명령어 중 하나입니다.

/cost로 비용을 모니터링하세요

주기적으로 /cost를 실행하여 토큰 사용량을 추적하세요. 이는 Opus를 사용한 장시간 세션에서 특히 중요합니다. /cost와 /compact를 결합하면 품질과 지출을 효과적으로 관리할 수 있습니다.

Git을 통해 커스텀 명령어를 공유하세요

.claude/commands/ 디렉토리를 버전 관리에 커밋하세요. 이를 통해 모든 팀 멤버가 동일한 커스텀 Claude Code 명령어에 접근할 수 있습니다. 누군가 유용한 명령어를 만들면 간단한 git pull로 전체 팀이 혜택을 받습니다.

명령어와 스킬을 결합하세요

최대 생산성을 위해 Claude Code 명령어와 스킬을 함께 사용하세요. 명령어는 명시적 작업(배포, 테스트, 리뷰)을 처리하고 스킬은 배경 지식(코딩 표준, 패턴)을 제공합니다. 함께 사용하면 포괄적인 AI 개발 환경이 만들어집니다.

Claude Code 명령어 FAQ

Claude Code 명령어란 무엇인가요?

Claude Code 명령어는 Claude Code CLI에서 직접 입력하여 특정 작업을 수행하는 슬래시 명령어입니다. 슬래시(/)로 시작하고 그 뒤에 명령어 이름이 옵니다. 내장 명령어는 컨텍스트 초기화, 모델 전환, 권한 관리, 코드 리뷰 등의 작업을 처리합니다. .claude/commands/ 디렉토리에 마크다운 파일을 추가하여 커스텀 Claude Code 명령어를 만들 수도 있습니다.

사용 가능한 모든 Claude Code 명령어는 어떻게 볼 수 있나요?

Claude Code 세션에서 /help를 입력하면 사용 가능한 모든 명령어의 전체 목록을 볼 수 있습니다. 여기에는 내장 Claude Code 명령어와 .claude/commands/ 디렉토리에서 만든 커스텀 명령어가 모두 포함됩니다. 도움말 출력에는 각 명령어 이름과 간단한 설명이 표시됩니다.

커스텀 Claude Code 명령어를 만들 수 있나요?

네. 프로젝트 루트 또는 홈 디렉토리에 .claude/commands/ 디렉토리를 만드세요. 각 커스텀 명령어에 대한 마크다운 파일을 추가합니다(예: deploy.md). 파일 이름이 명령어 이름이 되므로 deploy.md는 /deploy 명령어를 생성합니다. 마크다운 내용은 프롬프트 템플릿으로 사용됩니다. 커스텀 Claude Code 명령어는 동적 입력을 위한 $ARGUMENTS 플레이스홀더를 지원합니다.

Claude Code 명령어와 스킬의 차이점은 무엇인가요?

Claude Code 명령어는 슬래시 명령어 입력으로 트리거되는 빠른 작업입니다. 즉시 실행되며 컨텍스트 초기화나 모델 전환 같은 특정 작업에 이상적입니다. 반면 스킬은 관련 작업 시 Claude가 자동으로 로드하는 지속적인 지식 패키지입니다. 스킬은 세션 전체에 걸쳐 지속적인 안내를 제공하고, 명령어는 일회성 작업입니다. 둘 다 가치가 있습니다 — 명령어는 제어를 위해, 스킬은 지식을 위해 사용합니다.

관련 리소스

명령어를 넘어 Claude Code 지식을 확장하세요. 이 리소스는 스킬, 마켓플레이스, AI 코딩 어시스턴트를 최대한 활용하기 위한 모범 사례를 다룹니다.

Stay Updated with Claude Skills

Subscribe to get the latest Claude Skills, tutorials, and community highlights delivered to your inbox.

We respect your privacy. Unsubscribe at any time.