Claude Code 명령어 총정리
📁 프로젝트 초기화
/init
새 프로젝트에서 처음 실행하는 명령어. 코드베이스 전체를 분석하고 CLAUDE.md 파일을 자동으로 생성한다.
/init📝 컨텍스트 & 메모리 관리
# — Memory Mode
#으로 시작하는 입력은 CLAUDE.md에 영구적으로 저장된다. 매번 반복해서 지시하지 않아도 Claude가 항상 해당 규칙을 따르게 된다.
# Use comments sparingly. Only comment complex code.# The database schema is defined in the @prisma/schema.prisma file.
Reference it anytime you need to understand the structure of data stored in the database.@ — 파일 참조
@파일명으로 특정 파일을 직접 멘션한다. Claude가 파일을 탐색하는 시간 없이 즉시 해당 파일을 기반으로 답변한다.
How does the auth system work? @src/auth/middleware.ts⚙️ 실행 모드
Shift + Tab × 2 — Planning Mode
코드를 바로 수정하지 않고 실행 계획을 먼저 수립한다. 사용자의 승인 후 실제 작업을 진행한다.
- 여러 파일에 걸친 리팩토링처럼 넓은 범위를 탐색해야 할 때 적합
- 여러 단계를 순서대로 진행해야 하는 작업에 유리
Think 키워드 — Thinking Mode
프롬프트에 키워드를 포함하면 Claude가 더 깊이 추론한 뒤 답변한다. Planning Mode와 함께 사용할 수 있다.
| 키워드 | 추론 수준 |
|---|---|
Think | 기본 추론 |
Think more | 확장 추론 |
Think a lot | 포괄적 추론 |
Think longer | 장시간 추론 |
Ultrathink | 최대 추론 |
This is a tough task, so ultrathink about the best way to implement it.- 특정 로직 분석, 재현이 어려운 버그 추적처럼 깊이 있는 분석이 필요할 때 적합
⚠️ Planning Mode와 Thinking Mode 모두 일반 요청보다 토큰을 더 많이 소비한다. API를 직접 사용하는 경우 비용이 증가할 수 있으므로 꼭 필요한 상황에서만 사용하자.
🛑 작업 제어
ESC — 작업 중단
진행 중인 작업을 즉시 중단한다. 이후 범위를 좁혀서 다시 요청하거나, continue로 이어서 진행할 수 있다.
# ESC로 중단 후 범위를 좁혀 재요청
Write tests for the createSession function
# 또는 # 으로 CLAUDE.md 수정 후 이어서 진행
continueESC × 2 — 대화 Rewind (되돌리기)
대화를 특정 시점으로 되돌린다. 디버깅 등으로 대화가 길어졌을 때 불필요한 컨텍스트를 제거하고 새 작업을 깔끔하게 시작할 수 있다.
- 시점 선택 후 이전 입력값이 자동으로 채워짐
- 해당 텍스트를 수정해서 새 요청을 보내면 됨
🧹 컨텍스트 초기화
대화가 길어지면 컨텍스트 윈도우가 가득 차 응답 품질이 저하될 수 있다. 아래 두 명령어로 정리할 수 있다.
| 명령어 | 동작 | 사용 상황 |
|---|---|---|
/compact | 중요 정보를 유지하며 대화를 요약 | 관련 작업을 계속 이어갈 때 |
/clear | 대화 기록을 완전히 삭제 | 전혀 다른 작업을 시작할 때 |
/compact/clear🔧 커스텀 커맨드
.claude/commands/ — 커스텀 커맨드 등록
.claude/commands/ 경로에 마크다운 파일을 생성하면 /파일명 형태로 실행할 수 있는 커맨드가 된다. 생성 후 Claude를 재시작해야 적용된다.
# .claude/commands/audit.md 생성 후
/audit$ARGUMENTS — 동적 인자 전달
커맨드 파일 내에 $ARGUMENTS를 삽입하면 실행 시 인자를 동적으로 전달할 수 있다.
# .claude/commands/summary_file.md 내용
Show me the summary for: $ARGUMENTS
#실행 시
/summary_file the files in @src/ directory.🪝 Hook
/hooks — Hook 설정
Claude Code에서 Hook을 대화형으로 입력하는 명령어. 직접 settings.json을 수정하는 것도 가능하다.
/hooksHook 설정 구조 (settings.json)
도구 실행 전후에 커맨드를 자동 실행한다. matcher에 Tool명을 지정하고, |로 여러 Tool을 동시에 지정할 수 있다.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Read|Grep",
"hooks": [{ "type": "command", "command": "python3 ./hooks/read_hook.py" }]
}
],
"PostToolUse": [
{
"matcher": "Write|Edit|MultiEdit",
"hooks": [{ "type": "command", "command": "./.claude/hooks/pycheck" }]
}
]
}
}permissions.deny — 파일 접근 차단
@ 참조로 Hook이 우회되는 경우를 방지하기 위해 명시적으로 접근을 차단한다.
{
"permissions": {
"deny": ["Read(.env)", "Read(.env.*)"]
}
}stdin 구조 확인용 헬퍼 Hook
Hook 스크립트 작성 전 실제 stdin 데이터를 파일로 저장해 구조를 파악할 때 사용한다.
{
"PostToolUse": [
{
"matcher": "*",
"hooks": [{ "type": "command", "command": "jq . > post-log.json" }]
}
]
}📌 한눈에 보기
| 명령어 | 분류 | 설명 |
|---|---|---|
/init | 초기화 | 코드베이스 분석 + CLAUDE.md 생성 |
# 내용 | 메모리 | CLAUDE.md에 영구 저장 |
@파일명 | 참조 | 파일 직접 멘션 |
Shift+Tab × 2 | 실행 모드 | Planning Mode 진입 |
Think / Ultrathink | 실행 모드 | Thinking Mode (추론 깊이 조절) |
ESC | 제어 | 작업 중단 |
ESC × 2 | 제어 | 대화 되돌리기 (Rewind) |
/compact | 컨텍스트 | 대화 요약 (중요 정보 유지) |
/clear | 컨텍스트 | 대화 기록 완전 삭제 |
.claude/commands/파일명.md 생성 | 커스텀 커맨드 | /파일명으로 실행 가능한 커맨드 등록 |
$ARGUMENTS | 커스텀 커맨드 | 커맨드 실행 시 동적 인자 전달 |
/hooks | Hook | Hook 대화형 설정 진입 |
PreToolUse / PostToolUse | Hook | 도구 실행 전/후 커맨드 자동 실행 |
exit 0 / exit 2 | Hook | Hook 정상 통과 / 작업 차단 |
permissions.deny | Hook | @ 참조 우회 방지용 명시적 접근 차단 |
jq . > post-log.json | Hook | stdin 구조 확인용 헬퍼 Hook |
