도구

CLAUDE.md 생성기

AI 코딩 도구는 저장소에 둔 설정 파일을 읽고 그 규칙대로 일합니다. 아래에서 프로젝트 정보와 규칙을 고르면 Claude Code용 CLAUDE.md, 여러 도구가 함께 읽는 AGENTS.md, Cursor용 .cursor/rules/*.mdc — 세 형식 모두로 만들어 드립니다. 두는 위치는 형식마다 다르며, 각 형식을 고르면 어디에 둘지 안내합니다.

1단계프로젝트 소개

프로젝트 유형

기술 스택 (복수 선택)

2단계자주 쓰는 명령어 (아는 것만)

3단계작업 규칙

코드 스타일

금지사항

커밋 규약

추가 규칙 (자유 입력)

완성된 파일

# CLAUDE.md

## 프로젝트 개요
이 프로젝트 저장소다.

## 코드 스타일
- 새 코드는 주변 코드의 네이밍·구조·관용구를 따른다. 새로운 스타일을 도입하기 전에 기존 코드를 먼저 살핀다.
- 주석은 코드로 표현할 수 없는 의도·제약만 남긴다. 코드를 반복 설명하는 주석은 쓰지 않는다.

## 금지사항
- API 키·토큰·비밀번호·.env 파일을 절대 커밋하지 않는다.

프로젝트 최상위 폴더에 CLAUDE.md로 저장하세요. Claude Code가 세션 시작 때 읽습니다.

CLAUDE.md가 뭔가요?

Claude Code가 세션을 시작할 때 자동으로 읽는 프로젝트 안내서입니다. 프로젝트 구조, 자주 쓰는 명령어, 코드 스타일, 하지 말아야 할 것을 적어두면 AI가 매번 같은 걸 물어보지 않고 팀의 규칙대로 작업합니다. Codex 등 여러 도구가 함께 읽는 공통 규격으로는 AGENTS.md가 쓰입니다. Cursor는 프로젝트 최상위가 아니라 .cursor/rules/ 폴더 안의 .mdc 파일을 읽습니다 — 예전에 쓰던 최상위 .cursorrules 한 장은 Cursor 공식 문서에서 빠졌기에, 이 생성기는 현행 규격으로 만들어 드립니다. 내용은 거의 같아서 세 형식을 모두 만들어 줍니다.

잘 쓰는 요령

짧게 유지하세요. 규칙이 길수록 AI가 놓치는 규칙도 늘어납니다. 정말 지켜야 할 것만 담는 게 낫습니다.
“하지 마라”가 “해라”보다 잘 작동합니다. 특히 시크릿 커밋 금지, 새 의존성 임의 추가 금지 같은 금지선을 분명히 하세요.
명령어 섹션이 의외로 중요합니다. 테스트·빌드 명령을 적어두면 AI가 스스로 검증하고 제출합니다.
프로젝트가 바뀌면 파일도 갱신하세요. 낡은 규칙은 없는 것보다 나쁩니다.

섹션별로 무엇을 어떻게 적어야 하는지 실전 예시가 필요하면 CLAUDE.md 작성법 가이드를 함께 보세요.