MemoryLake
모든 글로 돌아가기
Tutorial2026년 10월 29일·10 분 소요

Claude Code에서 /clear는 어떤 역할을 하나요? 무엇이 보존되며, /compact나 새 세션이 더 적합한 경우는 언제일까요? (2026)

Claude Code에서 작업을 하나 마치면 프롬프트 아래에 다음과 같은 힌트가 나타납니다: new task? /clear to save tokens. 이는 좋은 조언이지만, 한편으로는 망설여지는 질문을 던지기도 합니다. 만약 clear를 하면 무엇이 사라질까요? Claude가 내 프로젝트나 한 시간 전에 내린 결정, 혹은 현재 세션을 잊어버리게 될까요?

짧은 답변을 드리자면, /clear는 프로젝트가 아니라 대화 내용을 비우는 것입니다. Anthropic의 명령어 참조 가이드에서는 이를 "빈 컨텍스트로 새 대화 시작"하는 방법으로 설명합니다. 명령어 개요에서는 더 중요한 부분을 덧붙입니다: "/clear는 프로젝트 memory를 유지하면서 새로운 작업을 위해 새롭게 시작합니다."

이 가이드에서는 /clear가 정확히 무엇을 초기화하고 무엇을 유지하는지, 삭제한 내용으로 어떻게 되돌아가는지, 그리고 언제 /compact나 새 세션 또는 다른 명령어를 사용하는 것이 더 나은 선택인지 설명합니다.

/clear의 역할

/clear는 현재 진행 중인 대화를 종료하고 빈 컨텍스트 창으로 새 대화를 시작합니다. Claude Code 용어로는 새로운 세션을 시작하는 것입니다. 이전 세션은 삭제되지 않습니다. Anthropic의 세션 문서에 따르면 "Claude Code는 이전 세션을 저장하며, /resume으로 다시 시작할 수 있습니다"라고 명시되어 있습니다.

이 명령어에는 /reset과 /new라는 두 개의 별칭이 있으며, 선택적으로 이름을 지정할 수 있습니다. 명령어 참조 가이드에서는 이름의 역할을 다음과 같이 설명합니다: "이름을 전달하여 /resume 선택기에서 이전 대화에 라벨을 붙일 수 있습니다."

또한 같은 참조 가이드에서는 완전히 새로 시작하고 싶지 않을 때의 대안을 제시합니다: "동일한 대화를 계속하면서 컨텍스트를 확보하려면 대신 /compact를 사용하세요."

/clear 후에도 유지되는 것

프로젝트 지침 및 memory

Claude Code에는 두 가지 memory 시스템이 있습니다. 사용자가 작성하는 CLAUDE.md 파일과 Claude가 작업하면서 작성하는 자동 메모리(auto memory)입니다. Anthropic의 memory 문서에 따르면 "두 가지 모두 모든 대화가 시작될 때 로드됩니다." /clear 이후에 시작되는 대화는 새로운 대화이므로 두 가지 모두 다시 로드됩니다.

이것이 실제로 "프로젝트 memory 유지"가 의미하는 바입니다. 프로젝트 루트의 CLAUDE.md에 있는 규칙, 설정 및 Claude가 자동 메모리에 저장한 내용은 모두 새 대화의 컨텍스트로 다시 돌아옵니다. 저장소에서 CLAUDE.md 대신 AGENTS.md를 사용하는 경우에도 동일하게 적용됩니다.

삭제된 대화 내용

이전 대화는 여전히 로컬 머신에 남아 있습니다. Anthropic의 대화형 모드 문서에 따르면 "이전 세션의 대화는 보존되며 다시 시작할 수 있습니다." 되돌아가는 방법은 두 가지입니다:

  • /resume: 세션 선택기를 엽니다. 여기서 /clear 시 이름을 지정했다면 해당 이름으로, 지정하지 않았다면 기본 이름으로 이전 대화가 나타납니다.
  • 되감기(rewind) 메뉴: 동일한 Claude Code 프로세스 내에 있는 경우 사용할 수 있습니다. Anthropic의 체크포인트 문서에 따르면 메뉴 상단에 이전 세션 ID로 라벨이 붙은 추가 항목이 표시되어 /clear 실행 전 활성화되었던 대화를 재개할 수 있습니다. "이 항목은 Claude Code를 종료하거나 다른 세션을 재개하기 전까지 사용할 수 있습니다."

Claude Code 세션 기록을 찾고 재개하는 방법 가이드에서 이러한 트랜스크립트가 저장되는 위치를 확인할 수 있습니다.

세션 이름 (특정 경우)

이름 지정에는 특정 규칙이 따릅니다. Anthropic의 세션 문서에 따르면 "인수 없이 실행하면 새 세션은 --name 또는 /rename으로 설정한 이름을 유지하지만, AI가 생성한 세션 제목은 유지하지 않습니다." 만약 /clear release-prep과 같이 이름을 전달하면, 그 이름은 종료하는 세션에 부여되고 새 세션은 이름 없이 시작됩니다.

프롬프트 히스토리

clear를 하기 전에 입력한 프롬프트들은 여전히 접근 가능합니다. Anthropic의 대화형 모드 문서는 프롬프트 리콜 동작을 다음과 같이 설명합니다: "/clear를 실행하면 새 세션이 시작됩니다. 리콜 기능은 새 세션의 프롬프트를 먼저 나열하고, 그 뒤에 이전 세션의 프롬프트를 나열합니다." 이전 작업의 시작 프롬프트를 재사용하고 싶다면 위쪽 화살표 키를 눌러 해당 프롬프트로 되돌아갈 수 있습니다.

이는 편의 기능일 뿐 컨텍스트는 아닙니다. 리콜된 프롬프트는 다시 전송하기 전까지 입력창에 머물 뿐입니다.

전달되지 않는 것

대화 내용 자체

대화 속에만 존재했던 모든 것은 새 컨텍스트에서 제외됩니다. 사용자가 설명한 내용, Claude가 읽은 파일, 시도했던 접근 방식, 그리고 기록하지 않고 내린 결정 등이 이에 해당합니다. 새 대화는 이전 논의가 아니라 프로젝트 파일과 memory에서 시작됩니다.

이것이 이 명령어의 목적입니다. Anthropic의 컨텍스트 창 가이드는 이것이 왜 도움이 되는지 설명합니다: "오래된 대화는 다음에 필요한 파일을 밀어내고 메시지마다 토큰 비용을 발생시킵니다."

세션 카운터

Anthropic의 비용 문서에 따르면 /clear로 새 세션을 시작하면 세션의 총 비용 합계가 초기화됩니다. v2.1.211 이전 버전에서는 Claude Code 프로세스가 유지되는 동안 /clear를 해도 비용이 계속 누적되었습니다.

다시 실행되는 시작 후크(Startup hooks)

후크를 사용하는 경우 /clear는 세션 시작으로 간주됩니다. Anthropic의 후크 참조 가이드에서는 SessionStart 후크가 일치할 수 있는 소스 중 하나로 startup, resume, compact, fork와 함께 clear를 나열합니다. 시작 시 컨텍스트를 추가하는 후크는 clear 후에도 다시 컨텍스트를 추가할 수 있습니다. 동일한 참조 가이드에서는 한 가지 예외 상황을 언급합니다: "백그라운드 후크가 실행 중인 동안 /clear를 실행하거나 다른 대화로 전환하면, 해당 후크가 반환하는 내용은 세션에 적용되지 않습니다."

/clear, /compact 또는 새 세션

이 세 가지는 모두 공간을 확보한다는 점에서 혼동하기 쉽지만, 유지하는 내용은 매우 다릅니다.

/compact: 대화를 요약으로 유지

/compact는 동일한 대화 내에 머물면서 히스토리를 요약으로 대체합니다. Anthropic의 명령어 참조 가이드에서는 이를 "지금까지의 대화를 요약하여 컨텍스트를 확보하는 방법"으로 설명합니다. 실행 후 Claude Code는 프로젝트 루트의 CLAUDE.md, 범위가 지정되지 않은 규칙, 디스크의 자동 메모리를 다시 주입하고 최근 수정된 파일을 최대 5개까지 다시 읽습니다.

동일한 작업을 계속하면서 Claude가 맥락을 유지하기를 원할 때 /compact를 선택하세요. /compact keep the API changes and the test commands와 같이 집중 지침을 주어 요약 방향을 제어할 수 있습니다. 필요한 내용을 유지하도록 auto-compact를 조정하는 가이드에서 요약을 구성하는 방법을 더 자세히 다룹니다.

/clear: 대화가 아닌 프로젝트 유지

다음 작업이 이전 작업과 관련이 없을 때 /clear를 선택하세요. Anthropic의 모범 사례에서는 이를 명확하게 설명합니다: "서로 관련 없는 작업 사이에는 /clear를 하세요. 비용이 들지 않으며, 다음 작업이 이전 작업의 히스토리에 대해 계속 비용을 지불하지 않아도 됨을 의미합니다."

비용 문제는 긴 세션에서 중요합니다. Anthropic은 긴 세션에서 /compact 자체가 "요약을 위해 전체 대화를 읽어야 하므로 그 자체로 큰 요청이 된다"고 지적합니다. /clear는 아무것도 요약하지 않으며, 다음 대화는 시작 시 로드되는 내용으로만 시작됩니다.

종료 후 Claude 다시 시작

claude 세션을 새로 시작하는 것도 프로젝트 memory가 포함된 빈 대화를 제공합니다. 실질적인 차이는 되돌아가는 방법입니다. /clear 후에는 동일한 프로세스 내의 되감기 메뉴를 통해 이전 대화로 돌아갈 수 있지만, 종료한 후에는 /resume 또는 claude --resume을 사용해야 합니다. 오랜 휴식 후 이전 세션으로 돌아가는 경우, 오래된 세션 재개 전 Claude Code의 경고에 대한 가이드에서 관련 비용을 설명합니다.

유사해 보이는 다른 명령어들

/rewind는 코드와 대화를 이전 체크포인트로 되돌리거나 대화의 일부를 요약합니다. Claude Code 세션 되감기 가이드에서 어떤 편집 내용이 복구되는지 확인할 수 있습니다. /branch는 현재 대화의 분기를 생성하여 원본을 잃지 않고 다른 방향을 시도해 볼 수 있게 해줍니다.

/clear가 올바른 선택인 경우

Anthropic의 모범 사례에서는 두 가지 상황을 꼽습니다.

관련 없는 작업 사이. 가이드에 따르면 "작업 사이에 /clear를 하는 것은 여전히 가치가 있습니다. 집중된 컨텍스트가 더 나은 답변을 제공하고 비용도 적게 들기 때문입니다."

수정이 제대로 작동하지 않을 때. 가이드의 조언은 직설적입니다: "동일한 내용을 두 번 수정했는데도 여전히 틀렸다면, 세 번째 수정은 Claude가 계속해서 다시 읽어야 하는 두 번의 실패한 시도가 포함된 대화에 내용을 더할 뿐입니다." 권장 사항은 "/clear를 하고 배운 내용을 반영한 새로운 프롬프트 하나를 작성하는 것이 거의 매번 더 효과적입니다."

두 번째 경우가 더 위험할 수 있습니다. 두 번이나 말했던 수정 사항이 바로 새 대화에 필요한 내용인데, 이를 기록해두지 않으면 사라지기 때문입니다.

사람들이 흔히 하는 실수

프로젝트가 삭제될까 봐 /clear를 피함. 그렇지 않습니다. CLAUDE.md와 자동 메모리는 새 대화에서 다시 로드됩니다.

모든 새 작업 전에 /compact 실행. 이는 더 이상 필요 없는 작업의 요약을 유지하며, 요약을 만들기 위해 전체 대화를 읽습니다. 관련 없는 작업에는 /clear가 더 가볍습니다.

작업 도중에 clear 실행. 대화 속에서만 결정된 모든 내용은 이후 컨텍스트에서 사라집니다. 대신 compact를 하거나 결정을 먼저 저장하세요.

삭제된 대화가 영구 삭제되었다고 가정. 저장되어 있습니다. /resume이나 되감기 메뉴의 이전 세션 항목을 사용하세요.

동일한 실수를 세 번째 수정함. Anthropic은 대신 clear를 하고 더 나은 프롬프트 하나를 작성할 것을 권장합니다.

해결책: 다음 작업에 필요한 내용을 저장한 후 clear 하기

1단계: clear 하기 전, 대화보다 오래 유지되어야 할 내용을 기록하세요

다시 설명해야 할 내용이 있는지 찾아보세요: 수정한 컨벤션, 발견한 제약 사항, 결정 사항과 그 이유 등입니다. 컨벤션은 프로젝트 루트의 CLAUDE.md에 넣으세요. 다른 사항들은 Claude에게 기억해 달라고 요청하세요. Anthropic의 memory 문서에 따르면 Claude는 이를 자동 메모리에 저장하며, 이는 모든 대화 시작 시 로드됩니다. Claude Code가 수정한 내용을 잊어버리는 이유에 대한 가이드에서 각 수정 사항이 어디에 속하는지 다룹니다.

2단계: 이름을 지정하여 clear 하기

종료하는 작업에 대해 /clear oauth-migration과 같이 짧은 이름을 붙여 실행하세요. Anthropic의 모범 사례에서도 나중에 다시 돌아올 수 있도록 이 방법을 제안합니다. 그런 다음 이전 작업에서 필요한 내용을 포함한 명확한 프롬프트 하나로 새 작업을 시작하세요.

3단계: 필요하다면 되돌아가기

너무 일찍 clear 했다면, 동일한 프로세스 내에서 되감기 메뉴를 열고 이전 세션 항목을 선택하거나, /resume을 사용하여 이름이 지정된 세션을 선택하세요. 컨텍스트 한계에 도달한 긴 세션의 경우, Claude Code의 1M 컨텍스트 메시지에 대한 가이드에서 압축(compaction)이 유지하는 내용을 설명합니다.

MemoryLake에서 설정하기

/clear가 효과적인 이유는 프로젝트의 memory가 유지되기 때문입니다. 약점은 대화 중에 도달했지만 기록하지 않은 결정 사항입니다. 하나의 저장소 내에서는 CLAUDE.md와 자동 메모리가 이를 보관할 수 있습니다. 하지만 동일한 결정이 다른 저장소, 다른 머신, 또는 다른 도구에서도 중요할 때는 특정 프로젝트에 종속되지 않은 공간이 필요합니다.

MemoryLake는 이러한 종류의 컨텍스트를 사용자가 관리하는 하나의 리스트에 보관하여 Claude Code뿐만 아니라 ChatGPT, Codex 등 연결된 다른 어시스턴트에서도 사용할 수 있게 해주는 memory 레이어입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. Claude Code 세션, CLAUDE.md 파일, 자동 메모리 또는 어떤 벤더의 저장소에서도 내용을 읽거나 쓰거나 삭제하지 않습니다. /clear는 Anthropic이 설명한 방식 그대로 계속 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 이 키는 MemoryLake 워크스페이스에 속하며 Claude 계정과는 별개입니다.

에이전트에서 사용하기 위해 새 키를 생성하고 복사하는 MemoryLake 콘솔의 API 키 화면
에이전트에서 사용하기 위해 새 키를 생성하고 복사하는 MemoryLake 콘솔의 API 키 화면

2단계: 첫 번째 메모리 업로드

해결책 1단계에서 작성한 내용 중 프로젝트 범위를 넘어서는 것부터 시작하세요: 선호도, 결정 사항, 반복하게 될 제약 사항 등입니다. 항목당 한 점씩, 날짜를 기입합니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리가 된 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 메모리가 된 MemoryLake 워크스페이스

3단계: AI 및 에이전트 연결

Claude Code와 사용하는 다른 어시스턴트를 연결하세요. /clear를 하거나, 새 세션을 시작하거나, 다른 도구로 전환한 후에도 동일한 결정 사항들을 사용할 수 있습니다.

메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면
메모리 레이어에 연결할 수 있는 AI 클라이언트 및 에이전트 프레임워크가 나열된 MemoryLake 통합 화면

실제적인 변화

첫 번째 차이점은 /clear가 더 이상 위험하게 느껴지지 않는다는 것입니다. 대화 내용은 비워지지만 프로젝트 지침과 memory는 유지된다는 것을 알기 때문입니다.

두 번째는 상황에 맞는 명령어를 선택하게 된다는 것입니다. 관련 없는 작업에는 /clear, 동일한 작업을 계속할 때는 /compact, 실행 취소에는 /rewind를 사용합니다.

세 번째는 중요한 내용이 대화 속에만 머물지 않게 된다는 것입니다. clear 하기 전에 결정 사항을 기록하므로, 다음 작업은 그 결정 사항들과 함께 시작됩니다.

Claude Code의 /clear 모범 사례

관련 없는 작업 사이에는 clear 하세요. 집중된 컨텍스트가 더 나은 답변을 제공하고 비용을 절감합니다.

작업 도중에는 clear 대신 compact 하세요. /compact는 현재 작업의 요약을 유지합니다.

clear 하기 전에 결정 사항을 저장하세요. CLAUDE.md에 넣거나 Claude에게 기억해 달라고 요청하세요.

종료하는 세션에 이름을 붙이세요. /clear <이름>을 사용하여 /resume에서 쉽게 찾을 수 있게 하세요.

두 번의 수정이 실패하면 clear 하세요. 그 다음 배운 내용을 포함한 하나의 프롬프트를 작성하세요.

되감기 메뉴를 사용하여 clear를 취소하세요. 종료하거나 다른 세션을 재개하기 전까지 유효합니다.

SessionStart 후크를 확인하세요. /clear 후에 다시 실행됩니다.

결론

/clear는 프로젝트 memory를 유지하면서 빈 컨텍스트 창으로 새 대화를 시작합니다. CLAUDE.md와 자동 메모리는 다시 로드되고, 삭제된 대화는 저장되어 재개할 수 있으며, --name 또는 /rename으로 설정한 이름은 유지됩니다. 전달되지 않는 것은 오직 대화 속에만 존재했던 내용들뿐입니다.

관련 없는 작업 사이나 반복된 수정 실패 후에 /clear를 사용하고, 동일한 작업을 계속할 때는 /compact를 사용하며, clear 하기 전에 반복하고 싶지 않은 결정 사항들을 기록해 두세요.

자주 묻는 질문

Claude Code에서 /clear는 무엇을 하나요?

빈 컨텍스트로 새 대화를 시작합니다. Anthropic에 따르면 프로젝트 memory를 유지하면서 새로운 작업을 위해 새롭게 시작하는 방법입니다.

/clear가 내 대화를 삭제하나요?

아니요. Claude Code는 이전 세션을 저장합니다. /resume으로 재개하거나, 동일한 프로세스 내의 되감기 메뉴에서 이전 세션 항목을 통해 재개할 수 있습니다.

/clear가 CLAUDE.md나 자동 메모리를 지우나요?

아니요. 두 가지 모두 /clear 이후에 시작되는 대화를 포함하여 모든 대화의 시작 시점에 로드됩니다.

/clear와 /compact의 차이점은 무엇인가요?

/clear는 새 대화를 시작합니다. /compact는 동일한 대화에 머물면서 히스토리를 요약으로 대체합니다.

/clear는 언제 사용해야 하나요?

관련 없는 작업 사이, 그리고 동일한 내용을 두 번 수정했는데도 성공하지 못했을 때 사용하세요.

/clear를 취소할 수 있나요?

네. 동일한 Claude Code 프로세스 내에서 되감기 메뉴를 열고 이전 세션 항목을 선택하거나, /resume을 사용하세요.