inflearn logo
강의

Course

Instructor

Mastering Claude Code: From AI Development Workflow Basics to Real-World Practice

Project Initialization (/init) and Basic Usage

claude에서 사용될 공통 CLAUDE.md 파일에 대한 질문

508

Zzang Shin

6 asked

0

프로젝트 폴더 별 CLAUDE.md 파일이 아닌
실행되는 claude에서 적용될 CLAUDE.md 파일은
claude 폴더내에 지정하는것으로 알고있습니다.


현재 개발자로써 공통으로 쓸만한 CLAUDE.md 파일의 예시가 있을까요?

 

예시)

프로젝트별 /init 명령어를 통해 claude.md 파일 생성시 한글로 작성해줘. 나 기본 구조에 대해서 작성해줘.

react next.js cursor tailwindcss claude 지금-베스트

Answer 3

0

gymcoding

안녕하세요! 🙂

좋은 질문이에요. 말씀하신 것처럼 user scope의 CLAUDE.md~/.claude/CLAUDE.md 경로에 만들어두시면 모든 프로젝트에 공통으로 적용됩니다.

공통 CLAUDE.md에는 "모든 프로젝트에서 항상 지켜줬으면 하는 규칙"을 넣어두시면 되는데, 예를 들면 이런 내용들이에요.

# 공통 규칙

- 모든 응답과 주석은 한국어로 작성
- 커밋 메시지는 한국어로 작성
- OS: Windows (명령어나 경로 안내 시 Windows 기준으로 작성)
- 코드 변경 전 반드시 기존 코드 구조 파악 후 작업
- 변경사항이 큰 경우 사전에 계획을 먼저 공유
- 에러 발생 시 원인 분석을 먼저 설명한 후 수정

OS 정보는 꼭 넣어두시는 걸 추천드려요. 클로드 코드가 기본적으로 Unix/macOS 기준으로 응답하는 경우가 있어서, Windows를 명시해두시면 경로 구분자(\ vs /)나 터미널 명령어 같은 부분에서 혼선을 줄일 수 있습니다.

이건 어디까지나 예시이고, 본인의 개발 스타일이나 선호하는 작업 방식에 맞게 자유롭게 수정하시면 됩니다. 클로드 코드를 쓰시면서 "이건 매번 말하기 귀찮다" 싶은 것들을 하나씩 추가해 나가시는 게 가장 실용적이에요 🙂

참고로 프로젝트별 CLAUDE.md(프로젝트폴더/CLAUDE.md)에는 해당 프로젝트의 기술 스택이나 폴더 구조 같은 프로젝트 고유 정보를 넣어두시면, 공통 규칙과 함께 적용되어서 효율적으로 관리하실 수 있습니다 🙏

0

Zzang Shin

프로젝트에서 /init 만 쓸경우 영문으로 작성이 되던데, 말씀주신대로 공통claude.md 파일에 /init 을 사용하여 한글로 작성해줘. 라고 지정하면

프로젝트에서 /init 만 써도 한글로 프로젝트의 claude.md 파일을 작성해주나요?

 

0

gymcoding

안녕하세요! 🙂

네, 맞습니다. 공통 CLAUDE.md에 한국어 작성 규칙을 넣어두시면 /init 실행 시에도 한글로 프로젝트 CLAUDE.md를 생성해줄 거예요.

다만 LLM 특성상 100% 보장은 어렵기 때문에, 혹시 영문으로 생성되는 경우에는 두 가지 방법을 시도해보세요.

먼저 공통 CLAUDE.md에서 한국어 규칙을 좀 더 강조해서 작성해보세요. 예를 들면 이렇게요.

# 공통 규칙

## 중요: 언어 설정
- 모든 응답, 주석, 문서 작성은 반드시 한국어로 작성
- /init 으로 CLAUDE.md 생성 시에도 한국어로 작성

이렇게 별도 섹션으로 분리하고 "중요", "반드시" 같은 키워드를 넣어두시면 좀 더 잘 반영됩니다.

그래도 영문으로 생성되는 경우에는 /init 한글로 작성해줘 이렇게 직접 붙여서 실행하시면 확실해요 🙂

0

communityai8509

안녕하세요, 인프런 AI 인턴입니다. Zzang Shin님.

CLAUDE.md 파일은 각 프로젝트 폴더 별로 생성되는 것이 일반적이지만, 공통으로 사용할 수도 있습니다. 주로 프로젝트 전반에 걸쳐 일관된 코드 스타일이나 빌드, 배포 가이드를 설정할 때 유용합니다. 예를 들어, 모든 프로젝트에 적용할 기본 가이드라인을 작성해두고 각 프로젝트에서 이를 참고하거나 확장하는 방식입니다.

공통 CLAUDE.md 파일 예시

아래는 공통으로 사용할 수 있는 CLAUDE.md 파일의 예시입니다:

# CLAUDE.md

## 프로젝트 기본 설정
- `npm install` 또는 `yarn install` 명령어로 필수 패키지를 설치해주세요.
- 프로젝트는 기본적으로 `React`와 `Next.js`를 사용합니다.

## 스타일 가이드
- 코드 스타일은 `ESLint`와 `Prettier`를 따릅니다.
- 모든 변수명은 camelCase로 작성합니다.

## 빌드 및 배포
- `npm run build` 명령어로 빌드를 수행하세요.
- 배포는 `Vercel`을 이용하며, `main` 브랜치에 머지되면 자동으로 배포됩니다.

## 기타
- 프로젝트 생성 시 `/init`를 사용하여 `CLAUDE.md` 파일을 한글로 생성해 달라고 요청하세요.

이러한 포맷으로 CLAUDE.md 파일을 작성하면, 다양한 프로젝트에서 공통적으로 사용할 수 있는 지침을 가지고 시작할 수 있습니다. 각 프로젝트의 특성에 따라 이 공통 파일을 복사한 후, 필요한 부분을 프로젝트에 맞게 수정하여 사용할 수 있습니다.

관련된 질문과 답변으로 아래 게시물을 참고해 보시면 도움이 될 것입니다:

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

API 400알람 관련문의

0

4

1

사이트가 너무 달라요

0

18

1

next.js 설치

0

10

0

미션 제출하는 곳

0

9

0

답변이 다른 문제..

0

10

0

123강 질문

0

12

2

mcp서버 추가 후 setting.local.json

0

15

2

agents 관련 질문입니다!

0

21

1

plan 모드 결과에 대해

0

26

2

클로드 계정 변경

0

21

2

114강. Playwirght MCP 관련 질문

0

22

2

main 브랜치 develop 브랜치

0

19

2

수료증 질문 드립니다.

0

27

2

클로드코드 환경변수 설정

0

24

2

클로드코드 삭제 후 재설치

0

30

3

점점 매너리즘에 빠지게 됩니다..?

0

37

1

bash 명령어가 너무 많아요..

0

34

2

cursor화면이 좀 달라요 ㅜ

0

25

1

93~94강. 서브에이전트와 Shrimp Task Manager Plan과 차이

0

26

1

power shell에서는 claude가 정상 실행되는데, cursor terminal에서는 실행 에러 발생하네요.

0

22

2

live server, korean도 확장팩 검색이 되지 않습니다.

0

26

2

CLAUDE.local.md

0

26

2

유저 메모리 파일 관련 질문입니다!

0

22

2

55강 관련 질문(커밋이 완료되지 않을 때)

0

24

1