Claude Code /clear란? 대화 초기화와 이전 작업 복구 방법
“오전에는 로그인 오류를 고쳤고, 오후에는 홈페이지 디자인을 바꾸고 싶어요. 그런데 AI가 자꾸 오전 작업 이야기를 꺼냅니다.”
Claude Code를 오래 사용하다 보면 서로 다른 작업의 대화가 한 세션에 쌓일 수 있습니다. 이럴 때 유용한 명령이 /clear입니다.
/clear는 Claude Code에서 지금까지의 대화 맥락을 비우고 새 대화를 시작하는 명령입니다. 기존 프로젝트 파일을 삭제하는 명령이 아니며, 구독 사용량 한도를 초기화하는 기능도 아닙니다.
이전 대화는 로컬 세션 기록으로 남아 나중에 다시 열 수 있습니다.
중요한 점은 새 대화가 이전 채팅에서만 결정한 내용을 자동으로 모두 알고 있지는 않다는 것입니다. 그래서 /clear를 잘 쓰려면 무엇이 초기화되고, 무엇이 남으며, 언제 다시 불러올 수 있는지 이해해야 합니다.
이 글의 순서
1. /clear는 정확히 무엇을 하나요?
Claude Code는 현재 질문뿐 아니라 앞서 나눈 대화, 읽은 파일의 내용, 실행한 명령의 출력 등 여러 정보를 참고하며 작업합니다. 이 정보를 계속 이어받으면 같은 프로젝트를 수정할 때 편리하지만, 전혀 다른 일을 시작할 때는 불필요한 내용이 남을 수 있습니다.
/clear는 현재 세션의 대화 맥락을 비우고 새 세션으로 넘어갑니다. 책상 위에 쌓인 메모를 정리하고 다음 과제를 위한 빈 책상을 만드는 것과 비슷합니다.
예를 들어 아침에는 결제 오류를 조사하고 오후에는 블로그 글의 제목 디자인을 바꾸는 작업을 한다고 생각해 보세요. 서로 관련이 없다면 오전의 긴 오류 로그를 새 대화에 계속 들고 갈 이유가 적습니다.
다만 /clear가 항상 정답은 아닙니다. 오전에 발견한 오류의 원인을 오후에도 추적해야 한다면 대화 내용을 유지하거나 요약하는 편이 더 적절할 수 있습니다.
2. /clear를 실행하면 어떤 정보가 사라지나요?
여기서 '사라진다'는 말은 새 대화의 현재 맥락에서 빠진다는 의미입니다. 로컬 파일과 과거 기록이 모두 영구 삭제된다는 뜻이 아닙니다.
| 대상 | /clear 이후 어떻게 되나요? |
|---|---|
| 현재 대화의 질문·답변 맥락 | 새 세션에서는 이어받지 않음 |
| 이전 대화의 로컬 기록 | 일반적으로 저장되어 /resume으로 재개 가능 |
| 프로젝트 코드·문서 파일 | 명령 자체가 삭제하지 않음 |
| Git 커밋·현재 파일 수정 내용 | 명령 자체가 되돌리거나 삭제하지 않음 |
CLAUDE.md 프로젝트 지침 |
파일은 남고 새 세션에서 관련 지침을 다시 불러올 수 있음 |
| 구독 사용량·API 청구액 | 초기화되지 않음 |
예를 들어 Claude Code에게 “버튼을 파란색으로 바꿔 줘”라고 요청했고 실제 CSS 파일이 수정되었다면, /clear를 입력해도 수정한 CSS가 자동으로 원상복구되지는 않습니다. 대화 맥락 초기화와 코드 변경 취소는 다른 작업입니다.
반대로 “앞으로 버튼은 무조건 파란색으로 해 줘”라고 대화에서만 말했고 파일이나 프로젝트 규칙에 기록하지 않았다면, 새 세션이 그 약속을 알고 있다고 기대해서는 안 됩니다.
3. Claude Code에서 /clear를 사용하는 방법
Claude Code가 실행 중인 터미널의 대화 입력창 맨 앞에 다음과 같이 입력합니다.
/clear
명령이 실행되면 새로운 대화 맥락으로 시작합니다. 일반 셸 명령어처럼 터미널에서 아무 때나 입력하는 명령이 아니라, Claude Code의 대화 입력창에서 사용하는 슬래시 명령입니다. 일반 Claude 웹 채팅이나 다른 AI 서비스에 그대로 입력해도 같은 동작을 보장하지 않습니다. 이전 대화에 알아보기 쉬운 이름을 붙이고 나가려면 다음 형태도 사용할 수 있습니다.
/clear login-bug-fix
여기서 login-bug-fix는 지금 떠나는 이전 대화에 붙이는 이름입니다. 새로 시작하는 대화의 제목을 정하는 인수가 아닙니다. 이후 /resume에서 이전 작업을 찾을 때 도움이 됩니다.
실제로 실행한 화면을 촬영한 것은 아니며, 위 명령 형식과 동작은 공식 문서 기준으로 설명합니다.
4. 언제 /clear를 쓰는 것이 좋을까요?
작업 목표가 확실히 바뀌었을 때 가장 유용합니다.
가상의 웹사이트 프로젝트를 예로 들어 보겠습니다. 오전에는 회원가입 화면에서 발생하는 오류를 고쳤고, 테스트 결과도 확인했습니다. 오후에는 같은 저장소에서 전혀 다른 주제인 글꼴 디자인을 검토하려고 합니다.
이때 이전 오류 로그가 새 작업의 판단에 필요하지 않다면 /clear를 고려할 수 있습니다. 반면 로그인 오류가 아직 해결되지 않았고 바로 다음 수정이 필요한 상황이라면 대화를 초기화하기 전에 핵심 정보를 보존해야 합니다.
다음 세 가지 질문에 답해 보세요.
- 앞선 대화 없이 새 작업을 설명할 수 있나요? 그렇다면
/clear가 적합할 수 있습니다. - 아직 해결하지 못한 오류나 미완료 결정이 있나요? 있다면 먼저 파일이나 메모에 남기세요.
- 같은 문제를 계속 해결하고 있나요? 그렇다면
/clear보다 대화 요약을 고려할 수 있습니다. 특히 여러 기능을 병행 개발한다면 작업별로 세션을 구분하는 습관이 도움이 됩니다. 다만 한 저장소에서 서로 다른 세션이 같은 파일을 수정할 때는 파일 충돌을 별도로 관리해야 합니다.
5. /clear 전에 꼭 남겨야 할 다섯 가지
대화 맥락을 비우기 전에 다음 내용을 기록해 두면 새 세션에서 같은 설명을 반복하는 일을 줄일 수 있습니다.
① 현재 작업 목표: “로그인 버튼을 눌렀을 때 오류 없이 대시보드로 이동하게 만들기”처럼 한 문장으로 정리합니다.
② 변경한 파일: src/login.js나 styles/main.css처럼 실제 파일 경로를 기록합니다. 예시 경로이며 사용자 프로젝트마다 다릅니다.
③ 이미 확인한 사실: 어떤 오류가 재현되었는지, 어떤 명령을 실행했고 실제로 어떤 결과가 나왔는지 구분합니다.
④ 남은 문제: 아직 해결되지 않은 버그, 검증하지 않은 가정, 다음에 해야 할 일을 적습니다.
⑤ 지켜야 할 규칙: “결제 관련 파일은 변경하지 말 것”처럼 실수하면 곤란한 조건을 프로젝트 문서에 남깁니다.
가장 안전한 방법은 중요한 진행 상황을 프로젝트 안의 별도 메모 파일이나 팀이 관리하는 작업 기록에 보존하는 것입니다. CLAUDE.md는 반복적으로 적용할 프로젝트 규칙에 적합하지만, 매번 바뀌는 임시 진행 상황까지 무조건 길게 넣는 것은 피하세요.
예를 들어 WORK_LOG.md라는 가상의 작업 기록 파일에 다음처럼 적을 수 있습니다.
작업: 로그인 오류 수정
변경 파일: src/login.js
확인: 로그인 폼 입력 검증 수정
테스트: 로그인 단위 테스트 통과(실제 실행한 경우에만 기록)
미완료: 모바일 화면에서 재확인
주의: 결제 관련 파일 수정 금지
위 내용은 작성 형식 예시입니다. 실제 파일이나 테스트가 존재한다는 뜻은 아닙니다.
6. /clear 후에는 어떻게 작업을 다시 시작하나요?
새 대화가 열렸다면 먼저 현재 프로젝트의 파일 상태를 확인하도록 요청하는 것이 좋습니다. 이전 대화에서 어떤 말을 했는지 추측하도록 하기보다 실제 코드와 기록된 진행 상황을 근거로 작업하게 하는 편이 안전합니다. 예를 들어 다음과 같이 요청할 수 있습니다.
이 프로젝트에서 모바일 메뉴 디자인을 수정하려고 합니다. 먼저 관련 파일과 WORK_LOG.md가 있다면 확인하고, 현재 Git 변경 사항을 요약해 주세요. 파일을 수정하기 전에 영향 범위와 확인이 필요한 부분부터 알려 주세요. 이 요청은
/clear뒤에 입력하는 새로운 작업 지시 예시입니다.WORK_LOG.md가 없거나 Git을 사용하지 않는 프로젝트라면 해당 부분을 생략해야 합니다.프로젝트에
CLAUDE.md가 있다면 Claude Code는 해당 위치에 적용되는 지침을 새 세션에서 불러올 수 있습니다. 하지만 지침 파일에 없는 과거의 대화상 결정까지 자동으로 되살아나는 것은 아닙니다. 작업을 다시 시작한 뒤에는 변경하려는 파일과 실제 테스트 결과를 확인하세요. 대화가 새로워졌다고 코드도 새 상태가 된 것은 아닙니다.
7. 이전 대화를 다시 보고 싶다면 /resume
/clear를 입력한 뒤 “아까 해결하던 로그인 오류의 대화가 필요해졌어요”라고 생각할 수 있습니다. 이때는 이전 대화로 돌아가는 /resume 명령을 사용할 수 있습니다.
/resume
Claude Code는 저장된 세션을 선택할 수 있는 화면을 제공합니다. 앞서 /clear login-bug-fix로 이름을 붙였다면 그 이름을 기준으로 이전 대화를 찾는 데 도움이 됩니다.
또한 터미널에서 Claude Code를 새로 실행할 때 claude --resume으로 세션 선택 화면을 열 수 있습니다. claude --continue는 현재 작업 디렉터리에서 최근 세션을 이어 가는 방식입니다.
주의: /resume으로 이전 대화를 다시 열 수 있다는 것은 로컬 세션 기록이 저장되어 있고 아직 이용 가능한 경우를 전제로 합니다. 기록 보관 정책, 수동 삭제, 세션 저장 비활성화, 실행 환경에 따라 복구 가능 여부가 달라질 수 있습니다.
또한 대화 기록을 복구하는 것과 코드 파일을 과거 상태로 되돌리는 것은 별개입니다. /resume이 모든 파일 변경을 자동으로 되돌리는 기능은 아닙니다.
8. /clear와 /compact는 어떻게 다른가요?
두 명령 모두 긴 대화를 다룰 때 등장하지만 목적이 다릅니다.
| 구분 | /clear | /compact |
|---|---|---|
| 핵심 동작 | 새 대화 시작 | 기존 대화를 요약해 이어감 |
| 앞선 작업 내용 | 새 세션에 자동으로 이어지지 않음 | 요약된 중요한 정보가 남을 수 있음 |
| 적합한 상황 | 서로 관련 없는 새 작업 | 같은 작업을 계속 진행 |
| 주의점 | 대화에서만 정한 조건을 놓칠 수 있음 | 요약 과정에서 세부 정보가 빠질 수 있음 |
예를 들어 블로그 홈페이지 디자인을 이틀째 고치는 중이라면 이전 결정이 필요하므로 /compact가 적절할 수 있습니다. 디자인 작업을 끝내고 별도의 데이터 정리 프로젝트를 시작한다면 /clear가 더 자연스러울 수 있습니다.
어느 쪽이든 중요한 작업 규칙과 검증 결과는 대화에만 의존하지 말고 파일에도 기록하는 편이 안전합니다.
9. /clear가 토큰 비용을 무조건 줄여 주나요?
그렇게 단정할 수는 없습니다. 새 세션에서는 이전 대화 전체를 계속 전달할 필요가 줄어들 수 있으므로 불필요한 맥락을 덜어 내는 데 도움이 될 수 있습니다.
하지만 실제 사용량은 선택한 모델, 새로 읽는 파일, 불러오는 프로젝트 지침, 도구 실행 결과, 질문 길이 등에 따라 달라집니다. 이전 대화를 비운 뒤 같은 파일을 처음부터 다시 조사하면 오히려 추가 작업이 생길 수도 있습니다.
특히 /clear는 Claude 구독 사용량 한도를 초기화하지 않으며, 이미 발생한 API 비용을 취소하지도 않습니다. 이 명령을 실행했다고 특정 비율만큼 토큰이 절약된다고 보장할 근거도 없습니다.
비용 절감만을 목표로 무작정 초기화하기보다, 작업이 바뀌는 순간에 사용하고 필요한 파일을 정확히 지정하는 편이 낫습니다.
자주 묻는 질문
Q. /clear를 실행하면 프로젝트 파일이 삭제되나요?
아니요. /clear는 대화 맥락을 새로 시작하는 명령입니다. 프로젝트 파일 삭제나 Git 변경 취소 명령이 아닙니다.
Q. /clear 뒤에 예전 대화로 돌아갈 수 있나요?
일반적으로 가능합니다. 저장된 이전 세션이 있다면 /resume으로 다시 열 수 있습니다. 다만 기록 보관 상태에 따라 달라질 수 있습니다.
Q. /clear를 하면 CLAUDE.md도 사라지나요?
아닙니다. 파일 자체는 남습니다. 새 세션에서는 해당 프로젝트에 적용되는 지침을 다시 불러올 수 있습니다.
Q. /clear를 실행하면 사용량 제한이 초기화되나요?
아닙니다. 대화 맥락을 비우는 것과 계정의 사용량 한도·요금 청구는 서로 다른 문제입니다.
Q. /clear 뒤에도 전에 수정한 코드가 남아 있나요?
네. /clear 자체는 기존 파일 수정을 되돌리지 않습니다. 실제 파일 상태를 다시 확인해야 합니다.
Q. /clear를 하면 예전 대화 기록이 영구 삭제되나요?
일반적으로 아닙니다. Claude Code는 이전 세션 기록을 로컬에 저장하고 재개할 수 있게 합니다. 영구 삭제·개인정보 정리가 목적이라면 별도의 기록 관리 방법을 확인해야 합니다.
Q. 같은 작업을 계속하고 싶은데 대화가 너무 길어요.
앞선 결정이 중요하다면 무조건 초기화하기보다 /compact처럼 대화를 요약해 이어 가는 방법을 고려하세요. 중요한 세부 사항은 별도 문서에도 남기는 것이 좋습니다.
Q. /clear 뒤에 이전 작업을 완전히 기억하게 할 수 있나요?
새 세션에 과거 대화 전체가 자동으로 전달되지는 않습니다. 작업 기록, 실제 파일, 프로젝트 지침을 새 대화에서 확인하도록 요청해야 합니다. 이전 대화 자체가 필요하면 /resume을 사용하세요.
마무리: 대화를 비우되 작업 기록은 남기세요
Claude Code의 /clear는 새로운 작업을 시작할 때 현재 대화 맥락을 비우는 명령입니다. 코드 파일을 삭제하거나 사용량 한도를 초기화하는 기능이 아닙니다.
처음에는 이 원칙만 기억해도 충분합니다. 새 작업이면 /clear, 같은 작업을 계속하면 요약을 고려하고, 예전 대화가 필요하면 /resume으로 돌아갑니다.
작업을 바꾸기 전 목표·수정 파일·검증 결과·남은 문제를 짧게 기록하는 습관을 들이면, 대화를 새로 시작하더라도 중요한 업무 흐름을 놓칠 가능성을 줄일 수 있습니다.