CLAUDE.md가 뭔가요?

내용

📌 CLAUDE.md 핵심 개념

• 위치: 프로젝트 루트 폴더에 CLAUDE.md 파일로 저장
• 읽는 시점: Claude Code 세션 시작 시 자동 로드
• 역할: "이 프로젝트에서 어떻게 행동해야 하는가"를 정의

✅ 담아야 할 내용
  - 절대 하면 안 되는 것 (금지 명령어, 건드리면 안 되는 파일)
  - 작업 전 반드시 거치는 절차
  - 이 프로젝트만의 규칙 (남들과 다르게 하는 것)
  - 코드 컨벤션 (네이밍, 폴더 구조)

⚠️ 효과를 재본 연구가 있습니다 — 결과가 기대와 다릅니다

ETH Zurich·LogicStar.ai 연구진이 실제 저장소 과제로 재봤습니다
(2026-02, arXiv 2602.11988).

  맥락 파일을 주는 것이 성공률을 대체로 높이지 못했고,
  추론 비용은 평균 20% 넘게 늘었다

여러 모델과 여러 코딩 에이전트에서 같았고,
AI가 만든 파일과 사람이 직접 쓴 파일 모두에서 같았습니다.

📌 그런데 안에서 갈렸습니다 — 이게 실무에 쓸 부분
  지시문은 잘 따랐습니다
  저장소 개요는 도움이 안 됐습니다 — 모델 제공사들이 권하는데도

즉 "우리 프로젝트는 무엇을 하는 곳이고 기술 스택은 이렇다"류의
설명은 넣어도 별로였고, "이건 하지 마라" "이 순서로 해라" 같은
지시는 값을 했다는 뜻입니다.

📌 그래서 이렇게 쓰세요
① 개요는 짧게. 길게 쓸 이유가 없습니다
② 지시문 위주로. 금지·절차·이 프로젝트만의 규칙
③ 넣기 전과 후를 실제 작업으로 비교해 보세요
   연구진의 결론도 "성능을 올리려는 시도는 배포 전에
   엄밀하게 검증하라"입니다

⚠️ 이 연구 하나로 단정하지 마세요
   특정 과제 모음에서 잰 평균입니다.
   프로젝트마다 다를 수 있으니 내 작업으로 확인하는 것이 맞습니다.

⚠️ CLAUDE.md 는 강제 설정이 아니라 맥락입니다
   반드시 막아야 하는 것은 hook 으로 처리하세요.

궁금한 점: {{INPUT}}