Claude Code /clear 명령어 완벽 정리 — 컨텍스트 초기화로 AI 코딩 효율 높이기

들어가며

Claude Code를 쓰다 보면 어느 순간 AI의 응답이 이상해지는 경험을 하게 됩니다.

"분명히 이 파일 수정하지 말라고 했는데 왜 또 건드리지?" "이 작업이랑 관계없는 내용을 왜 계속 언급하는 거야?"

이런 현상의 원인 대부분은 누적된 컨텍스트입니다. Claude Code는 대화 히스토리 전체를 참고해서 응답을 생성하는데, 작업이 길어질수록 불필요한 정보가 쌓여 판단을 흐리게 만들죠.

이럴 때 쓰는 명령어가 바로 /clear입니다.

이 글에서는 /clear의 개념, 동작 방식, 그리고 실전에서 언제 어떻게 써야 하는지를 정리합니다.

---

/clear란 무엇인가?

/clear는 현재 Claude Code 세션의 대화 히스토리(컨텍스트)를 완전히 초기화하는 명령어입니다.

> /clear

입력 즉시 실행되며, 확인 프롬프트 없이 바로 히스토리가 삭제됩니다.

핵심 특징

• ✅ 대화 히스토리만 삭제 (파일·코드에는 영향 없음)
• ✅ CLAUDE.md에 저장된 장기 메모리는 유지
• ✅ 별도 옵션이나 인자 없이 단독으로 사용
• ❌ 되돌리기 불가 (삭제된 히스토리 복원 없음)

---

언제 사용해야 할까?

1. 완전히 다른 작업으로 전환할 때

기능 A 구현을 마치고 기능 B를 시작하는 상황이라면, 이전 대화 내용은 오히려 방해가 될 수 있습니다. 새 작업 시작 전 /clear로 깨끗한 상태를 만들어 주세요.

# 기능 A 작업 완료 후
> /clear

# 새 작업 시작
> 로그인 API 엔드포인트 만들어줘

2. 컨텍스트가 오염됐을 때

잘못된 전제로 대화가 진행되거나, Claude가 이미 수정된 사항을 계속 이전 상태로 인식할 때 유효합니다.

3. 토큰 비용·응답 품질 관리

컨텍스트가 길어질수록 API 비용이 증가하고, 응답 속도도 느려집니다. 일정 분량을 넘기면 /clear 후 재시작하는 것이 효율적입니다.

4. 민감한 정보 제거

API 키, 비밀번호, 개인정보 등이 대화 중에 노출됐다면 즉시 /clear로 세션에서 제거하세요.

---

실제 동작 방식

Claude Code의 컨텍스트 구조는 다음과 같습니다.

┌──────────────────────────────────────┐
│         Claude Code 세션             │
│                                      │
│  ┌────────────────────────────────┐  │
│  │    대화 히스토리 (context)      │  │  ← /clear 로 삭제되는 영역
│  │  - 이전 질문/답변               │  │
│  │  - 파일 내용 스냅샷             │  │
│  │  - 작업 지시사항               │  │
│  └────────────────────────────────┘  │
│                                      │
│  ┌────────────────────────────────┐  │
│  │    CLAUDE.md (장기 메모리)      │  │  ← /clear 로 삭제되지 않음
│  │  - 프로젝트 컨벤션             │  │
│  │  - 자주 쓰는 명령어            │  │
│  │  - 팀 규칙                     │  │
│  └────────────────────────────────┘  │
│                                      │
│  실제 파일 시스템 (변경 없음)          │
└──────────────────────────────────────┘

/clear 실행 후에도 파일 시스템은 그대로 유지됩니다. Claude가 이전에 생성하거나 수정한 파일은 디스크에 그대로 남아 있습니다.

---

관련 개념: CLAUDE.md와 컨텍스트 관리

/clear를 잘 활용하려면 CLAUDE.md를 함께 써야 합니다.

CLAUDE.md는 프로젝트 루트에 두는 마크다운 파일로, Claude Code가 세션 시작 시 자동으로 읽어들이는 장기 메모리 역할을 합니다.

# CLAUDE.md 예시

## 프로젝트 개요
- Spring Boot 3.x + React 기반 웹 애플리케이션
- DB: MariaDB 10.6

## 코드 컨벤션
- 패키지명: com.example.project
- 서비스 레이어에서만 트랜잭션 처리

## 주의사항
- /src/legacy 폴더는 절대 수정하지 말 것
- 테스트 코드 항상 작성

/clear로 대화 히스토리를 지워도, CLAUDE.md에 적힌 내용은 다음 질문부터 다시 반영됩니다.

💡 실전 팁: 작업하다가 중요한 결정 사항이나 컨벤션이 생기면 CLAUDE.md에 기록해두고 /clear하세요. 이렇게 하면 히스토리는 깔끔하게 유지하면서 중요한 맥락은 보존할 수 있습니다.

---

자주 묻는 질문

Q. /clear 전에 작업한 파일이 사라지나요? 아니요. 대화 히스토리만 삭제됩니다. 파일은 그대로입니다.

Q. 실수로 /clear 했어요. 되돌릴 수 있나요? 불가능합니다. 다만 /clear 전에 작업한 파일은 디스크에 남아있고, Git을 사용 중이라면 커밋 히스토리로 코드는 복원 가능합니다.

Q. 얼마나 자주 써야 하나요? 정해진 규칙은 없지만, 큰 작업 단위가 끝날 때마다 또는 대화가 30~40턴 이상 길어졌을 때 사용하는 것을 권장합니다.

Q. /clear와 Claude Code 재시작의 차이는? /clear는 세션을 유지하면서 히스토리만 지웁니다. 재시작은 프로세스 자체를 종료하므로 더 완전한 초기화가 필요할 때 사용합니다.

---

마무리

/clear는 단순해 보이지만, Claude Code를 효율적으로 사용하는 핵심 습관 중 하나입니다.

핵심 요약:

• 대화 히스토리(컨텍스트)를 즉시 초기화하는 명령어
• 파일·CLAUDE.md에는 영향 없음
• 새 작업 전환, 컨텍스트 오염, 비용 관리 시 사용
• CLAUDE.md와 함께 써야 효과적

AI와 협업하는 방식도 결국 도구를 제대로 이해하고 사용하는 것에서 차이가 납니다. /clear 하나지만, 알고 쓰는 것과 모르고 쓰는 것은 다릅니다.