claude/rules 활용

10 Jun 2026 | claude

.claude/rules/ 디렉토리

rules 디렉토리는 경로 기반 컨텍스트 주입 기능을 제공
CLAUDE.md는 프로젝트 전체에 적용되는 설정
rules는 특정 파일이나 디렉토리에서 작업할 때만 자동 활성화 됨

`.claude/rules/api-route.md` 예시

아래 규칙은 /src/network/api 아래의 TypeScript 파일 작성시만 적용됨
작업시 필요한 규칙만 로딩되어, 효율적으로 토큰을 관리할 수 있음

---
paths:
  - "src/network/api/**/*.ts"
---

# API 개발 규칙

## 응답 형식

모든 API는 다음 형식으로 응답한다.

{
"success": boolean,
"data": any | null,
"error": string | null
}

## 에러 처리

- 비즈니스 로직 에러: 500번대
- 서버 에러: 500번대
- 클라이언트 에러: 400번대
- 모든 에러는 AppError 클래스로 래핑

## 인증

- 인증 필요 라우트는 authMiddleware 적용 필수
- 권한 체크는 checkPermission 미들웨어 사용

## 유효성 검사

- 모든 입력은 zod 스키마로 검증
- 스키마 파일은 src/schemas/에 위치