.claude 디렉토리 탐색

디렉토리 탐색

표시되지 않는 항목

올바른 파일 선택

파일 참조

파일별 프론트매터 필드

설정 문제 해결

애플리케이션 데이터

• 시스템 프롬프트
• 도구 정의
• 요청 매개변수
• CLAUDE.md와 같이 로드한 지침 파일

자동으로 정리됨

• sessions/: 실행 중인 각 세션에 대해 하나의 작은 파일을 보유합니다. 동시 세션 및 충돌을 감지하는 데 사용됩니다. 나이 기반 스윕의 일부가 아닙니다: Claude Code는 세션이 종료될 때 각 파일을 제거하고 다음 시작 시 충돌 남은 것을 정리합니다.
• seed-admin/: Claude Code가 ultrareview 또는 클라우드 세션 업로드를 위해 저장소를 패키징하는 동안 만드는 임시 git 디렉터리입니다. 업로드가 끝나면, 또는 업로드가 중단된 경우 이후 세션에서, Claude Code는 해당 업로드의 디렉터리를 제거하고 seed-admin/은 그대로 둡니다.
• 자동 메모리: 스윕은 프로젝트의 자동 메모리 디렉토리 projects/<project>/memory/의 메모리 파일을 삭제하지 않습니다. Claude Code는 전체 보존 기간 동안 비어 있었던 경우에만 해당 디렉토리를 제거합니다. v2.1.228 이전에는 스윕이 메모리 디렉토리 내의 폴더를 세션 데이터로 취급하고 그 아래의 오래된 파일을 삭제할 수 있었습니다.
• Claude Desktop 및 Cowork 트랜스크립트: Claude Code는 Claude Desktop 또는 Cowork에서 시작하거나 가장 최근에 계속한 세션의 트랜스크립트를 나이에 관계없이 유지합니다. 이 트랜스크립트에 나이 제한을 주려면 desktopSessionCleanupPeriodDays를 설정하세요. Claude Code v2.1.248 이상 필요; 이전 버전은 cleanupPeriodDays 후에 삭제합니다. 다음과 같은 경우에는 Claude Code가 대신 cleanupPeriodDays 후에 이 트랜스크립트를 삭제합니다:
  • 관리형 설정이 cleanupPeriodDays를 설정한 경우
  • HIPAA 구성이 세션에 적용되는 경우

• Bare mode: --bare로 claude -p를 실행할 때, Claude Code는 해당 세션에서 스윕을 실행하지 않습니다.
• 일시 중지된 스윕: Claude Code가 보존 기간을 안전하게 결정할 수 없으면 스윕을 일시 중지합니다. retention_sweep 이벤트는 이를 일시 중지하는 각 구성을 나열합니다. 원인이 읽거나 구문 분석할 수 없는 설정 파일이거나 cleanupPeriodDays 또는 desktopSessionCleanupPeriodDays가 설정된 상태에서의 설정 오류인 경우, 원인을 수정할 때까지 /status에 경고가 표시됩니다.

세션 스크래치패드 디렉토리

• 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\

• API 키가 아닌 claude.ai 계정으로 로그인했습니다
• 세션은 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry가 아닌 Anthropic API를 사용합니다
• enableArtifact가 false로 설정되지 않았습니다

삭제할 때까지 유지됨

유지해야 할 상태 파일

• .credentials.json: 사용자의 로그인 자격증명
• agent-memory/: subagent 메모리
• jobs/ 및 daemon/: background session 상태

평문 저장소

• cleanupPeriodDays를 낮춰 Claude Code가 트랜스크립트를 유지하는 기간을 단축하세요
• desktopSessionCleanupPeriodDays를 설정하여 Claude Desktop 및 Cowork 트랜스크립트에도 나이 제한을 주세요
• CLAUDE_CODE_SKIP_PROMPT_HISTORY 환경 변수를 설정하여 모든 모드에서 트랜스크립트 및 프롬프트 히스토리 작성을 건너뛰세요. 비대화형 모드에서는 대신 -p와 함께 --no-session-persistence를 전달하거나 TypeScript Agent SDK에서 persistSession: false를 설정할 수 있습니다. Python SDK에는 동등한 옵션이 없습니다.
• 권한 규칙을 사용하여 자격증명 파일의 읽기를 거부하세요

로컬 데이터 지우기

• projects/ 아래의 트랜스크립트 및 자동 메모리
• 세션별 tasks/, debug/ 및 file-history/ 항목
• history.jsonl의 일치하는 프롬프트 라인
• ~/.claude.json의 프로젝트 항목

claude purge ~/work/my-repo --dry-run

Purge plan for /home/user/work/my-repo:

  dir:    /home/user/.claude/projects/-home-user-work-my-repo
           project transcripts (.jsonl) and memory/
  config: projects["/home/user/work/my-repo"]
           project entry in ~/.claude.json (trust, history, MCP servers)
  filter: /home/user/.claude/history.jsonl
           12 prompt(s) typed in this project

shell-snapshots/ are not project-scoped and will not be touched
backups/ may still contain this project entry in old .claude.json snapshots (/home/user/.claude/backups); at most 5 are kept and they rotate out automatically
Dry run: 3 item(s) would be deleted.

claude purge ~/work/my-repo

claude purge ~/work/my-repo --yes

• 경로 대신 --all을 전달하면 한 번에 모든 프로젝트의 상태를 purge합니다. 이 경우 history.jsonl을 필터링하는 대신 완전히 삭제합니다.
• -i를 전달하면 삭제 계획을 한 번에 한 항목씩 단계별로 진행합니다.

관련 리소스

• Claude의 메모리 관리: CLAUDE.md, rules, auto memory 작성 및 구성
• 설정 구성: 권한, hooks, 환경 변수, 모델 기본값 설정
• Skills 생성: 재사용 가능한 프롬프트 및 워크플로우 구축
• Subagents 구성: 자신의 컨텍스트가 있는 특화된 에이전트 정의