검색어를 입력하세요...⌘K

CLAUDE.md — 내 AI 맞춤 설정

"항상 한국어로 답해줘" 같은 내 습관을 Claude에게 알려주는 파일이에요.

한 줄 요약

CLAUDE.md는 "Claude에게 붙여주는 포스트잇"이에요.
매번 "한국어로 답해줘", "파일명은 영어로 해줘" 이런 말 반복하기 귀찮잖아요?
이걸 파일에 한 번 적어두면, Claude가 매번 자동으로 읽고 기억해요.

자동으로 읽어요

대화 시작하면 알아서 읽어요. 매번 알려줄 필요 없어요.

그냥 텍스트예요

특별한 형식 없이 메모장처럼 적으면 돼요.

먼저 해보세요: 내 기본 습관 설정하기

제일 많이 쓰는 건 "내 컴퓨터 전체에 적용되는 설정"이에요.
한 번만 적어두면 어떤 폴더에서 Claude를 열든 항상 적용돼요.

1

터미널에서 파일 만들기

아래 명령어를 복사해서 터미널에 붙여넣으세요.

touch ~/.claude/CLAUDE.md && open ~/.claude/CLAUDE.md

Mac 기준이에요. 텍스트 편집기가 열리면 성공!

2

내가 원하는 규칙 적기

열린 파일에 아래처럼 적고 저장하세요. 원하는 내용을 자유롭게 수정해도 돼요.

~/.claude/CLAUDE.md (내 전체 설정)
# 내 Claude 설정

## 기본 규칙
- 항상 한국어로 답해줘
- 존댓말 대신 편한 말투로 해줘
- 설명은 짧고 핵심만

## 파일 작업
- 파일 이름은 영어로 만들어줘
- 파일 수정 전에 꼭 물어봐줘
- 결과물은 바탕화면에 저장해줘
3

끝! 이제 자동으로 적용돼요

다음에 Claude를 실행하면 이 설정을 자동으로 읽고, 내가 적은 규칙대로 동작해요.

이게 전부예요! 비개발자분은 여기까지만 해도 충분해요. 아래 내용은 "프로젝트별로 다른 규칙을 쓰고 싶을 때" 참고하세요.

이런 것도 적을 수 있어요

예시: 문서 작업 스타일

~/.claude/CLAUDE.md
# 내 Claude 설정

## 문서 스타일
- 보고서는 1장 분량으로 요약해줘
- 제목은 굵게, 소제목은 번호 매겨줘
- 전문 용어 쓸 때는 괄호로 쉬운 설명 넣어줘

## 번역
- 영어→한국어 번역 시 자연스러운 한국어로
- 고유명사는 번역하지 말고 영어 그대로 써줘

예시: 데이터 정리 습관

~/.claude/CLAUDE.md
# 내 Claude 설정

## 엑셀/데이터 작업
- 날짜 형식은 2026-01-01 (YYYY-MM-DD)로 통일
- 금액에는 천 단위 쉼표 넣어줘 (예: 1,000,000원)
- CSV 파일은 UTF-8로 저장해줘

## 파일 정리
- 결과 파일명: 원본이름_결과_날짜.확장자
- 예: 매출보고_요약_20260223.md

예시: 개발자용 프로젝트 규칙

프로젝트 폴더/CLAUDE.md
# 프로젝트 규칙

## 코딩 규칙
- TypeScript 사용, strict 모드
- 함수는 화살표 함수로
- 커밋 메시지는 한국어로

## 폴더 구조
- src/app/ — 페이지
- src/components/ — 공통 컴포넌트
- src/lib/ — 유틸리티 함수

심화: 여러 곳에 설정 파일 두기

CLAUDE.md는 세 곳에 둘 수 있어요. 여러 개를 동시에 쓸 수도 있고, 같은 내용이 겹치면 더 구체적인 위치에 있는 게 우선돼요.

위치경로언제 쓰나요?
추천! 내 컴퓨터 전체~/.claude/CLAUDE.md내 습관, 말투, 기본 규칙 (모든 작업에 적용)
특정 프로젝트만프로젝트폴더/CLAUDE.md이 프로젝트에서만 쓰는 규칙 (팀 공유 가능)
특정 하위 폴더만프로젝트/src/CLAUDE.md이 폴더에서만 쓰는 세부 규칙
팁: 대부분의 사용자는 "내 컴퓨터 전체" 설정 하나만 써도 충분해요. 프로젝트별로 다른 규칙이 필요할 때만 추가하면 돼요.

참고: 자동 메모리

CLAUDE.md 말고도, Claude는 대화하면서 배운 것을 자동으로 메모해둬요. "이거 기억해줘"라고 말하면 다음 대화에서도 기억하고 있어요.

CLAUDE.md (내가 적는 것)자동 메모리 (Claude가 적는 것)
누가?내가 직접 적어요Claude가 알아서 메모해요
뭘 적나요?내 규칙, 습관, 선호도대화에서 배운 것, 경험
어떻게?파일을 열어서 직접 수정"이거 기억해줘"라고 말하면 됨
쉽게 말하면: CLAUDE.md는 "내가 미리 써두는 지시서"이고, 자동 메모리는 "Claude가 대화하면서 스스로 적는 노트"예요. 둘 다 자동으로 읽혀요.

잘 쓰는 팁

짧고 핵심만

너무 길면 중요한 내용이 묻혀요. 한 줄에 하나씩, 핵심만 적으세요.

"해줘" 형태로 적으세요

"한국어" (X) → "항상 한국어로 답해줘" (O). Claude가 더 잘 이해해요.

안 되는 것도 적으세요

"파일을 물어보지 않고 삭제하지 마" 같은 금지 사항도 중요해요.

필요할 때 수정하세요

언제든 파일을 열어서 내용을 추가하거나 바꿀 수 있어요.