Cursor 업데이트 — .mdc 룰과 슬래시 명령어 완벽 가이드

요즘 개발자들의 필수 도구로 자리 잡은 AI 코드 에디터, Cursor에 큰 변화가 생겼습니다. 기존의 베타 기능이었던 커스텀 모드가 사라지고, 대신 훨씬 가볍고 유연한 .mdc 규칙과 커스텀 슬래시 명령어 체계가 공식적으로 자리를 잡았는데요. 이번 글에서는 내 개발 스타일에 딱 맞춘 규칙을 세팅해 불필요한 토큰 낭비는 줄이고 코딩 속도는 올리는 실전 노하우를 쉽고 빠르게 정리해 드릴게요!

사라진 커스텀 모드, 이제는 .mdc 룰과 슬래시 명령어로

Cursor를 애용하던 분들이라면 최근 업데이트 이후 조금 당황하셨을지도 모릅니다. 유용하게 쓰던 '커스텀 모드' 기능이 깔끔하게 사라졌기 때문인데요. Cursor 개발 팀은 복잡한 화면을 직관적으로 정리하고, AI가 도구를 쓸 때 대화 맥락인 컨텍스트를 불필요하게 낭비하는 문제를 해결하기 위해 이 기능을 과감히 제외했습니다.

하지만 아쉬워할 필요는 전혀 없습니다. 기존의 무거웠던 커스텀 모드 대신, 이제는 프로젝트 폴더 안에 가벼운 설정 파일 몇 개만 배치해 두면 AI의 행동 방침을 훨씬 정교하게 제어할 수 있습니다. 바로 새롭게 표준으로 자리 잡은 .mdc 규칙과 커스텀 슬래시 명령어 체계 덕분입니다.

이 새로운 방식은 현재 작업 중인 코드 파일에 꼭 필요한 규칙만 자동으로 골라 적용하기 때문에 토큰 소모를 획기적으로 줄여줍니다. 내 개발 환경에 딱 맞춰 작동하는 '가볍고 똑똑한' 맞춤형 AI 비서를 파일 몇 개로 뚝딱 구현하는 셈이죠. 그럼 이 강력한 도구들을 어떻게 활용하는지 구체적으로 살펴보겠습니다.

토큰 낭비 잡는 .mdc 룰 작성 가이드

개별적인 규칙을 지정할 때는 프로젝트 폴더의 .cursor/rules 디렉토리에 확장자가 .mdc인 마크다운 파일을 생성하면 됩니다. 이 파일의 핵심은 본문 시작 전에 적는 YAML 형식의 설정 정보입니다. 여기에 규칙의 설명과 작동 범위를 명확하게 지정해 주어야 합니다.

가장 주의해야 할 점은 무분별하게 규칙을 상시 적용하는 행동입니다. 50줄 정도 되는 평범한 규칙 하나가 매 대화마다 최대 400개에 달하는 토큰을 소모합니다. 만약 이런 규칙 수십 개를 모든 질문에 무조건 적용하도록 설정해 두면, 질문 한 번에 수만 개의 토큰이 눈 깜짝할 사이에 낭비되어 요금 폭탄을 맞을 수 있습니다.

특정 폴더나 파일 확장자에서만 규칙이 알아서 켜지도록 작동 범위를 제한하는 설정 방법을 소개합니다.

---
description: "Next.js App Router 컴포넌트 및 Tailwind 스타일 가이드"
globs: ["app/**/*.ts", "app/**/*.tsx"]
alwaysApply: false
---

- 새 컴포넌트는 기본적으로 React 서버 컴포넌트로 작성하세요.
- 클라이언트 상태가 필요할 때만 파일 최상단에 'use client'를 추가합니다.
- Tailwind CSS 클래스를 다룰 때는 가독성을 최우선으로 고려하세요.

이렇게 globs 옵션을 활용해 규칙이 필요한 파일 경로를 명시하면 설정이 끝납니다. 이제 AI가 해당 경로의 파일을 수정할 때만 이 규칙을 참고하므로, 토큰 낭비를 획기적으로 줄이면서 똑똑하게 코딩 지시를 내릴 수 있습니다.

내 입맛대로 만드는 슬래시 명령어

매번 AI 채팅창에 "이 코드 리뷰해줘"라거나 "테스트 코드를 작성해줘"라고 길게 타이핑하는 것은 은근히 귀찮은 일입니다. 이럴 때 아주 유용하게 쓸 수 있는 기능이 바로 커스텀 슬래시 명령어입니다. 채팅창에서 슬래시 기호만 입력하면 자주 쓰는 나만의 프롬프트 템플릿을 곧바로 불러와 실행할 수 있습니다.

사용 방법은 정말 간단합니다. 프로젝트 폴더 안에 .cursor/commands 폴더를 만들고, 그 안에 원하는 명령어 이름으로 마크다운 파일을 생성해 저장하면 됩니다. 예를 들어 코드 리뷰를 돕는 /review 명령어를 만들고 싶다면 다음과 같이 마크다운 파일을 작성해 둡니다.

.cursor/commands/review.md 파일 예시:

# 코드 리뷰 실행

전달된 코드의 가독성, 성능, 보안성을 꼼꼼하게 분석해 주세요.

## 체크리스트
- 예상치 못한 버그나 예외 처리가 누락된 부분이 있는지 확인해 주세요.
- 코드의 성능을 개선할 수 있는 리팩토링 제안을 포함해 주세요.
- 더 깔끔하게 작성할 수 있는 모던한 문법을 추천해 주세요.

이렇게 파일을 저장하고 나면 채팅창에 /를 입력하는 순간 우리가 만든 명령어가 목록에 나타납니다. 마우스 클릭이나 키보드 엔터 한 번으로 복잡한 프롬프트가 즉시 실행되는 것이죠. 반복되는 분석이나 피드백 작업이 있다면 지금 바로 나만의 슬래시 명령어로 등록해 일하는 속도를 높여보세요.

여러 AI를 쓴다면? AGENTS.md 파일 하나로 통일하자

요즘은 Cursor뿐만 아니라 Claude Code나 GitHub Copilot 같은 다양한 AI 코딩 도구를 혼합해서 쓰는 개발자가 늘고 있습니다. 이때 가장 큰 고민거리는 각 도구마다 제각각인 설정 파일입니다. Cursor용 규칙, Claude용 CLAUDE.md 등을 따로 관리하다 보면 규칙이 조금만 바뀌어도 모든 파일을 일일이 찾아가 수정해야 하고, 자칫 수정에서 누락된 도구가 엉뚱한 코드를 짜는 문제가 발생합니다.

이러한 비효율을 해결하기 위해 등장한 영리한 해결책이 바로 AGENTS.md 파일입니다. 모든 AI 도구가 공통으로 지켜야 할 기술 스택, 코딩 컨벤션, 빌드 및 테스트 명령어 등을 이 파일 하나에 모두 모아두는 것이죠. 말 그대로 프로젝트의 단일 진실 공급원을 세우는 작업입니다.

공통 규칙을 모았다면, 개별 도구 전용 파일에서는 복사 붙여넣기 대신 골뱅이 기호(@)를 활용한 불러오기 어노테이션을 사용해 간편하게 연결할 수 있습니다.

예를 들어, Claude Code 설정 파일인 CLAUDE.md를 다음과 같이 작성해 연결합니다.

@AGENTS.md

## Claude Code Specifics
- 결제 관련 모듈을 수정할 때는 항상 플랜 모드로 시작할 것.

이렇게 첫 줄에 @AGENTS.md를 적어두면 AI 도구가 필요한 공통 규칙을 알아서 불러옵니다. 덕분에 중복으로 규칙을 관리하며 아까운 토큰을 두 번 낭비할 필요가 없고, 어떤 코딩 비서를 쓰더라도 늘 일관성 있고 정확한 가이드를 받을 수 있게 됩니다.

나만의 똑똑한 AI 코딩 환경 만들기

이제는 새롭게 바뀐 마켓플레이스 덕분에 규칙 설정부터 다양한 도구 연동까지 한자리에서 정말 쉽게 관리할 수 있습니다. 오늘 소개해 드린 규칙 설정을 활용해 불필요한 토큰 낭비는 확실하게 줄이고, 내 개발 스타일에 맞게 작업 속도를 높여보세요.

지금 바로 가장 자주 쓰는 프로젝트 폴더에 가벼운 규칙 파일 하나를 만들어보는 것부터 시작해 보면 어떨까요? 나에게 딱 맞춰진 똑똑한 AI 비서가 코딩을 돕는 든든한 경험을 직접 느껴보실 수 있을 겁니다.