Claude Code 프로젝트 폴더 구조 CLAUDE.md와 .claude 폴더 역할

📁

Claude의 기능들 1강

Claude Code가 내 프로젝트를 어떤 구조로 관리하는지 알아봅시다

전체 구조 한눈에 보기

Claude Code를 프로젝트 폴더에서 실행하면, 자동으로 2가지가 만들어집니다.

📄

CLAUDE.md

“이 프로젝트에서는 이렇게 작업해줘”라는 지시서입니다. Claude가 매번 읽고 참고합니다.

🧰

.claude/ 폴더

Claude의 도구 상자입니다. 설정, 스킬, 에이전트, 메모리 등이 들어있습니다.

프로젝트 안의 Claude 관련 파일들

내 프로젝트/
├── CLAUDE.md                     # 프로젝트 지시서
├── .mcp.json                     # 외부 서비스 연결 설정
│
└── .claude/                      # Claude 도구 상자
    ├── settings.json             # 설정 파일
    ├── settings.local.json       # 내 PC 전용 설정
    │
    ├── rules/                    # 상황별 규칙 모음
    ├── skills/                   # 나만의 명령어 모음
    ├── agents/                   # 나만의 AI 보조원 모음
    ├── agent-memory/             # Claude가 기억하는 내용
    └── agent-memory-local/       # 내 PC에서만 기억하는 내용

각 폴더/파일이 하는 일

📄 CLAUDE.md

프로젝트 작업 지시서 (어떻게 작업할지 안내)

🔌 .mcp.json

외부 서비스 연결 정보 (GitHub, DB 등)

⚙️ settings.json

Claude의 동작 설정 (허용/차단할 작업 등)

🔒 settings.local.json

내 컴퓨터에서만 쓰는 개인 설정

📏 rules/

특정 상황에서만 적용되는 세부 규칙

⚡ skills/

내가 만든 단축 명령어 (예: /리뷰)

🤖 agents/

내가 만든 전문 AI 보조원

🧠 agent-memory/

Claude가 다음에도 기억할 내용

전역 설정도 있어요

프로젝트마다 설정하기 번거로운 것은 전역 설정으로 한 번만 해두면 모든 프로젝트에 적용됩니다.

전역 설정 위치

# Windows
C:\Users\사용자이름\.claude\

# Mac/Linux
~/.claude/

이 안에도 프로젝트와 동일하게 CLAUDE.md, settings.json, rules/, skills/ 등을 넣을 수 있습니다.

💡

우선순위: 프로젝트 설정이 전역 설정보다 우선합니다. 같은 항목이 있으면 프로젝트 쪽이 적용됩니다.

다음 강의CLAUDE.md 파일

⚙️ Claude의 기능들1 / 9강