Claude Code 기본 명령어 정리

터미널 CLI · 세션 내 슬래시 명령어 · 단축키 · 설정 파일 핵심 요약

2026년 7월 기준 · ★ = 매일 쓰게 되는 필수 항목

1 터미널에서 실행하는 CLI 명령어

쉘(터미널)에서 claude 로 시작하는 명령어. 세션을 열고 닫고 관리합니다.

claude
★ 현재 폴더에서 새 대화형 세션 시작. 가장 기본.
claude "질문 내용"
초기 프롬프트를 바로 넣으면서 세션 시작.
claude -c
★ 이 폴더의 가장 최근 대화 이어서 시작 (--continue).
claude -r
이전 세션 목록에서 골라 재개 (--resume).
claude -p "질문"
비대화형(스크립트) 모드. 답변만 출력하고 종료. 파이프/자동화용.
claude --model opus
모델 지정해서 시작 (opus / sonnet / haiku).
claude update
★ 최신 버전으로 업데이트.
claude doctor
설치·설정 진단. 뭔가 이상할 때 제일 먼저.
claude mcp
MCP 서버 추가·목록·삭제 관리 (하위 명령: add / list / remove).
claude config
전역/프로젝트 설정 조회·변경.

2 세션 안에서 쓰는 슬래시 명령어

대화 중 입력창에 / 를 치면 뜨는 명령어. 자주 쓰는 것부터.

가장 많이 쓰는 3가지 : 컨텍스트가 꽉 차면 /compact, 주제를 바꾸면 /clear, 프로젝트 규칙을 잡을 땐 /init.
/help
사용 가능한 명령어 전체 보기.
/clear
★ 대화 히스토리 초기화(새 주제 시작). 컨텍스트를 깨끗이 비움.
/compact
★ 지금까지 대화를 요약 압축해 컨텍스트 공간 확보. 긴 작업 중 필수.
/init
★ 프로젝트를 분석해 CLAUDE.md 자동 생성.
/model
대화 중 모델 전환 (opus / sonnet / haiku).
/memory
CLAUDE.md 등 메모리 파일을 열어 편집.
/context
현재 컨텍스트 사용량 시각화. 얼마나 찼는지 확인.
/cost · /usage
토큰 사용량·비용 확인.
/review
코드 변경/PR을 검토받기.
/mcp
연결된 MCP 서버 상태 확인·관리.
/agents
서브에이전트(전문 에이전트) 정의·관리.
/permissions
도구 실행 허용 규칙 설정 (자동 승인/차단).
/add-dir
현재 디렉토리 밖의 폴더를 작업 대상에 추가.
/vim
입력창에 Vim 키 바인딩 토글.
/status
버전·로그인·설정 상태 한눈에.

3 키보드 단축키 & 특수 입력

명령어보다 이걸 손에 익히는 게 생산성에 더 큽니다.

# 입력
★ 한 줄 메모를 CLAUDE.md에 바로 저장. "이 규칙 기억해" 할 때.
! 입력
★ Bash 모드. Claude를 거치지 않고 쉘 명령을 직접 실행.
@ 입력
★ 파일 경로 자동완성. 특정 파일을 대화에 참조로 넣을 때.
Esc
Claude가 작업 중일 때 즉시 중단. 방향이 틀렸다 싶으면 바로.
Esc Esc
이전 메시지로 되감기/편집 메뉴 열기.
Shift+Tab
★ 권한 모드 순환 (수동 승인 ↔ 자동 승인 ↔ Plan 모드).
Ctrl+C
입력 취소/중단. 두 번 = 종료.
Ctrl+R
이전 명령 히스토리 역방향 검색.
Ctrl+V
클립보드 이미지 붙여넣기 (스크린샷 → 바로 첨부).
Plan 모드(Shift+Tab로 진입)는 코드를 바로 고치지 않고 계획만 먼저 세우는 모드입니다. 큰 리팩터링 전에 방향을 잡고 검토받을 때 유용합니다.

4 CLAUDE.md — 프로젝트 기억 파일

모든 세션에서 자동 로드되는 프로젝트 안내서. 여기에 규칙을 적어두면 매번 설명할 필요가 없습니다.

# 어디에 두나
프로젝트루트/CLAUDE.md      # 이 프로젝트 전체 규칙 (가장 중요)
~/.claude/CLAUDE.md         # 내 모든 프로젝트 공통 규칙
하위폴더/CLAUDE.md          # 해당 폴더에만 적용되는 로컬 규칙

# 무엇을 적나 (예시)
- 기술 스택: Java 17, Spring Boot 3, MySQL
- 빌드/테스트 명령: ./gradlew test
- 코딩 컨벤션, 폴더 구조, 하지 말아야 할 것
/init 로 자동 생성한 뒤, 대화 중 # 로 규칙을 한 줄씩 덧붙이는 흐름이 가장 편합니다.

5 커스텀 슬래시 명령어 & MCP

반복 작업은 나만의 명령어로, 외부 도구는 MCP로 붙입니다.

나만의 명령어 만들기 — .claude/commands/ 폴더에 deploy.md 를 만들면 /deploy 로 실행됩니다.

# .claude/commands/pr-summary.md
# !`...` 는 명령을 먼저 실행해 그 "결과"를 넣어줍니다

## 현재 변경사항
!`git diff HEAD`

## 지침
위 diff를 3줄로 요약해줘.   # → /pr-summary 로 호출

MCP (외부 도구 연결) — GitHub, Slack, DB 등을 Claude에 물려줍니다.

# 터미널에서
claude mcp add github          # 서버 추가
claude mcp list                # 연결 목록

# 설정 파일 위치
.claude/settings.json          # 이 프로젝트
~/.claude/settings.json        # 내 전역 설정
추천 첫걸음 — ① 프로젝트에서 claude 실행 → ② /init 로 CLAUDE.md 생성 → ③ Shift+Tab 로 Plan 모드 익히기 → ④ 긴 작업엔 /compact, 주제 바꾸면 /clear.
참고 — 명령어는 버전에 따라 조금씩 추가/변경됩니다. 설치 버전은 /status, 전체 목록은 /help 로 확인하세요.
공식 문서: CLI 레퍼런스 · 슬래시 명령어 · 단축키(인터랙티브 모드)

+ Recent posts

티스토리툴바