.claude 폴더(.claude directory)

프로젝트 상자 속 서랍과 집의 서랍이 나란히 놓여, 프로젝트용과 개인용 Claude Code 설정 폴더를 보여 줍니다.

무엇인가요

.claude 폴더는 가 설정을 찾는 곳입니다. 이 폴더는 두 군데에 있습니다. 의 .claude/ 는 그 프로젝트의 설정을 담고, 에 해 팀이 같이 씁니다. 홈 폴더의 ~/.claude/ 는 모든 프로젝트에 쓰는 내 설정을 담습니다. 안에는 설정·규칙·· 등을 둘 수 있지만, 대부분은 CLAUDE.md 와 settings.json 만 고치고 나머지는 필요할 때 더합니다. ~/.claude/ 에는 대화 기록· 기록·로그처럼 Claude Code 가 일하면서 쓰는 자료도 쌓입니다.

어떻게 돌아가나요

프로젝트에 .claude/ 만들기
필요하면 settings.json·규칙 더하기
같이 쓸 파일은 git 에 커밋
내 설정은 ~/.claude/ 에

이렇게 씁니다

.claude/settings.json

팀이 같이 쓰는 ·훅·환경 변수·기본 입니다.
.claude/skills/<name>/SKILL.md

/name 으로 부르거나, 알맞을 때 가 스스로 쓰는 재사용 프롬프트입니다.
.claude/agents/*.md

저마다 프롬프트와 도구를 가진 서브에이전트 정의입니다.
~/.claude/projects/<project>/memory/

자동 로, Claude 가 세션을 넘어 스스로 남기는 메모입니다.

주의할 점

모든 파일이 이 폴더에 있지는 않습니다. CLAUDE.md 와 .mcp.json 은 프로젝트 루트에 둘 수 있고, managed-settings.json 은 시스템 폴더에 있으며, ~/.claude.json 은 폴더가 아니라 앱 상태를 담는 따로 있는 파일입니다. 에서 ~/.claude 는 %USERPROFILE%\.claude 이고, CLAUDE_CONFIG_DIR 을 정하면 홈 폴더 쪽 위치를 옮길 수 있습니다.

원문과 공식 문서

이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.

취소할 대기 예약을 선택하세요. 각 예약은 확인 후 취소됩니다.

내 :

닫기

알림

알림을 켜는 방법

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

원문과 공식 문서

무엇인가요

어떻게 돌아가나요

이렇게 씁니다

주의할 점

함께 보면 좋은 용어

원문과 공식 문서