Skip to main content
Claude Code는 프로젝트 디렉토리와 홈 디렉토리의 ~/.claude에서 지침, 설정, skills, subagents, 메모리를 읽습니다. 프로젝트 파일을 git에 커밋하여 팀과 공유합니다. ~/.claude의 파일은 모든 프로젝트에 적용되는 개인 설정입니다. Windows에서 ~/.claude는 %USERPROFILE%\.claude로 확인됩니다. CLAUDE_CONFIG_DIR을 설정하면, 이 페이지의 모든 ~/.claude 경로가 대신 해당 디렉토리 아래에 있습니다. 대부분의 사용자는 CLAUDE.md와 settings.json만 편집합니다. 디렉토리의 나머지는 선택 사항입니다. 필요에 따라 skills, rules, subagents를 추가합니다.

​
디렉토리 탐색

트리의 파일을 클릭하여 각 파일이 무엇을 하는지, 언제 로드되는지, 예제를 확인합니다.

​
표시되지 않는 항목

탐색기는 작성하고 편집하는 파일을 다룹니다. 관련된 몇 가지 파일은 다른 위치에 있습니다. ~/.claude는 또한 작업할 때 Claude Code가 작성하는 데이터를 보유합니다. 트랜스크립트, 프롬프트 기록, 파일 스냅샷, 캐시, 로그입니다. 아래의 애플리케이션 데이터를 참조하세요.

​
올바른 파일 선택

다양한 종류의 사용자 정의는 다양한 파일에 있습니다. 이 표를 사용하여 변경 사항이 어디에 속하는지 찾습니다.

​
파일 참조

이 표는 탐색기가 다루는 모든 파일을 나열합니다. 프로젝트 범위 파일은 .claude/ 아래의 리포지토리에 있습니다 (또는 CLAUDE.md, .mcp.json, .worktreeinclude의 경우 루트에 있음). 전역 범위 파일은 ~/.claude/에 있으며 모든 프로젝트에 적용됩니다.
이 파일에 입력한 내용을 재정의할 수 있는 여러 가지가 있습니다.
  • 조직에서 배포한 관리 설정이 모든 것보다 우선합니다.
  • --permission-mode 또는 --settings와 같은 CLI 플래그는 해당 세션에 대해 settings.json을 재정의합니다.
  • 일부 환경 변수는 동등한 설정보다 우선하지만, 이는 다양합니다. 각각에 대해 환경 변수 참조를 확인하세요.
전체 순서는 설정 우선순위를 참조하세요.
파일 이름을 클릭하여 위의 탐색기에서 해당 노드를 엽니다.

​
설정 문제 해결

설정, hook, 파일이 적용되지 않으면, 설정 디버그에서 검사 명령과 증상 우선 조회 표를 참조하세요.

​
애플리케이션 데이터

작성하는 설정 외에도 ~/.claude는 세션 중에 Claude Code가 작성하는 데이터를 보유합니다. 이 파일은 일반 텍스트입니다. 도구를 통과하는 모든 항목은 디스크의 트랜스크립트에 저장됩니다: 파일 내용, 명령 출력, 붙여넣은 텍스트입니다.

​
자동으로 정리됨

아래 경로의 파일은 cleanupPeriodDays보다 오래되면 시작 시 삭제됩니다. 기본값은 30일입니다.

​
삭제할 때까지 유지됨

다음 경로는 자동 정리 대상이 아니며 무기한 지속됩니다. 기타 작은 캐시 및 잠금 파일은 사용하는 기능에 따라 나타나며 안전하게 삭제할 수 있습니다.

​
일반 텍스트 저장소

트랜스크립트 및 기록은 저장 시 암호화되지 않습니다. OS 파일 권한이 유일한 보호입니다. 도구가 .env 파일을 읽거나 명령이 자격 증명을 인쇄하면, 해당 값이 projects/<project>/<session>.jsonl에 작성됩니다. 노출을 줄이려면:
  • cleanupPeriodDays를 낮춰 트랜스크립트를 유지하는 기간을 단축합니다.
  • CLAUDE_CODE_SKIP_PROMPT_HISTORY 환경 변수를 설정하여 모든 모드에서 트랜스크립트 및 프롬프트 기록 작성을 건너뜁니다. 비대화형 모드에서는 대신 -p와 함께 --no-session-persistence를 전달하거나 Agent SDK에서 persistSession: false를 설정할 수 있습니다.
  • 권한 규칙을 사용하여 자격 증명 파일의 읽기를 거부합니다.

​
로컬 데이터 지우기

claude project purge를 실행하여 한 프로젝트에 대해 Claude Code가 보유한 상태를 삭제합니다. 이 명령은 Claude Code v2.1.124 이상이 필요합니다. 다음을 삭제합니다:
  • projects/ 아래의 트랜스크립트 및 자동 메모리
  • 세션별 tasks/, debug/, file-history/ 항목
  • history.jsonl의 일치하는 프롬프트 라인
  • ~/.claude.json의 프로젝트 항목
이 명령은 전체 삭제 계획을 인쇄하고 항목을 제거하기 전에 확인을 요청합니다. 삭제하지 않고 계획을 미리 봅니다:
단일 확인 프롬프트로 삭제합니다:
경로를 생략하여 대화형 목록에서 프로젝트를 선택합니다. 스크립트에서 사용하기 위해 확인 프롬프트를 건너뜁니다:
경로 대신 --all을 전달하여 한 번에 모든 프로젝트의 상태를 제거합니다. 이는 history.jsonl을 필터링하지 않고 완전히 삭제합니다. -i를 전달하여 삭제 계획을 한 번에 하나씩 단계별로 진행합니다. 이 명령은 프로젝트 범위가 아니므로 shell-snapshots/ 및 backups/는 그대로 두고 계획 출력에서 이에 대해 경고합니다. 주어진 경로와 일치하는 상태가 없으면 상태 1로 종료됩니다. 위의 애플리케이션 데이터 경로를 언제든지 손으로 삭제할 수 있습니다. 새 세션은 영향을 받지 않습니다. 아래 표는 과거 세션에서 손실되는 항목을 보여줍니다. ~/.claude.json, ~/.claude/settings.json, ~/.claude/plugins/를 삭제하지 마세요. 이들은 인증, 기본 설정, 설치된 플러그인을 보유합니다.