요즘 클로드 코드 쓰는 사람은 많아졌는데, 진짜 차이는 폴더 구조 세팅에서 갈립니다.

대부분은 CLAUDE.md 하나만 만들어놓고 끝내지만 실제로 클로드 코드를 프로젝트 전담 개발자처럼 쓰려면 루트 파일과 .claude 폴더를 같이 설계해야 합니다.

한 번만 세팅해두면 매번 설명하지 않아도 Claude가 프로젝트 목표, 규칙, 반복 업무, 금지 행동, 자동화 흐름을 기억하고 움직입니다.

3줄 요약

• CLAUDE.md는 Claude에게 주는 프로젝트 업무 지시서입니다.
• .claude 폴더는 Claude가 실제로 일하는 방식, 버튼, 팀원, 안전장치를 넣는 작업실입니다.
• Agents, Skills, Hooks 3가지만 잡아도 Claude Code 활용도가 확 달라집니다.

전체 폴더 구조 한눈에 보기

your-project/
├── CLAUDE.md
├── CLAUDE.local.md
├── .gitignore
├── .mcp.json
├── .claude/
│   ├── agents/
│   │   ├── code-reviewer.md
│   │   └── researcher.md
│   ├── skills/
│   │   └── carousel/
│   │       ├── SKILL.md
│   │       └── scripts/
│   │           └── export.ts
│   ├── commands/
│   │   └── commit.md
│   ├── hooks/
│   │   ├── PostToolUse.sh
│   │   └── SessionStart.sh
│   ├── output-styles/
│   │   └── terse.md
│   ├── plugins/
│   │   └── vercel/
│   └── rules/
│       └── api.md
├── settings.json
├── settings.local.json
└── statusline.sh

이 구조를 다 만들어야 한다는 뜻은 아닙니다.

처음에는 CLAUDE.md, .claude/agents, .claude/skills, .claude/hooks 정도만 잡아도 충분합니다.

1. CLAUDE.md — 프로젝트의 두뇌

CLAUDE.md는 Claude에게 주는 프로젝트 매뉴얼입니다.

사람으로 치면 첫 출근한 직원에게 주는 온보딩 문서입니다. 이 파일이 없으면 Claude는 매번 프로젝트 상황을 새로 물어봐야 하고, 같은 설명을 반복해야 합니다.

여기에 적어둘 내용은 아래 정도면 됩니다.

• 이 프로젝트의 목적