클로드 코드의 주요 명령어 정리
CLI/터미널에서 자주 쓰는 슬래시 명령
터미널에서 claude를 실행한 뒤, 입력창에서 /로 시작하는 슬래시 명령을 사용할 수 있다.2
도움말과 상태 확인 계열:
/help 사용 가능한 슬래시 명령 목록과 간단 설명을 보여준다. 새로운 기능이 추가됐을 때 가장 먼저 확인할 명령.2
/status 버전, 사용 중인 모델, 계정, 네트워크 상태 등을 확인하는 상태 패널을 연다.2
/statusline 터미널 UI의 상태줄 설정을 돕는 명령이다. 긴 세션에서 현재 모드, 모델, 권한 상태를 한눈에 보고 싶을 때 유용하다.2
/doctor Claude Code 설치 상태와 환경을 점검한다. 이상 동작이 반복될 때 "환경 문제인지, 프롬프트 문제인지"를 빠르게 구분할 수 있다.2
대화 및 컨텍스트 관리 계열:
/clear 현재 대화 기록을 모두 지운다. 새로운 작업을 시작할 때는 /clear 후 간단한 문제 설명부터 다시 시작하는 것이 컨텍스트 오염을 줄여준다.2
/compact [instructions] 대화 내용을 요약해 토큰을 줄이면서도 핵심만 남긴다. /compact keep debugging info처럼 압축 시 유지하고 싶은 초점을 함께 넘길 수 있다.2
/context 현재 어떤 파일·텍스트가 프롬프트 컨텍스트에 들어가 있는지 색깔 그리드 형태로 시각화한다.2 "왜 이 파일을 자꾸 언급하지?" 같은 의문이 들 때 유용하다.
/cost 세션의 토큰 사용량을 보여준다.2 유료 요금제를 쓸 때, 긴 계획 모드나 대형 리팩터링을 하기 전에 참고하기 좋다.3
/stats, /usage 일별 사용량, 세션 기록, 모델 사용 비율, 요금제 한도 사용률 등을 볼 수 있다.2
프로젝트 초기화/메모리 계열:
/init 현재 프로젝트를 스캔해 CLAUDE.md를 생성하고, 주요 규칙·구조를 정리한 "프로젝트 메모리"를 만든다.34 기존 프로젝트에 Claude를 도입할 때는 가장 먼저 /init을 한 번 실행해 두는 것이 좋다.
/memory CLAUDE.md 등 메모리 파일을 열어 편집하도록 돕는다.2 팀 규칙이나 빌드/테스트 방법이 바뀌면 이 명령으로 기억을 바로잡을 수 있다.3
/add-dir 기본 작업 디렉터리 외에 추가로 봐야 할 디렉터리를 등록한다.2 모노레포나 백엔드/프론트가 나뉜 구조에서 특히 유용하다.
모델·출력 스타일 제어 계열:
/model 현재 세션에서 사용할 모델을 바꾼다.2 예: 거대한 리팩터링이나 설계는 Opus, 빠른 반복은 Sonnet 등으로 나눠 쓰는 식의 전략을 세울 수 있다.6
/output-style [style] 답변 스타일을 바꾼다. 예를 들어 "짧게", "상세 설명 포함", "리뷰어 톤" 같은 스타일을 커스텀할 수 있다.4
/vim 입력창을 Vim 모드로 전환한다.2 터미널에서 긴 프롬프트를 편집할 때 Vim 키바인딩을 쓰고 싶은 경우에만 켜면 된다.
IDE·도구 통합 계열:
/ide VS Code, Cursor, Zed 등 IDE와의 통합 상태를 보여주고, 재연결을 돕는다.17 외부 터미널에서 실행 중인 Claude를 IDE와 연결할 때도 /ide를 사용한다.1
/terminal-setup 터미널에서 Shift+Enter로 줄바꿈, Enter로 전송 등의 키 매핑을 자동 설정해 준다.6 기본 동작이 불편하면 이 명령을 한 번만 실행해두면 작업 효율이 크게 오른다.
/mcp MCP(Model Context Protocol) 서버 연결과 OAuth 인증을 관리한다.2 파일 시스템, 데이터베이스, 외부 API 등을 MCP 서버로 붙여 두면, Claude가 MCP 도구를 통해 확장된 작업을 수행할 수 있다.58
계정·권한 관리 계열:
/login, /logout Anthropic 계정 또는 API 기반 로그인/로그아웃을 관리한다.247
/permissions 어떤 도구(파일 편집, 특정 bash 명령, MCP 툴 등)를 자동 허용할지 관리한다.23 예: Edit를 항상 허용, Bash(git status:*)는 허용, rm류는 허용하지 않도록 세밀하게 조정할 수 있다.
/sandbox 격리된 샌드박스 bash 환경을 활성화해, 파일 시스템 및 네트워크를 분리된 공간에서 실행한다.2 미지의 스크립트나 잠재적으로 위험한 코드 실행을 테스트할 때 안전하다.3
코드 리뷰·품질 관련 계열:
/review 현재 변경 사항에 대한 코드 리뷰를 요청한다.2 함께 쓰면 좋은 패턴은 "이 PR의 핵심 의도 요약 → /review로 로컬 변경 검토 → GitHub PR 리뷰 연동" 순서다.36
/security-review 현재 브랜치의 변경에 대한 보안 관점 리뷰를 수행한다.2 민감한 서비스나 인증·결제 모듈 변경 시 습관처럼 돌려 두면 좋다.3
/rewind 대화 기록과 코드 변경을 과거 상태로 되돌리는 기능이다.2 큰 실수를 했을 때 Git만으로 복구하기 번거로우면 /rewind로 Claude가 한 변경 묶음을 한 번에 되돌릴 수 있다.
GitHub·PR 연동 계열:
/install-github-app Claude GitHub App을 설치해 PR 리뷰 자동화, 코멘트 처리 등을 활성화한다.26 설치 후에는 저장소에 추가되는 claude-code-review.yml 등 설정 파일로 리뷰 스타일을 조정할 수 있다.6
/pr-comments GitHub Pull Request의 댓글을 가져와서, 로컬 코드와 함께 처리하게 할 수 있다.2 "이 댓글들 모두 반영해서 수정하고, 어떤 댓글은 논리적으로 반박" 같은 작업에 유용하다.6
고급 사용자용 계열:
/agents 특정 역할을 가진 서브에이전트를 만들고 관리한다.249 예: "성능 튜닝 전담 에이전트", "테스트 전략만 보는 에이전트" 등으로 역할을 분리할 수 있다.9
/hooks 테스트 완료 후 자동 포맷팅, CI 후크 같은 자동화된 후처리 로직을 설정한다.2310 현재는 CLI에서 더 강력하게 지원되고, 일부 IDE 통합에서는 제한이 있다.7
/plugin Claude Code 플러그인을 검색·설치·관리한다.29 슬래시 명령, 서브에이전트, 스킬을 묶어 "배포 가능한 번들"로 만들고 팀과 공유할 수 있다.9
/bug 현재 세션을 Anthropic에 버그 리포트로 전송한다.2 "이건 명백히 오작동 같다" 싶은 경우에만, 민감 정보가 포함되지 않도록 확인한 뒤 사용한다.
커스텀 슬래시 명령 개요
반복되는 작업 흐름은 .claude/commands 디렉터리에 마크다운 파일로 저장해 /내-명령 형태로 재사용할 수 있다.234
기본 규칙은 다음과 같다.
명령 이름은 파일명에서 .md를 뺀 부분이 된다. 예: .claude/commands/optimize.md → /optimize2
프로젝트 전용 명령은 저장소 안 .claude/commands/에, 개인 전역 명령은 ~/.claude/commands/에 둔다.2 동일 이름일 경우 프로젝트 명령이 우선한다.
명령 안에서 $ARGUMENTS 또는 $1, $2 같은 플레이스홀더로 인자를 받을 수 있다.23 예: /fix-issue 123 high-priority → $ARGUMENTS는 "123 high-priority"가 된다.2
명령 안에서 ! 접두사로 bash를 실행해 그 결과를 컨텍스트에 포함시킬 수 있다. 예: !로 git status, git diff, git log를 먼저 실행하고 그 결과를 바탕으로 커밋 메시지를 만들게 하는 명령.23
이런 커스텀 명령을 플러그인으로 묶어 공유하면, 팀 전체가 동일한 /deploy, /triage-bug 같은 고수준 작업을 한 줄로 실행할 수 있다.910
실무용 요약 패턴
Claude Code를 처음 쓸 때는 다음 세 단계를 기억해 두면 된다.
첫 사용 시: 프로젝트 루트에서 claude 실행 → /init으로 CLAUDE.md 생성 → VS Code 확장과 /ide 연동 확인.134
하루 작업 시작 시: VS Code에서 Claude 패널 열기 → New Conversation으로 새 세션 생성 → 필요한 모델을 /model로 지정하고, /permissions로 안전한 범위까지 자동 허용 세팅.123
긴 세션 중간마다: 작업이 바뀔 때 /clear 또는 /compact로 대화 정리 → 컨텍스트가 이상할 때 /context 점검 → 토큰이 걱정되면 /cost와 /stats 확인.236
이 정도만 습관화해도 "잘 안 따라준다"는 느낌이 크게 줄어든다. 이후에는 /agents, /plugin, /mcp, 커스텀 슬래시 명령처럼 확장 기능을 하나씩 추가하면서 자신의 워크플로우를 맞춰가면 된다.349
참고
2Slash commands - Claude Code Docs
4Cooking with Claude Code: The Complete Guide
6How I use Claude Code (+ my best tips)
7External Agents | Zed Code Editor Documentation
8Model Context Protocol specification
9Understanding Claude Code: Skills vs Commands vs Subagents vs Plugins
10Customizing Claude Code: What I Learned from Losing Everything