규칙(Rules)
CLAUDE.md 와 함께 읽히는 .claude/rules/ 의 지시 파일. 무엇인지, 어떻게 돌아가고 어떻게 쓰는지, 조심할 점까지 그림과 예로 풀어 봅니다.
무엇인가요
규칙은 .claude/rules/ 폴더에 두는 작은 파일입니다. 아주 긴 CLAUDE.md 하나를 쓰는 대신 testing.md·security.md 처럼 주제마다 파일을 나누어, 팀이 관리하기 쉽게 합니다. paths 가 없는 규칙은 세션을 시작할 때마다 읽히고, .claude/CLAUDE.md 와 같은 우선순위를 가집니다. 프런트매터에 paths 가 있는 규칙은 가 맞는 파일을 읽거나 쓰거나 고칠 때만 읽혀서, 필요할 때까지 자리를 차지하지 않습니다.
어떻게 돌아가나요
-
.claude/rules/ 폴더 만들기
-
주제마다 Markdown 파일 하나
-
paths 로 읽힐 때를 좁히기
-
필요할 때 Claude 가 읽음
이렇게 씁니다
-
.claude/rules/testing.md파일 하나에 주제 하나를 씁니다. 안의
.md파일을 모두 찾으므로frontend/같은 도 됩니다. -
paths에"src/api/**/*.ts"Claude 가 맞는 파일을 다룰 때만 규칙이 읽힙니다. 예를 들어 Read·Edit 도구를 쓰거나 그 파일에
cat을 쓸 때입니다. -
~/.claude/rules/이 컴퓨터의 모든 프로젝트에 쓰는 내 규칙입니다. 프로젝트 규칙보다 먼저 읽힙니다.
-
ln -s ~/shared-claude-rules .claude/rules/shared로 규칙 묶음 하나를 여러 프로젝트가 같이 씁니다. 프로젝트 밖을 가리키는 링크는 한 번 허락을 받아야 합니다.
주의할 점
가 규칙에서 읽는 프런트매터 칸은 paths 하나뿐이고, 이 깨지면 paths 가 없는 규칙처럼 읽습니다. 사용자 규칙과 프로젝트 규칙이 서로 다르면 Claude 가 어느 쪽을 따를지 모르니 둘을 맞춰 둡니다. 한 가지 일에만 필요한 지시는 부를 때나 관련 있을 때만 읽히는 이 더 알맞을 때가 많습니다.
함께 보면 좋은 용어
원문과 공식 문서
이 페이지는 용어를 쉬운 말로 풀어 쓴 것입니다. 기준은 원문이니, 다르면 원문을 따르세요.
- 원문에서 이 용어 보기Claude Code Docs — Glossary Anthropic · 2026-10-19 확인
- Anthropic — Claude Code docs: How Claude remembers your project — Organize rules with claude/rules/(새 창에서 열림)
- Anthropic — Claude Code docs: How Claude remembers your project — Path specific rules(새 창에서 열림)
- Anthropic — Claude Code docs: How Claude remembers your project — User level rules(새 창에서 열림)
- Anthropic — Claude Code docs: Explore the .claude directory — File reference(새 창에서 열림)