Claude Code의 효율적인 사용은 단축키 숙지와 워크플로우 패턴에서 나옵니다. Escape 키 하나로 현재 작업을 즉시 중단하고, Ctrl+C로 스트리밍 응답을 끊을 수 있습니다. 이 가이드는 핵심 단축키와 하루 4시간 개발자 기준 실증된 워크플로우를 정리합니다.
핵심 단축키
입력 제어
| 단축키 | 동작 |
|---|---|
Enter |
단일 줄 입력 전송 |
Shift + Enter |
멀티라인 입력 (줄바꿈) |
Esc |
현재 AI 응답 중단 (생성 중 취소) |
Ctrl + C |
완전 중단 (진행 중인 모든 작업 취소) |
↑ / ↓ |
이전/다음 입력 히스토리 |
Ctrl + L |
화면 지우기 (컨텍스트는 유지) |
가장 중요한 단축키: Esc
Claude Code가 긴 파일을 생성하거나 잘못된 방향으로 진행 중일 때:
# Claude가 1000줄짜리 파일을 쓰기 시작했는데 방향이 틀렸다
[Esc 누르기]
> 아니, 이 파일이 아니라 utils.ts에만 추가해줘
Esc는 현재 출력을 멈추지만 세션은 유지됩니다. 컨텍스트를 잃지 않고 방향만 수정할 수 있습니다.
멀티라인 입력 (Shift + Enter)
복잡한 요청을 여러 줄로 작성할 때:
사용자:
다음 작업을 순서대로 해줘:[Shift+Enter]
1. src/auth.ts에 JWT 갱신 로직 추가[Shift+Enter]
2. 기존 테스트 업데이트[Shift+Enter]
3. 에러 핸들링 추가[Enter 전송]
워크플로우 패턴
패턴 1: 아침 세션 시작
# 1. 프로젝트 진입
cd ~/projects/my-app
claude
# 2. 전날 상태 파악 (저비용 모델)
/model haiku
"git log --oneline -10 요약해주고 오늘 작업 우선순위 제안해줘"
# 3. 모델 전환 후 작업 시작
/model sonnet
"결제 모듈 버그 수정 시작해줘"
패턴 2: 집중 작업 세션
# 긴 작업 시작 전 컨텍스트 최적화
/compact 현재까지 결제 모듈 리팩토링 중. auth.ts 완료, payment.ts 진행 중.
# 특정 파일만 집중
/add src/payment.ts
/add src/types/payment.d.ts
"payment.ts의 환불 처리 로직을 개선해줘"
패턴 3: 디버깅 세션
# 에러 발생 시
/clear # 이전 컨텍스트 초기화
# 관련 파일만 추가
/add logs/error.log
/add src/api/orders.ts
# 구체적 에러 정보 제공
"TypeError: Cannot read properties of undefined (reading 'id')
이 에러가 POST /api/orders에서 발생함. 원인 찾아줘"
패턴 4: 코드 리뷰 세션
# PR 전 최종 검토
/model sonnet
/review 다음 관점에서 검토:
- 보안: SQL 인젝션, XSS, 인증 누락
- 성능: N+1 쿼리, 불필요한 리렌더링
- 타입 안전성: any 타입 사용
- 테스트: 엣지 케이스 누락
세션 관리 전략
컨텍스트 창 효율적 사용
Claude Code의 컨텍스트 창은 유한합니다. 효율적으로 사용하는 방법:
# 컨텍스트 80% 찰 때마다
/compact
# 새 작업 시작 시
/clear
# 현재 사용량 확인
/cost
실측 데이터 (Sonnet, 4시간 세션):
/compact없이: 컨텍스트 평균 2시간에 소진/compact2회 사용: 4시간 세션 가능, 비용 40% 절감
파일 참조 최적화
# 나쁜 예: 전체 디렉토리 읽기 요청
"src 폴더 전체 분석해줘" # 토큰 낭비
# 좋은 예: 필요한 파일만 지정
/add src/auth/middleware.ts
/add src/types/user.d.ts
"미들웨어에서 사용자 타입 검증 로직 개선해줘"
CLAUDE.md로 반복 작업 자동화
# .claude/CLAUDE.md
## 코딩 규칙
- TypeScript strict mode
- 함수는 반드시 반환 타입 명시
- 에러는 항상 Error 클래스 사용 (string throw 금지)
- 주석은 한국어로
## 자주 쓰는 패턴
### /deploy
1. `bun test` 통과 확인
2. `bun run build` 확인
3. `vercel deploy --prod --yes` 실행
### /pr-check
- 타입 에러 확인
- 테스트 커버리지 80% 이상
- 스타일 가이드 준수
멀티 에이전트 패턴
복잡한 작업을 병렬로 처리:
# 터미널 1: 백엔드 작업
cd ~/api-server
claude
"결제 API 엔드포인트 구현해줘"
# 터미널 2: 프론트엔드 작업
cd ~/web-app
claude
"결제 폼 컴포넌트 구현해줘"
두 Claude Code 인스턴스가 독립적으로 작업합니다. 파일 충돌을 방지하려면 작업 범위를 명확히 분리하세요.
비용 최적화 단축키 패턴
# 세션 시작: 저비용 Haiku
/model haiku
# 복잡한 작업 시: Sonnet으로 전환
/model sonnet
"이 아키텍처 문제 분석해줘"
# 다시 반복 작업으로 돌아오면
/model haiku
"방금 제안한 대로 컴포넌트 5개 생성해줘"
# 중간 비용 확인
/cost
월간 절감 효과: 이 패턴 적용 시 순수 Sonnet 사용 대비 약 55% 비용 절감 (하루 4시간 사용, 1개월 기준 실측).
자주 하는 실수
실수 1: Ctrl+C를 너무 빠르게 누름
# Claude가 파일을 생성 중일 때 Ctrl+C
→ 파일이 반만 생성된 상태로 저장됨
# 올바른 방법
[Esc]로 응답 중단 → 파일 상태 확인 → 수정 요청
실수 2: 컨텍스트 초기화 없이 긴 세션
# 4시간 후 컨텍스트 꽉 찬 상태
→ Claude가 초반 정보를 "잊음"
→ 일관성 없는 코드 생성
# 해결: 2시간마다 /compact 실행
실수 3: 모든 작업에 Opus 사용
# 간단한 주석 작성에 Opus
/model opus
"이 함수에 JSDoc 주석 추가해줘"
→ 불필요한 비용
# 올바른 방법
/model haiku
"이 함수에 JSDoc 주석 추가해줘"
Frequently Asked Questions
Esc와 Ctrl+C의 차이는 정확히 무엇인가요?
Esc는 현재 스트리밍 응답만 중단합니다. 세션은 유지되고 대화 히스토리도 남습니다. Ctrl+C는 Claude Code 프로세스 자체에 인터럽트 시그널을 보내 모든 작업을 중단합니다.
이전에 입력한 프롬프트를 다시 불러올 수 있나요?
↑ 화살표 키로 이전 입력 히스토리를 탐색할 수 있습니다. 세션을 종료하고 다시 시작해도 히스토리가 유지됩니다.
멀티라인 입력에서 실수로 Enter를 눌렀는데 취소할 수 있나요?
Enter를 누르면 즉시 전송됩니다. 전송 전 실수를 방지하려면 복잡한 프롬프트를 텍스트 에디터에서 작성 후 붙여넣기 하는 것을 권장합니다.
/compact 후 중요한 코드 변경사항을 잃어버리지 않나요?
/compact는 이전 대화를 요약하지만, 실제로 디스크에 저장된 파일은 영향받지 않습니다. 코드 변경사항은 파일 시스템에 이미 저장되어 있습니다.
Claude Code를 백그라운드에서 실행할 수 있나요?
claude --dangerously-skip-permissions 플래그와 stdin 파이핑을 사용한 비대화형 모드가 있습니다. 하지만 보안상 주의가 필요합니다.
관련 가이드: Claude Code 슬래시 커맨드 한국어 · Claude Code Plan Mode 한국어 · Claude Code 완전 가이드 한국어
P1 Claude Code Power Prompts 300 — 이 워크플로우를 극대화하는 300개 검증 프롬프트. 카테고리별 정리, JSONL 즉시 임포트 가능. 지금 확인 →