inflearn logo
강의

講義

知識共有

Claude Code 完全マスター:AI開発ワークフローの基礎から実践まで

プロジェクトの初期化 (/init) および基本使用法

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

404

Zzang Shin

投稿した質問数 6

0

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


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

 

예시)

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

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

回答 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 파일을 작성하면, 다양한 프로젝트에서 공통적으로 사용할 수 있는 지침을 가지고 시작할 수 있습니다. 각 프로젝트의 특성에 따라 이 공통 파일을 복사한 후, 필요한 부분을 프로젝트에 맞게 수정하여 사용할 수 있습니다.

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

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

max x5 플랜을 결제했습니다.

0

9

1

클로드 초기 설정

0

10

1

사용자 스코프 설정 파일 적용 문제

0

8

1

클로드코드 유료플랜 할인 방법이 있을까요?

0

22

0

API Error : 400 에러의 원인과 해결방법이 궁금합니다!!

0

17

2

퍼미션 권한 설정 문의

0

19

2

커서에서 shift+enter가 안됩니다.

0

20

2

mcp 설치를 못하겠어요

0

35

2

라이브러리 관련 질문 있습니다!

0

26

2

output-styles은 Claude Code의 공식 기능이 아니라고 하는데 혹시 변경된걸까요?

0

26

2

클로드 변경

0

26

2

/config 에서 output-style 을 변경

0

24

1

한국어 문제

0

28

2

Node.js 관련 질문드립니다.

0

29

3

클로드 버전업 설치

0

26

2

13강 프로젝트 생성 Next.js 설치이슈

0

25

3

Shell Command: Install 'cursor' command 진행에서 막혔습니다

0

26

3

[[공식 문서] 사고 연쇄 프롬프팅 링크에 해당 내용이 없어요

0

36

1

Agent team / subagent 생성시 재사용 가능 여부

0

32

2

shirimp task manager는 프로젝트 처음 시작 단계에서도 쓴는 것 과 관련해서 질문

0

26

2

MCP 서버 내용 변경

0

33

2

설치가 완료되었다고 하는데 왜 확인이 안될까요?ㅠ

0

32

3

맥에서 git이 설치되지 않아요...

0

26

2

ll 명령어 문의

0

22

2