이 단원의 카드 9개
- 프로젝트 브리프
- 브랜드 기준 문서
- 비주얼 기준 문서
- 클로드 디자인으로 시안 만들기
- 보이스 기준 문서
- 업무 흐름 문서
- 규칙 파일 — CLAUDE.md
- 결정 원장 — decisions.md
- 조사 기준 문서
먼저 볼 카드 — 브랜드 기준 문서
실습 CLAUDE.md
규칙 파일 — CLAUDE.md
이 카드를 다루는 수업 자료를 잘 정리하는 법
매번 “이모지 빼고, 존댓말로” 같은 규칙을 다시 적어야 한다면, 그만큼 요청이 길어지고 깜빡 빠뜨린 요청만 규칙에서 벗어난 결과를 받게 됩니다.
CLAUDE.md는 세션이 시작될 때 자동으로 읽히는 규칙 파일입니다.
- 폴더 구조, 금지 사항, 톤, 자주 쓰는 명령어처럼 매번 설명하던 내용을 적어 둡니다. 이후 요청에서는 생략할 수 있습니다.
- 빈 프로젝트라면 /init을 실행해 코드와 문서를 분석한 초안을 먼저 받습니다.
파일은 크게 두 층입니다. 같은 내용이 두 파일에 있으면 프로젝트 파일이 우선 적용됩니다.
- 프로젝트 루트의 CLAUDE.md — 그 프로젝트에서 함께 일하는 사람과 공유하는 규칙
- 사용자 홈 폴더의 ~/.claude/CLAUDE.md — 어떤 프로젝트를 열어도 항상 적용되는 개인 규칙
규칙은 쌓기보다 관리합니다.
- 온갖 규칙을 한 파일에 계속 이어 붙이면 필요한 기준을 찾기 어려워집니다.
- 안 쓰는 규칙은 지우고, 자주 어기는 규칙은 눈에 잘 띄는 자리로 옮깁니다.
/context를 입력하면 현재 세션이 어떤 CLAUDE.md 파일을 불러왔는지 확인할 수 있습니다. /memory는 메모리 파일 위치를 열어 관리할 때 사용합니다.
CLAUDE.md에 적은 문장은 판단에 참고할 규칙입니다. 특정 단어가 있는 파일 저장을 반드시 막아야 한다면 Hooks — 자동 검수에서 PreToolUse Hook으로 같은 조건을 검사합니다.
순서의 각 단계 아래 붙여넣기 예제가 있습니다. 위에서부터 하나씩 실행해 보세요.
실행 순서
-
현재 도구가 읽는 프로젝트 규칙 파일을 확인하고 초안을 만듭니다.
이 프로젝트의 폴더 구조와 기존 규칙을 읽고, 현재 쓰는 Claude Code 또는 Codex가 읽는 규칙 파일의 위치를 확인해 주세요. 파일이 없으면 프로젝트 설명·자주 쓰는 명령·문체·금지 사항을 담은 초안을 만들고, 있으면 덮어쓰지 말고 필요한 추가 내용을 제안해 주세요. 확인하지 못한 명령은 만들지 말고, 파일 위치와 제가 검토할 부분을 알려 주세요.
확인현재 도구에 맞는 규칙 파일의 위치와 초안 또는 추가 제안을 확인할 수 있습니다.
-
반복해서 말해 온 규칙을 옮겨 적습니다.
방금 확인한 프로젝트 규칙 파일에 제가 정한 규칙인 ‘이모지는 쓰지 않습니다’를 추가해 주세요. 같은 규칙이 있으면 중복해서 넣지 말고, 기존 규칙과 충돌하면 고치기 전에 알려 주세요. 변경한 부분을 보여 주세요.
확인프로젝트 규칙 파일에 이모지 금지 규칙이 중복 없이 들어가고 변경 내용을 확인할 수 있습니다.
-
작업 중 새로 정한 규칙도 같은 파일에 추가하도록 요청합니다.
-
규칙 파일을 실제로 읽었는지 확인합니다.
지금 작업에 적용한 프로젝트 규칙 파일의 경로와 핵심 규칙을 알려 주세요. 실제로 읽은 파일만 답하고, 읽지 않았다면 먼저 읽어 주세요.
확인읽은 규칙 파일의 경로와 적용할 규칙이 함께 나옵니다.
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
CLAUDE.md에 [자주 반복해서 말하는 규칙 한 줄]을 추가해 줘. 이미 비슷한 규칙이 있으면 합쳐 줘.
/context에서 지금 불러온 CLAUDE.md 파일을 확인한 뒤, 서로 겹치거나 지금 프로젝트와 관계없는 규칙이 있으면 후보만 짚어 줘. 아직 파일은 고치지 마.
다음 요청에서 그 규칙을 다시 말하지 않아도 지켜지는지 확인해 보세요.
헷갈리기 쉬운 것
프로젝트 루트의 CLAUDE.md와 사용자 홈 폴더(~/.claude/CLAUDE.md)는 적용 범위가 다릅니다. 이 둘을 혼동하면 규칙을 적어도 왜 안 지켜지는지 알기 어렵습니다. CLAUDE.md는 Claude가 읽고 따르는 지시문이며, 조건을 어겼을 때 파일 저장을 기계적으로 막는 장치는 아닙니다. 반드시 막아야 하는 조건은 PreToolUse Hook 같은 검사로 옮기고, 실패 입력과 정상 입력을 각각 실행해 확인합니다.
용어 풀이
전체 용어집 →2026-08-19 기준 · 출처 · Claude Code — Memory