Cursor Rules vs CLAUDE.md — AI 지시 파일 완전 비교 2026

Cursor를 쓰면 .cursor/rules/에 규칙을 넣고, Claude Code를 쓰면 CLAUDE.md에 지침을 쓴다. 둘 다 "AI한테 이렇게 코딩해줘"를 전달하는 파일인데, 구조도 다르고 동작 방식도 꽤 다릅니다. 저도 처음엔 두 파일이 어떻게 다른지 정확히 몰라서 대충 비슷한 내용을 두 군데 복붙해뒀었는데, 그게 최선이 아니더라고요. 이 글에서는 Cursor Rules와 CLAUDE.md를 실제 파일 구조부터 동작 원리, 각각의 한계까지 비교해서 어떤 상황에 뭘 쓸지 정리해봤습니다.

Cursor Rules와 CLAUDE.md 핵심 차이점 한눈에 보기 비교 인포그래픽

---

 

Cursor Rules란? .cursorrules vs .mdc 파일 차이부터

Cursor IDE에서 AI 동작 방식을 커스터마이즈하는 지시 파일 시스템입니다. 개발자가 규칙을 작성하면 Cursor의 AI 컨텍스트에 주입되어, 코딩 표준이나 프레임워크 규칙 같은 걸 AI가 자동으로 따르게 됩니다.

파일 형식이 두 가지입니다.

현대 방식 (.mdc, 2025년 이후 권장)

.cursor/
└── rules/
    ├── base.mdc          # 항상 적용
    ├── frontend.mdc      # 프론트엔드 파일에만 적용
    └── api.mdc           # API 파일에만 적용

확장자가 .mdc여야 합니다. .md로 만들면 그냥 무시됩니다. YAML 프론트매터로 4가지 활성화 모드를 제어할 수 있어서, 파일 패턴이 매칭될 때만 규칙이 적용되도록 설정할 수 있습니다.

모드	조건	설명
Always Apply	alwaysApply: true	모든 대화에 항상 로드 (200단어 이하 권장)
Auto Attached	globs 설정	매칭 파일이 컨텍스트에 있을 때 자동 로드
Agent Requested	description만 설정	AI가 작업 컨텍스트 보고 스스로 판단
Manual	둘 다 없음	@rule-name으로 명시적 참조 시에만 로드

레거시 방식 (.cursorrules)

프로젝트 루트에 단일 파일로 두는 방식입니다. 단순하긴 한데, 치명적인 문제가 하나 있어요. Agent 모드에서 무시됩니다. 에이전틱 워크플로우로 전환하는 순간 이 파일 전체가 로드되지 않습니다. 2026년 기준으로 커뮤니티 예제 대부분이 아직도 .cursorrules 기반인데, 이걸 모르고 계속 레거시 방식 쓰다가 "왜 규칙이 안 먹히지?" 하고 당황하는 케이스가 꽤 있습니다.

Cursor Rules의 주요 한계를 정리하면 이렇습니다.

• .cursorrules는 Agent 모드에서 무시됨 (위 설명 참고)
• Cursor Tab(자동완성)과 Inline Edit(Cmd+K)에는 규칙이 아예 적용 안 됨
• 파일당 최대 500줄 권장 — 초과하면 컨텍스트 우선순위가 낮아짐
• Always Apply 규칙은 매 요청마다 토큰을 소모, 과하면 컨텍스트 창이 빨리 찹니다
• Cursor 전용 — 도구 전환 시 마이그레이션 필요

---

 

CLAUDE.md란? 계층형 로딩 구조가 핵심

Claude Code가 세션 시작 시 자동으로 읽는 마크다운 파일입니다. 특수 문법이 없어요. 순수 마크다운으로 쓰면 됩니다. 저는 이 단순함이 처음엔 "기능이 없는 건가?" 싶었는데, 사실은 구조적으로 더 풍부합니다.

CLAUDE.md 계층형 로딩 구조 다이어그램 — Managed Policy부터 Local까지 5단계

파일 계층 구조 (로드 순서)

범위	위치	용도
Managed Policy	/etc/claude-code/CLAUDE.md	조직 전체 IT/DevOps 관리 지침
User	~/.claude/CLAUDE.md	개인 전역 선호 설정
Project	./CLAUDE.md	팀 공유 프로젝트 지침 (버전 관리)
Local	./CLAUDE.local.md	개인 프로젝트 설정 (gitignore 권장)
서브디렉터리	./src/CLAUDE.md 등	해당 디렉터리 파일을 열 때 온디맨드 로드

오버라이드가 아니라 누적 방식입니다. 발견된 파일을 전부 이어붙여서 컨텍스트에 로드합니다.

CLAUDE.md만의 기능 몇 가지를 보면:

@path 임포트 문법

프로젝트 개요는 @README를 참고.
npm 명령어는 @package.json 확인.
git 워크플로우: @docs/git-instructions.md

최대 4단계 재귀 임포트가 됩니다. 단, 임포트된 파일도 전부 로드되기 때문에 컨텍스트 절약 효과는 없습니다.

Auto Memory (v2.1.59 이상 기본 활성화)

Claude가 세션 중 스스로 학습한 내용을 ~/.claude/projects/<project>/memory/에 저장합니다. 빌드 명령어, 디버깅 패턴, 코드 스타일 선호 같은 것들을 자동으로 기록해두는 거예요. /memory 명령어로 현재 세션에 로드된 파일을 확인하거나 수정할 수도 있습니다.

CLAUDE.md의 한계도 있습니다.

• 지침은 권고이지 강제가 아님 — 규칙 위반을 막으려면 Hook을 써야 합니다
• 파일당 200줄 이하 권장, 초과 시 준수율이 떨어집니다
• /compact 후 서브디렉터리 CLAUDE.md는 자동 재주입되지 않음
• Claude Code 전용 — Cursor, Copilot 등에서는 인식 안 됩니다

---

 

Cursor Rules vs CLAUDE.md 핵심 차이점 비교

Cursor Rules vs CLAUDE.md 기술적 차이점 비교 표 — 주입 타이밍, 세션 지속성, 파일 임포트 등

가장 중요한 차이는 주입 타이밍입니다.

Cursor는 매 인라인 편집 요청마다 새 시스템 프롬프트를 생성해서 규칙을 매번 주입합니다. Claude Code는 세션 시작 시 한 번 컨텍스트에 로드합니다. 이 구조 차이가 각 파일의 최적 작성 스타일을 결정합니다.

항목	Cursor Rules	CLAUDE.md
적용 도구	Cursor IDE 전용	Claude Code 전용
파일 확장자	.mdc (현대), .cursorrules (레거시)	.md (표준 마크다운)
특수 문법	YAML 프론트매터	없음
주입 타이밍	매 요청마다 새로 주입	세션 시작 시 한 번 로드
계층 구조	3단계 (Global > Project > Directory)	5단계 (Managed > User > Project > Local + 서브디렉터리)
파일 임포트	지원 안 함	@path 문법 (최대 4단계 재귀)
자동 메모리	없음	Auto Memory 내장
경로 스코핑	globs 프론트매터	paths 프론트매터 (.claude/rules/)
최적 작성 스타일	짧고 명령형 ("Tailwind만 사용")	서술형 배경 + 명확한 규칙 혼합
커뮤니티 예제 수	2,000+	500+

이 표에서 "최적 작성 스타일" 부분이 실전에서 가장 체감이 큰 차이입니다. Cursor는 짧고 강한 명령형이 잘 먹히고, CLAUDE.md는 배경 맥락과 아키텍처 의도를 서술형으로 담아줄 때 효과가 좋습니다.

---

 

Cursor Rules vs CLAUDE.md — 어떤 상황에 어느 파일을 써야 할까?

Cursor Rules가 맞는 경우

• Cursor IDE를 주 편집기로 쓰고 Claude Code는 쓰지 않는 경우
• 파일 타입별로 세밀한 규칙 스코핑이 필요한 경우 (API 파일 vs 컴포넌트 파일별로 다른 규칙)
• 팀 전체가 Cursor를 쓰고 있어 커뮤니티 예제를 바로 가져다 쓰고 싶은 경우

CLAUDE.md가 맞는 경우

• Claude Code를 터미널 기반 주요 AI 코딩 도구로 쓰는 경우
• 장시간 세션에서 아키텍처 설명, 코드베이스 배경, 위험 구역 설명 같은 서술형 컨텍스트가 필요한 경우
• Auto Memory로 Claude가 프로젝트를 점진적으로 학습하길 원하는 경우
• 조직 전체 Managed Policy로 사내 표준을 강제해야 하는 경우

둘 다 써야 하는 경우

솔직히 2026년에 가장 흔한 패턴은 두 파일을 동시에 유지하는 것입니다. 각 도구는 자신의 파일만 읽습니다. Cursor는 .cursor/rules/*.mdc와 .cursorrules만 읽고, Claude Code는 CLAUDE.md와 .claude/rules/*.md만 읽습니다. 충돌이 없어요.

팀 내에 Cursor 사용자와 Claude Code 사용자가 섞여 있거나, Cursor를 인라인 편집기로 쓰고 Claude Code를 터미널에서 대형 작업·아키텍처·테스트 생성에 병행하는 경우라면 두 파일을 모두 관리하는 게 자연스럽습니다.

---

 

Cursor Rules와 CLAUDE.md 동시 관리 전략 3가지

AGENTS.md 공통 기반으로 Cursor Rules와 CLAUDE.md를 함께 관리하는 폴더 구조 다이어그램

전략 1: 독립 유지

각 파일을 별도로 관리하되, 내용의 약 90%를 동일하게 유지하고 도구별 특화 기능만 분리합니다. 가장 단순한 방법이에요.

전략 2: AGENTS.md 공통 기반 활용

2026년 신흥 표준으로 AGENTS.md(Linux Foundation, 60,000+ 레포 사용)가 부상하고 있습니다. 공통 지침을 AGENTS.md에 두고, CLAUDE.md에서 @AGENTS.md로 임포트하고, Cursor Rules의 base.mdc에도 핵심 내용을 가져오는 방식입니다.

# CLAUDE.md
@AGENTS.md

## Claude Code 전용
billing 디렉터리 변경 시 플랜 모드 사용.

중복 업데이트가 줄어드는 게 장점입니다. 참고로 Claude Code의 /init 명령어를 실행하면 기존 .cursorrules나 AGENTS.md 내용을 읽어서 CLAUDE.md 생성에 활용해줍니다.

전략 3: pre-commit 훅으로 동기화

소스 파일 하나를 유지하고 커밋 전 자동으로 각 형식으로 내보내는 방식. 개발 팀 규모가 크거나 파일 관리를 자동화하고 싶을 때 적합합니다.

---

 

FAQ

Q. .cursorrules를 아직 쓰고 있는데, .mdc로 꼭 바꿔야 하나요?

Agent 모드를 사용하지 않는다면 단기적으로는 괜찮습니다. 하지만 Cursor의 공식 권장은 2025년부터 .mdc 방식이고, Agent 모드에서 .cursorrules가 완전히 무시되는 건 실제로 꽤 치명적입니다. 마이그레이션하는 편이 낫습니다.

Q. Cursor를 쓰면서 Claude Code 확장도 같이 쓰는데, CLAUDE.md를 Cursor Rules처럼 쓸 수 있나요?

Cursor 에디터에서 Claude Code 확장을 쓰는 경우 .cursor/rules/와 CLAUDE.md를 동시에 가지는 설정을 운용하는 개발자들이 있습니다. 각 시스템이 자신의 파일만 읽기 때문에 충돌은 없습니다.

Q. AGENTS.md를 공통 기반으로 쓰면 Cursor Rules와 CLAUDE.md를 다 대체할 수 있나요?

대체는 어렵습니다. AGENTS.md가 아직 Claude Code와 Cursor의 특화 기능을 완전히 대체하지 못합니다. CLAUDE.md의 Auto Memory, Cursor Rules의 4가지 활성화 모드 같은 기능은 도구별 파일을 써야만 쓸 수 있습니다. AGENTS.md는 공통 기반, 도구별 파일은 그 위에 올리는 레이어로 보는 게 현실적입니다.

---

 

지금 바로 해볼 것

둘 중 하나만 쓰고 있다면 지금 어떤 방식인지부터 점검해봐요. 특히 .cursorrules를 쓰고 있다면 Agent 모드에서 규칙이 먹히는지 확인해보는 게 먼저입니다. Cursor와 Claude Code를 병행한다면 전략 2(AGENTS.md 공통 기반)를 한 번 시도해볼 만합니다. 공통 지침을 한 곳에 관리하는 것만으로도 중복 업데이트 부담이 확 줄어듭니다.

각 파일의 상세 설정 방법이 궁금하다면 [cursorrules 가이드]나 [Claude Code CLAUDE.md 완벽 가이드 2026]도 참고해보세요.