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

Claude Code Scratchpad 위치는 어디인가요? Claude가 보관하는 내용, 파일 삭제 시점, 사라지기 전에 저장하는 방법 (2026)

Claude Code가 테스트 데이터를 재구성하기 위한 헬퍼 스크립트를 작성하고 실행한 뒤, 해당 스크립트를 scratchpad에 저장했다고 언급했습니다. 스크립트는 잘 작동했습니다. 2주 후, 다른 데이터셋에 동일한 스크립트를 사용하려고 프로젝트 폴더를 찾아보았지만 보이지 않았습니다. ~/.claude 폴더에도 없었습니다.

그 이유는 scratchpad가 두 곳 어디에도 속하지 않으며, 영구 보관용이 아니기 때문입니다. Anthropic의 문서에 따르면 scratchpad는 "임시 파일: 프로젝트에 속하지 않는 중간 결과물, 헬퍼 스크립트, 초안"을 위한 공간이며, 시스템의 임시 디렉터리(temp directory) 아래에 위치하여 Claude Code와 운영 체제 모두에 의해 삭제될 수 있습니다.

2025년 11월 13일, Claude Code 2.1.325 버전에서 이에 대한 Claude의 자체 지침이 변경되었습니다. 변경 로그에는 다음과 같이 기록되어 있습니다: "삭제될 수 있는 임시 scratchpad 폴더 대신, 사용자가 원하는 파일을 다른 곳에 보관하도록 Claude의 지침을 변경함."

이 가이드에서는 scratchpad의 정의, macOS, Linux, Windows에서의 위치, scratchpad가 생성되는 세션 조건, 파일 유지 기간, claude purge가 제거하는 것과 제거하지 않는 것, 2.1.325 버전의 변경 사항, 그리고 Claude가 작성한 내용을 나중에 사용하기 위해 보존하는 방법을 다룹니다.

scratchpad란 무엇인가요?

Anthropic의 문서는 다음과 같이 정의합니다: "scratchpad는 Claude Code가 Claude에게 제공하는 세션별 디렉터리로, 프로젝트에 속하지 않는 중간 결과물, 헬퍼 스크립트, 초안과 같은 임시 파일을 위한 공간입니다."

두 가지 세부 사항이 편의성을 높여줍니다. Claude는 일반 임시 폴더 대신 이곳을 사용하며, 문서에 따르면 Claude는 "권한 요청 없이도 이 폴더 내의 파일을 생성, 편집, 읽을 수 있습니다." 따라서 Claude가 무언가를 시도해야 할 때, 매번 사용자에게 묻거나 저장소에 파일을 추가하지 않고도 작업을 수행할 수 있습니다.

Claude가 무언가를 scratchpad에 저장했다고 말하면, 그것은 말 그대로 파일이 이 디렉터리에 있음을 의미합니다.

세션별로 할당되므로, 각 Claude Code 세션은 고유한 scratchpad를 가집니다. 한 세션의 scratchpad에 있는 파일은 다음 세션에서는 공유되지 않습니다.

위치는 어디인가요?

scratchpad는 프로젝트 폴더와 Claude Code 설정 폴더 외부에 위치합니다. "scratchpad는 ~/.claude가 아닌 Claude Code의 임시 디렉터리(temp directory) 아래에 있습니다."

문서화된 경로:

  • macOS: /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/
  • Linux: /tmp/claude-<uid>/<project>/<session-id>/scratchpad/ (또는 시스템에 설정된 $TMPDIR 아래의 동일한 구조)
  • Windows: %TEMP%\claude\<project>\<session-id>\scratchpad\

<project> 부분은 작업 디렉터리 경로에서 문자와 숫자를 제외한 모든 문자를 하이픈으로 바꾼 형태입니다(예: -Users-you-my-project). Windows에서는 해당 문자열의 16자 해시값입니다. Desktop 앱 세션에서는 문자열 자체가 될 수 있습니다.

현재 경로를 찾는 가장 간단한 방법 역시 문서에 나와 있습니다: "정확한 경로를 알려달라고 Claude에게 요청하세요."

두 가지 설정이 이 구조를 변경할 수 있습니다:

  • CLAUDE_CODE_TMPDIR. 이 환경 변수를 설정하면 전체 트리가 해당 디렉터리 아래로 이동합니다.
  • Hooks. "Hook은 현재 세션의 경로를 scratchpad_dir로 전달받습니다." 이는 세션 종료 시 scratchpad에서 무언가를 복사해오고 싶을 때 유용합니다.

어떤 세션에 scratchpad가 생성되나요?

모든 세션에 scratchpad가 생기는 것은 아닙니다. 문서에는 다음 세 가지 조건이 모두 충족되어야 한다고 명시되어 있습니다:

  • API 키가 아닌 claude.ai 계정으로 로그인되어 있어야 함.
  • Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry가 아닌 Anthropic API를 사용하는 세션이어야 함.
  • enableArtifact 설정이 false로 설정되어 있지 않아야 함.

- 이 중 하나라도 해당되지 않으면 세션에 scratchpad가 없으며, Claude는 scratchpad 없이 작동합니다. Hook 필드에도 이 점이 반영되어, 세션에 scratchpad가 없거나 임시 디렉터리를 사용할 수 없는 경우 scratchpad_dir이 나타나지 않습니다.

파일은 얼마나 오래 유지되나요?

이 부분이 사라진 헬퍼 스크립트에 대한 해답입니다. 문서는 명확합니다: "scratchpad 파일은 세션의 트랜스크립트(transcript)가 유지되는 동안만 존재합니다. 보존 스윕(retention sweep)이 트랜스크립트를 삭제할 때 디렉터리도 함께 삭제하며, claude purge는 임시 디렉터리를 건드리지 않습니다."

보존 스윕은 트랜스크립트의 생성 시간을 기준으로 실행됩니다. Claude Code는 cleanupPeriodDays 설정값보다 오래된 경로의 파일들을 삭제합니다. 기본값은 30일이며 최소값은 1일입니다. 트랜스크립트가 삭제되면 해당 scratchpad도 함께 사라집니다.

Claude Code와 무관하게 파일이 사라지는 두 번째 경로도 있습니다: "디렉터리가 시스템 임시 위치에 있기 때문에, 재부팅 시와 같이 운영 체제에 의해 삭제될 수도 있습니다."

따라서 scratchpad 파일은 다음과 같은 경우 사라질 수 있습니다:

  • 세션 트랜스크립트가 보존 기한에 도달하여 삭제될 때
  • 운영 체제가 임시 위치를 정리할 때 (재부팅 등)

두 번째 경우는 Claude Code의 보존 설정과 전혀 무관합니다. 어제 본 파일이 재부팅 후 사라질 수 있습니다.

claude purge가 제거하는 것과 제거하지 않는 것

claude purge는 Claude Code가 한 프로젝트에 대해 보유한 상태를 삭제합니다: projects/ 아래의 트랜스크립트 및 자동 memory, 세션별 작업(tasks), 디버그 및 파일 기록 항목, 프롬프트 기록의 일치하는 라인, 그리고 ~/.claude.json의 프로젝트 항목이 포함됩니다.

하지만 scratchpad는 건드리지 않습니다. 문서에서는 그 이유를 다음과 같이 설명합니다: 붙여넣은 이미지와 "각 세션의 scratchpad는 ~/.claude가 아닌 Claude Code의 임시 디렉터리에 저장되므로, purge 명령으로 제거되지 않습니다."

이는 개인정보 보호를 위해 프로젝트를 퍼지(purge)하려는 경우 알아두어야 할 세부 사항으로 이어집니다: "퍼지된 세션의 scratchpad는 사용자가 직접 삭제하거나 운영 체제가 임시 디렉터리를 정리할 때까지 남아 있습니다."

모든 것을 제거하고 싶다면, 퍼지 후 위에 설명된 경로를 사용하여 프로젝트의 scratchpad 폴더를 직접 삭제하십시오.

쓰기가 제한될 때도 쓰기 가능한 곳

일부 팀은 permissions.blockWritesOutsideWorkingDirectories를 활성화하여 Claude의 파일 편집 도구가 작업 디렉터리 외부의 경로를 거부하도록 설정합니다. scratchpad는 여기서 예외 중 하나입니다. Anthropic의 설정 참조에 따르면, 플랜(plan) 파일, scratchpad, 백그라운드 세션의 tmp 디렉터리, 자동 memory .md 파일은 Claude Code 자체 파일로 간주되어 쓰기 가능한 상태로 유지됩니다.

따라서 차단 설정으로 인해 프로젝트 외부의 다른 곳에 파일을 쓸 수 없는 경우에도 Claude는 초안 작성을 위해 scratchpad를 계속 사용할 수 있습니다. 플랜 파일 또한 이러한 예외 중 하나이며, 이에 대해서는 Claude Code 플랜 파일 저장 위치 가이드에서 다루었습니다.

2.1.325 버전의 변경 사항

11월 13일 릴리스에서는 Claude가 나중에 필요할 파일을 scratchpad 외부에 보관하도록 지침이 변경되었습니다. 이는 Claude에게 전달되는 프롬프트의 변화입니다. 스크립트, 보고서, 데이터셋과 같이 재사용할 항목은 삭제될 수 있는 폴더가 아닌 다른 곳에 저장하도록 지시받습니다.

이는 지침일 뿐 보장되는 것은 아닙니다. 문서의 조언은 여전히 유효합니다: "Claude가 그곳에 작성한 내용을 보관하려면, Claude에게 프로젝트 내부로 옮겨달라고 요청하세요."

기타 알아두어야 할 사항

Desktop 세션은 다른 보존 규칙을 따릅니다. 보존 스윕은 모든 트랜스크립트에 일반적인 기간 제한을 적용하지 않습니다. Anthropic 문서에 따르면, Claude Desktop 또는 Cowork에서 시작하거나 최근에 이어서 작업한 세션의 트랜스크립트는 desktopSessionCleanupPeriodDays를 설정하지 않는 한 기간에 상관없이 유지됩니다. 이러한 세션의 경우 scratchpad 파일은 운영 체제의 임시 파일 정리를 더 주의해야 합니다.

붙여넣은 이미지는 근처에 저장됩니다. 프로젝트 세션에서 붙여넣거나 첨부한 이미지 역시 ~/.claude가 아닌 Claude Code의 임시 디렉터리에 저장됩니다. 보존 스윕은 cleanupPeriodDays보다 오래된 이미지를 삭제합니다.

Claude는 전체 경로를 명시합니다. 변경 로그 중 하나는 Claude가 scratchpad 파일을 파일명만 언급하거나 상대 경로로 언급하던 문제를 수정했습니다. 이제 Claude가 무언가를 저장했다고 말할 때 경로는 완전해야 합니다. 복사해야 할 경로는 바로 그 전체 경로입니다.

Artifact는 삭제된 scratchpad에서 복구될 수 있습니다. 또 다른 변경 로그에서는 다른 머신에서 세션을 재개하거나 scratchpad가 삭제된 후 Artifact 업데이트가 실패하던 문제를 수정했습니다. 이 경우 페이지의 마지막으로 게시된 버전이 복원됩니다. 게시된 작업물은 살아남지만, scratchpad의 작업 초안은 그러한 보호를 받지 못합니다.

보존 기간을 단축할 수 있습니다. 임시 파일이 오래 남는 것을 원치 않는다면, cleanupPeriodDays를 낮추어 스윕이 오래된 트랜스크립트와 scratchpad를 더 빨리 제거하게 할 수 있습니다. Anthropic은 민감한 값이 디스크에 머무는 시간을 줄이는 방법으로 이 설정을 낮출 것을 권장합니다.

scratchpad는 언제 사용하면 좋은가요?

scratchpad는 사라져도 무방한 작업에 적합합니다:

  • 중간 결과물: 로그 파일의 필터링된 복사본 등.
  • 일회성 스크립트: 무언가를 확인하기 위해 한 번 사용하고 버리는 스크립트.
  • 초안: 실제 적용하기 전에 다시 작성할 내용.

다음 주에도 필요할 항목에는 적합하지 않습니다: 재사용 가능한 스크립트, 공유할 보고서, 정성껏 가공한 데이터, 스크립트 분석 결과에 대한 메모 등입니다. 이러한 항목은 프로젝트 내부나 의도적으로 보관하는 장소에 두어야 합니다.

세션을 종료하기 전 간단한 테스트: Claude가 생성한 파일을 잃어버렸을 때 짜증이 날 것 같다면, 그 파일은 scratchpad에 두어서는 안 됩니다. Claude에게 세션 동안 그곳에 저장한 내용을 나열해 달라고 요청하고, 경로를 찾기 쉬울 때 필요한 파일을 옮기십시오.

사람들이 흔히 시도하는 것들

프로젝트 폴더에서 찾기. scratchpad는 프로젝트 외부에 있습니다.

~/.claude에서 찾기. 대신 Claude Code의 임시 디렉터리 아래에 있습니다.

모든 것을 지우기 위해 claude purge 실행하기. scratchpad는 제거되지 않습니다.

파일이 프로젝트만큼 오래 유지될 것이라 기대하기. 세션 트랜스크립트 기간만큼만 유지되며, OS가 임시 파일을 정리하면 더 짧아질 수 있습니다.

API 키 세션에서 scratchpad 찾기. 세션에는 claude.ai 로그인과 Anthropic API가 필요합니다.

해결책: 중요한 내용은 scratchpad 외부에 보관하기

1단계: Claude에게 저장 위치 묻기

Claude가 scratchpad를 언급하면, 세션이 열려 있는 동안 전체 경로를 물어보세요.

2단계: 재사용 가능한 항목은 프로젝트로 이동하기

Anthropic이 권장하는 대로, 나중에 다시 사용할 스크립트, 보고서, 데이터를 프로젝트 내부로 옮겨달라고 Claude에게 요청하세요.

3단계: Hook을 사용하여 세션 종료 시 복사하기

scratchpad 결과물을 자주 사용한다면, Hook에서 scratchpad_dir을 사용하여 파일을 보관용 폴더로 복사하도록 설정할 수 있습니다.

4단계: 작업 결과 기록하기

스크립트의 출력값은 일시적입니다. 어떤 레코드가 잘못되었는지와 같이 스크립트가 알려준 내용을 영구적인 곳에 기록해 두세요.

MemoryLake에서 설정하기

scratchpad는 삭제되도록 설계되었습니다. 일회성 분석 결과나 헬퍼 스크립트가 필요했던 이유와 같이 그곳에서 수행된 작업의 결론은 다음 세션에서 꼭 필요한 정보입니다.

MemoryLake는 이러한 프로젝트 컨텍스트(발견 사항, 결정 사항, 그 배경 이유 등)를 사용자가 관리하는 한 곳에 보관하고, ChatGPT, Claude Code, Codex 등 연결된 어시스턴트가 사용할 수 있게 해주는 기억 계층(memory layer)입니다.

사용자는 자신의 언어로 직접 항목을 작성합니다. scratchpad, Claude Code 임시 디렉터리, 트랜스크립트, ~/.claude 폴더, 프로젝트 파일 또는 공급업체의 저장소에서 데이터를 읽거나 쓰거나 삭제하지 않습니다. scratchpad와 그 정리 작업은 Anthropic이 설명한 방식 그대로 작동합니다.

1단계: API 키 생성

로그인 후 대시보드에서 키를 생성합니다. 다른 자격 증명과 마찬가지로 저장소 외부에 보관하세요.

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

2단계: 첫 번째 기억 업로드

해결책 4단계에서 작성한 내용부터 시작하세요: 최근 분석 결과, 발견된 데이터 문제, 그로 인해 내린 결정 등입니다. 항목당 하나의 발견 사항을 입력합니다.

첫 번째 문서가 업로드되어 각 파일이 검색 가능한 기억이 되는 과정을 보여주는 MemoryLake 워크스페이스
첫 번째 문서가 업로드되어 각 파일이 검색 가능한 기억이 되는 과정을 보여주는 MemoryLake 워크스페이스

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

Claude Code와 사용하는 다른 어시스턴트를 연결합니다. 이전 scratchpad가 사라진 후의 새 세션에서도 동일한 발견 사항을 활용할 수 있습니다.

기억 계층에 연결할 수 있는 AI 클라이언트와 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면
기억 계층에 연결할 수 있는 AI 클라이언트와 에이전트 프레임워크 목록을 보여주는 MemoryLake 통합 화면

실제적인 변화

첫 번째 차이점은 정리가 더 이상 중요한 정보의 손실을 의미하지 않는다는 것입니다. scratchpad는 비워질 수 있지만, 발견 사항은 이미 기록되어 있습니다.

두 번째는 반복 작업의 감소입니다. 무엇을 발견했는지 다시 확인하기 위해 분석을 재실행할 필요가 없습니다.

세 번째는 도구 간의 연속성입니다. 동일한 프로젝트의 Codex나 다른 어시스턴트도 동일한 발견 사항을 사용할 수 있습니다.

Claude Code scratchpad 모범 사례

임시 공간으로 취급하세요. 파일은 최대 세션 트랜스크립트 유지 기간만큼만 존재합니다.

재부팅 시 삭제될 것을 예상하세요. 시스템 임시 위치에 저장됩니다.

보관할 파일은 프로젝트로 옮기세요. 세션이 열려 있을 때 Claude에게 요청하세요.

개인정보 보호를 위해 purge에만 의존하지 마세요. claude purge 후 scratchpad 폴더를 직접 삭제하세요.

Hook에서 scratchpad_dir을 사용하세요. 현재 세션의 경로를 제공합니다.

로그인 상태를 확인하세요. API 키나 제3자 제공업체를 통한 세션에는 scratchpad가 제공되지 않습니다.

결론은 별도로 기록하세요. 출력물은 일시적이지만, 그 의미는 영구적이어야 합니다.

결론

Claude Code scratchpad는 ~/.claude나 프로젝트 폴더가 아닌 Claude Code의 임시 디렉터리 아래에 있는 세션별 임시 파일 폴더입니다. Claude는 묻지 않고도 그곳에 쓸 수 있으며, Anthropic API에서 claude.ai 계정으로 로그인한 세션에만 제공됩니다.

파일은 세션 트랜스크립트 기간만큼 유지되며, 보존 스윕이 cleanupPeriodDays 이후에 제거합니다. 또한 재부팅 시와 같이 운영 체제에 의해 더 빨리 삭제될 수 있습니다. claude purge는 scratchpad를 제거하지 않습니다. 2.1.325 버전부터 Claude는 나중에 필요한 파일을 scratchpad 외부에 두도록 지시받으며, Anthropic의 권고 사항도 동일합니다: 보관할 가치가 있는 것은 프로젝트 내부로 옮기십시오.

자주 묻는 질문

Claude Code scratchpad는 어디에 있나요?

Claude Code의 임시 디렉터리 아래에 있습니다: macOS는 /private/tmp/claude-<uid>/<project>/<session-id>/scratchpad/, Linux는 /tmp/claude-<uid>/..., Windows는 %TEMP%\claude\...입니다. 정확한 경로는 Claude에게 물어보세요.

scratchpad 파일은 얼마나 오래 유지되나요?

세션 트랜스크립트가 유지되는 동안 유지됩니다. 보존 스윕이 트랜스크립트와 함께 scratchpad를 삭제하며, 재부팅 시와 같이 운영 체제에 의해 더 빨리 삭제될 수도 있습니다.

claude purge가 scratchpad를 삭제하나요?

아니요. scratchpad는 ~/.claude가 아닌 임시 디렉터리 아래에 있으므로 purge 명령으로 제거되지 않습니다.

왜 제 세션에는 scratchpad가 없나요?

세션에 claude.ai 로그인, Anthropic API 사용, 그리고 enableArtifact가 false로 설정되지 않은 조건이 필요합니다.

scratchpad 위치를 변경할 수 있나요?

CLAUDE_CODE_TMPDIR 환경 변수를 설정하면 해당 디렉터리 아래로 위치가 이동합니다.

Claude가 scratchpad에 저장한 파일을 어떻게 보관하나요?

Anthropic이 권장하는 대로, Claude에게 해당 파일을 프로젝트 폴더로 옮겨달라고 요청하세요.

Claude Code 2.1.325에서 무엇이 바뀌었나요?

Claude가 삭제될 수 있는 scratchpad 대신, 사용자가 필요로 할 파일을 다른 곳에 보관하도록 지침이 업데이트되었습니다.