🚀가이드

Claude Code를 시니어 개발자처럼 만드는 CLAUDE.md 설정법

프로젝트 루트에 CLAUDE.md 파일 하나로 AI 에이전트를 시니어 개발자처럼 작동하게 만드는 방법

↗ 원본 링크

#Claude#AI코딩#CLAUDE.md#바이브코딩

CLAUDE.md란?

Claude Code가 세션 시작 시 자동으로 읽는 행동 규칙집입니다. 프로젝트 루트에 이 파일 하나만 만들면, AI가 매번 시니어 개발자처럼 체계적으로 작업합니다.

설정 방법

1.프로젝트 루트에 CLAUDE.md 파일 생성

2.아래 핵심 규칙들을 복사해서 붙여넣기

3.끝! Claude Code가 자동으로 읽어서 적용합니다

핵심 규칙 6가지

1. 플랜 모드 기본값

▸복잡한 작업(3단계 이상)은 반드시 계획부터 수립

▸문제 발생 시 즉시 중단하고 재계획

▸무작정 밀어붙이지 않음

2. 서브에이전트 활용

▸리서치와 탐색 작업은 서브에이전트에 위임

▸메인 컨텍스트를 깨끗하게 유지

▸서브에이전트당 하나의 작업만 집중

3. 자기개선 루프

▸실수할 때마다 `tasks/lessons.md`에 패턴 기록

▸같은 실수 반복 방지

▸세션 시작 시 과거 레슨 검토

4. 완료 전 검증

▸작동 증명 없이는 완료 표시 금지

▸"시니어 엔지니어가 승인할까?" 자문

▸테스트 실행과 로그 확인 필수

5. 우아함 추구

▸"더 나은 방법은 없을까?" 항상 고민

▸임시방편 수정 지양

▸단, 간단한 작업은 과잉 설계 금지

6. 자율 버그 수정

▸버그 리포트 받으면 바로 수정

▸일일이 지시 기다리지 않음

▸CI 실패 테스트도 자동으로 해결

태스크 관리 워크플로우

markdown

1. tasks/todo.md에 체크리스트 작성
2. 구현 전 계획 검증
3. 진행하면서 완료 표시
4. 각 단계별 요약 제공
5. 결과 문서화
6. 실수는 lessons.md에 기록

핵심 원칙

▸

단순함 우선: 최소한의 코드로 최대 효과

▸

게으름 금지: 근본 원인 해결, 임시방편 No

▸

최소 영향: 필요한 부분만 변경, 새 버그 도입 금지

효과

한 번 설정하면 Claude Code가:

▸체계적으로 계획하고 실행

▸실수를 학습하고 개선

▸시니어 개발자 수준의 판단력 발휘

▸자율적으로 문제 해결

바이브코딩을 하고 있다면 지금 바로 CLAUDE.md를 만들어보세요!