.claude 폴더에 뭐가 들어가나 (한 장)

내용

📌 프로젝트 폴더 구조

my-project/
├── CLAUDE.md              ← 세션 시작 때 제일 먼저 읽는 파일
├── CLAUDE.local.md        ← 내 개인 메모 (git 에 안 올림)
├── .mcp.json              ← 외부 도구 연결
└── .claude/
    ├── settings.json       ← 권한·설정 (팀 공유)
    ├── settings.local.json ← 내 컴퓨터용 (git 에 안 올림)
    ├── rules/              ← CLAUDE.md 가 길어지면 쪼개는 곳
    ├── skills/             ← 반복 작업을 능력으로 등록
    ├── agents/             ← 역할별 분업
    ├── commands/           ← 옛 방식. 지금은 skills 로
    └── hooks/             ← 훅 스크립트 (등록은 settings.json 에)

📌 흐름
세션 시작 → CLAUDE.md 와 rules/ 읽음 → settings.json 으로 권한 확인
→ 작업 중 필요하면 skills/ 꺼내 씀 → 별도 역할이 필요하면 agents/
→ 외부 도구는 .mcp.json 을 통해

💡 대부분은 두 개면 됩니다
CLAUDE.md 와 settings.json. 나머지는 필요해질 때 하나씩 늘리세요.
미리 다 만들면 관리할 것만 늘어납니다.

[ 언제 무엇을 늘리나 ]
같은 지시를 세 번 반복했다        → skills/
리뷰어처럼 역할이 분명한 일이 생겼다 → agents/
CLAUDE.md 가 200줄을 넘었다      → rules/
깃허브·노션·DB 를 붙이고 싶다      → .mcp.json
반드시 자동으로 실행돼야 할 것이 있다 → hooks

⚠️ ~/.claude/ 는 다른 이야기입니다
프로젝트 폴더의 .claude/ 는 이 프로젝트에만,
홈 디렉터리의 ~/.claude/ 는 내 모든 프로젝트에 적용됩니다.
처음에는 프로젝트 폴더만 신경 쓰면 됩니다.

💡 웹 클로드에도 대응되는 것이 있습니다
CLAUDE.md → 프로젝트 지침 / skills/ → 스킬 / .mcp.json → 커넥터
구조를 알면 어디서든 응용됩니다.

궁금한 점: {{INPUT}}