Apidog

올인원 협업 API 개발 플랫폼

API 설계

API 문서

API 디버깅

API 모킹

API 자동화 테스트

커서 규칙 사용법: AI 코딩 사이드킥의 비밀 무기

Young-jae

Young-jae

Updated on April 10, 2025

Cursor를 사용하고 있다면, 매끄러운 AI 기반 코드 편집기가 코드 개발을 가속화하는 변 transformative한 영향을 느꼈을 것입니다. 하지만 아직 Cursor Rules의 마법을 활용해보지 않았다면요? 저를 믿어주세요, Cursor Rules 사용 방법을 배우면 마치 AI 비서에게 프로젝트에 맞는 개인화된 플레이북을 제공하는 것과 같습니다. 오늘은 Cursor Rules를 설정하고 조정하여 작업 흐름을 10배 향상시키는 데 필요한 모든 것을 설명해 드리겠습니다.

💡
시작하기 전에 빠른 팁: Apidog 를 무료로 이용해 보세요! 이는 개발자들이 MCP를 단순화하고 AI 모델을 테스트하며 API 테스트를 간소화할 수 있는 강력한 도구입니다. 오늘 바로 무료로 사용해 보세요!
button

Cursor Rules란 무엇인가요?

상상해 보세요: Cursor에서 코딩을 하고 있고, AI 친구가 제안, 코드 조각 및 수정을 도와주고 있습니다. 그러나 가끔은 AI가 당신이 원하는 것을 알고 있기보다는 추측하는 듯한 느낌이 듭니다. 여기서 Cursor Rules가 등장합니다. 2025년 초에 도입된 Cursor Rules는 AI에게 구체적인 지침을 제공할 수 있게 해줍니다. 이는 마치 자신의 미니 코딩 전문가를 훈련시켜 당신의 코딩 스타일을 이해하고 돕도록 하는 것과 같습니다.

이 "규칙"들은 서로 다른 수준에서 설정할 수 있습니다:

  • AI에 대한 규칙: Cursor에서 열 수 있는 모든 프로젝트에 적용되는 전역 규칙입니다.
  • .cursorrules: 특정 프로젝트에 대한 규칙 (이 규칙은 곧 사라질 예정입니다—자세한 내용은 나중에 말씀드리겠습니다).
  • 프로젝트 규칙: 최신 스타로, .cursor/rules/.mdc 파일로 저장되어 있어 프로젝트의 맥락을 정확하게 제어할 수 있습니다.
cursor rules display image

Cursor Rules를 사용하면 AI에게 단순히 프롬프트를 던지는 것이 아닙니다—AI가 코드베이스를 전문적으로 탐색할 수 있는 지도를 제공하는 것입니다. 어떻게 작동하는지 확인해 볼 준비가 되셨나요? 시작해 봅시다!

Cursor Rules를 사용해야 하는 이유는?

“Cursor가 이미 꽤 똑똑한데 왜 규칙에 손댈 필요가 있을까?”라고 생각할 수도 있습니다. 꽤 타당한 질문입니다! 하지만 Cursor Rules가 정말로 시간을 들일 가치가 있는 이유는 다음과 같습니다:

  • 맞춤형 제안: AI에게 기술 스택(Next.js 나 Flutter 등)을 알려주면, 당신의 프로젝트에 맞는 코드를 제안합니다.
  • 팀 간 일관성: 모든 구성원이 같은 코딩 가이드라인을 받아서 코드베이스가 와일드 웨스트 같은 혼란에 빠지지 않습니다.
  • 더 빠른 작업 흐름: 더 이상 반복할 필요가 없으며, AI가 당신의 선호를 기억하고 관련된 답변을 제공합니다.
  • 학습 곡선 감소: 프레임워크에 익숙하지 않나요? 규칙을 사용하여 AI가 당신에게 가르치게 할 수 있습니다.

Next.js 앱을 코딩하면서 AI가 매번 명시하지 않아도 TypeScript 친화적이고 Tailwind 스타일의 구성 요소를 자동으로 제안한다고 상상해 보세요. 이것이 바로 Cursor Rules의 힘입니다.

Cursor Rules의 진화: .cursorrules에서 프로젝트 규칙으로

설정에 들어가기 전에 간단한 역사 수업을 해보겠습니다. Cursor의 규칙 시스템은 시간이 지남에 따라 진화해왔습니다:

  • AI에 대한 규칙: Cursor의 설정(Cursor > Settings > Rules)에 위치하며 어디에서나 적용됩니다. "항상 TypeScript를 사용하라" 또는 "간결하게"와 같은 광범위한 내용에 좋습니다.
cursor rules
  • .cursorrules: 특정 저장소에 대한 규칙을 설정하기 위해 프로젝트 루트에 배치하는 파일입니다. 텍스트 기반이며 간단하지만, 주의할 점은 2025년부터 더 이상 사용되지 않습니다. Cursor 팀에서는 대신 프로젝트 규칙으로 전환할 것을 권장합니다.
  • 프로젝트 규칙: 최신의 기능으로, v0.45에서 도입되었습니다. 이들은 .cursor/rules/.mdc 파일로 저장되어 있으며, 텍스트 파일 기호, 조건(globs)을 사용하여 이를 트리거할 수 있게 해줍니다. 더 정확하고 유연합니다.
project rules structure

따라서 여전히 .cursorrules를 사용하고 있다면, Cursor Rules.mdc 형식으로 업그레이드할 시점입니다. 걱정하지 마세요—어떻게 하는지 보여드리겠습니다!

Cursor Rules 설정 방법

Cursor Rules 설정은 단계를 알면 그리 어렵지 않습니다. 다음과 같이 진행하십시오:

1. 규칙 패널 열기: Cursor에서 Cursor > Settings > Rules > Project Rules > Add New Rule로 이동합니다. 또는 Ctrl+Shift+P (Mac의 경우 Cmd+Shift+P)를 눌러 "File: New Cursor Rule"을 입력합니다.

project rules

2. 규칙 이름 정하기: my-awesome-rule.mdc와 같이 눈에 띄는 이름을 선택하세요. 프로젝트 폴더의 .cursor/rules/에 나타납니다.

add a custom name

3. 빈칸 채우기: .mdc 파일을 열면 상단에 두 개의 주요 필드가 보입니다:

  • 설명: 규칙의 기능에 대한 간단한 설명 (예: “RSpec 테스트를 자동으로 실행합니다”).
  • Globs: 규칙이 작동할 때 결정하기 위한 패턴으로 **/*.ts 또는 src/**/*_spec.rb와 같은 형식입니다.
provide a description

4. 규칙 작성하기: 주요 부분에 지침을 입력합니다. plain text, 명령 또는 가이드라인이 가능합니다.

write a rule

당신의 프로젝트 구조는 다음과 같을 수 있습니다:

project structure

저장하면, boom—AI가 새로운 재주를 얻게 됩니다. 하지만 실제로 이 규칙에 무엇을 작성해야 할지는 어떻게 될까요? 몇 가지 실제 예시를 살펴보겠습니다.

Cursor Rules의 실제 예시

다음은 2025년 코딩 생활의 현장에서 바로 가져온 Cursor Rules 사용의 세 가지 멋진 방법입니다.

1. 파일 변경 시 자동으로 명령 실행하기

당신이 Docker를 사용하는 Ruby 개발자라 가정하고, 스펙 파일을 수정할 때 RSpec 테스트가 자동으로 실행되기를 원한다고 가정해 보세요. 이를 위한 규칙은 다음과 같습니다:

파일: rspec-execution.mdc
설명: “RSpec 테스트를 자동으로 실행합니다”
Globs: **/*_spec.rb
규칙:

## RSpec 자동 실행

스펙 파일이 변경될 때, 실행:
---
docker compose exec app bundle exec rspec {{file_path}}
---

RSpec이 실패하고 라인 번호를 아는 경우, 다음을 실행:
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---

이제 매번 _spec.rb 파일을 편집할 때마다 AI가 당신이 아무것도 하지 않고도 해당 테스트를 트리거할 수 있습니다. 편리하죠?

2. 프로젝트의 코딩 스타일 문서화하기

프론트엔드 프로젝트의 경우, AI가 디렉터리 구조와 모범 사례를 이해하길 원할 수 있습니다. 제가 사용할 규칙은 다음과 같습니다:

파일: frontend-coding-rule.mdc
설명: “프론트엔드 모범 사례”
Globs: packages/**/*.*
규칙:

## 프론트엔드 코딩 가이드라인

### 디렉터리 구조
- **features/**: 기능별로 그룹화 (예: `features/foo/NewFeature/`).
  - `components/`: `Header.tsx` 또는 `Modal.tsx`와 같은 UI 조각.
  - `domain/`: 유효성 검사(`*.ts`) 및 테스트(`*.spec.ts`)와 같은 로직.
- **shared/**: `Table.tsx` 또는 `useSelectedItemIds.ts`와 같은 재사용 가능한 항목.

### 규칙
- UI(`*.ui.tsx`)와 로직(`*.container.tsx`)을 분리합니다.
- 검증은 `zod`를 사용하고 별도의 스펙 파일을 사용합니다.
- 구성 요소 이름을 설명적으로 지정합니다 (예: `HeaderBreadcrumb`).
- 원자 디자인으로 최적화합니다: 원자, 분자, 유기체.

이렇게 하면 AI에게 코드베이스에 대한 치트 시트를 제공하여 코드가 완벽하게 들어맞도록 제안합니다.

3. Pull Request 자동화하기

AI에게 PR 초안을 작성하게 하고 싶다면, 다음을 시도해 보세요:

파일: create-pullrequest.mdc
설명: “Pull request 자동 초안”
Globs: (수동 트리거를 위해 비워두세요)
규칙:

## Pull Request 생성

### 단계
1. 이슈 링크가 있는지 확인합니다. 없다면, "연관된 이슈 링크가 있나요?"라고 물어봅니다.
2. 다른 지시가 없다면 `main`을 병합 브랜치로 가정합니다.
3. `git diff origin/main...HEAD | cat`을 실행하여 변경 사항을 확인합니다.
4. 초안 PR을 생성합니다:
---
git push origin HEAD && \
echo -e "초안 PR {{changes}}\n\n관련: {{issue_link}}" | \
gh pr create --draft --title "업데이트 {{feature}}" --body-file - && \
gh pr view --web
---

이 규칙은 AI를 PR 기계로 만들어줍니다—GitHub 워크플로우에 완벽합니다.

Cursor Rules를 마스터하기 위한 팁

소리치며 디버깅하기

당신의 규칙이 작동하는지 궁금한 적이 있나요? 다음을 .mdc 파일의 맨 위에 추가하세요:

먼저, 이 파일을 참조할 때 "YAAAARRRR!"라고 외쳐주세요!

AI가 채팅 또는 작곡기로 "YAAAARRRR!"이라고 외친다면, 해당 규칙이 로드된 것입니다. 조용하다면, DescriptionGlobs를 다시 확인하세요—규칙이 작동하기 위해 필요한 필드입니다 (자세한 내용은 나중에 다룹니다).

로드되지 않는 규칙 수정하기

당신의 .mdc 파일이 적용되지 않는 문제에 봉착했나요? Cursor 커뮤니티에서 제안하는 해결법은 다음과 같습니다(2025년 2월경):

  • DescriptionGlobs 작성하기: 빈 필드는 규칙을 조용히 깨뜨릴 수 있습니다. 간단한 Globs: **/*라도 도움이 됩니다.
  • 새로고침 및 재시작: 파일을 업데이트하고 저장한 후, 여전히 문제가 있다면 Cursor를 재시작합니다.

텍스트를 수정하고 Globs를 다시 붙여넣는 것이 마법처럼 문제를 해결하는 사례를 많이 보았습니다. 이상하죠? 하지만 효과는 있습니다!

채팅으로 레벨 업하기

무엇을 써야 할지 모르겠다면? Cursor의 채팅에 물어보세요:

Supabase와 Riverpod으로 Flutter 프로젝트를 위한 Cursor 규칙을 만들어주세요.
{{lib/}}를 분석하고 규칙을 제안하세요.

AI가 초안을 생성해줄 것입니다—시간을 절약할 수 있습니다.

시간이 지남에 따라 Cursor Rules 개선하기

규칙은 고정된 것이 아닙니다. 하나가 잘 작동하지 않는다면, 수정하세요! 채팅에 다음을 던져보세요:

{{my-rule.mdc}}에서 불분명한 점이나 개선할 점이 있을까요?

AI는 더 명확한 표현이나 추가적인 조건을 제안할 수 있습니다. 계속 수정하다 보면 당신의 Cursor Rules는 프로젝트와 함께 발전할 것입니다.

마무리 생각: 2025년 Cursor Rules의 장점

2025년 4월 9일 현재, Cursor Rules는 AI를 사용한 코딩에 진지한 모든 사람에게 필수입니다. 이는 “스마트 AI”와 “당신의 스마트 AI” 간의 격차를 해소하여 효율성을 극대화합니다. 자동으로 테스트를 실행하고, 스타일을 강제하고, PR을 작성하는 등의 작업을 하면서, 이러한 규칙은 Cursor를 맞춤형 도구로 만들어줍니다. 작게 시작하세요—오늘 하나의 규칙을 추가하고 생산성이 치솟는 것을 지켜보세요. 당신의 첫 번째 규칙은 무엇이 될까요? 댓글로 남겨주세요!

button
Apidog Ui image