강의

멘토링

로드맵

인프런 커뮤니티 질문&답변

Zzang Shin님의 프로필 이미지
Zzang Shin

작성한 질문수

클로드 코드 완벽 마스터: AI 개발 워크플로우 기초부터 실전까지

프로젝트 초기화 (/init) 및 기본 사용법

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

작성

·

211

0

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


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

 

예시)

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

답변 3

0

짐코딩님의 프로필 이미지
짐코딩
지식공유자

안녕하세요! 🙂

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

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

# 공통 규칙

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

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

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

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

0

Zzang Shin님의 프로필 이미지
Zzang Shin
질문자

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

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

 

짐코딩님의 프로필 이미지
짐코딩
지식공유자

안녕하세요! 🙂

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

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

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

# 공통 규칙

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

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

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

0

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

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

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

Zzang Shin님의 프로필 이미지
Zzang Shin

작성한 질문수

질문하기