AI중요도: 높음

CLAUDE.md 하나로 Claude Code 동작 90% 커스터마이징

r/GeminiAI2026년 6월 10일 · 9시간 전

CLAUDE.md 파일 하나를 프로젝트 루트에 두면 Claude Code가 코드를 작성하는 방식, 말투, 금지 행동 등을 한꺼번에 제어할 수 있다. 반복되는 불만 대부분이 이 파일 설정 하나로 해결된다는 사용자 경험이 공유됐다.

Claude Code는 AI가 실제로 코드를 작성·수정해 주는 도구인데, 기본 설정 그대로 쓰면 원하지 않는 방식으로 동작할 때가 많다. 예를 들어 주석을 너무 많이 달거나, 물어보지도 않고 파일을 바꾸거나, 설명을 장황하게 늘어놓는 식이다. CLAUDE.md는 프로젝트 폴더에 넣는 텍스트 파일로, Claude Code가 작업을 시작할 때 자동으로 읽어들인다. 이 파일에 '주석 달지 말 것', '파일 삭제 전 반드시 확인할 것', '응답은 짧게' 같은 규칙을 적어두면 Claude Code가 그 규칙을 따른다. 여러 사용자가 'God Mode'라고 부를 만큼 동작 방식을 폭넓게 바꿀 수 있다고 전했다.

핵심 포인트

  • CLAUDE.md 파일을 프로젝트 루트 폴더에 만들면 Claude Code가 자동으로 읽는다
  • 원하는 규칙을 자연어(보통 영어)로 적으면 AI가 그 규칙을 따른다
  • '주석 금지', '파일 삭제 전 확인', '짧은 응답' 같은 지시가 효과적이다
  • 여러 프로젝트마다 별도의 CLAUDE.md를 두면 프로젝트별 맞춤 설정이 가능하다
  • 홈 디렉터리(~/.claude/CLAUDE.md)에 두면 모든 프로젝트에 공통 적용된다

용어 한 줄 설명

CLAUDE.md
Claude Code에게 프로젝트 규칙과 작업 방식을 알려주는 안내 파일입니다.
사용자 경험
제품을 사용할 때 얼마나 편안하고 쉽게 사용할 수 있는지를 나타내는 느낌.
Go
빠르고 단순한 서버 프로그램을 만들 때 자주 쓰는 프로그래밍 언어입니다.

이 사건을 다룬 원문 (5)

원문 보기 ↗