Claude Code 로 코드 작업하기 : CLAUDE.md 작성 팁 ++ 예시 있음

안녕하세요 :) 트윅히입니다.

 

요즘 다시 새삼 클로드 코드가 너무너무 좋아졌다고 생각이 드는데요!!

오늘은 클로드 코드 잘 작성하는 방법이랑 md 설정 법에 대해서 알려드릴게요

 

 

다들 클로드 어플리케이션 다운 받아서 쓰고 계신가요?

다운 아직 안받으시고 웹(크롬이나 사파리로)으로 쓰고 계시다면 아래를 링크로 들어가 다운 받아주세요!!

https://claude.com/download 

Download Claude | Claude

 

다운 받은 후 세팅

로그인을 해주세요.

클로드 코드를 위한 글이니까 클로드 코드에 필요한 github 세팅도 해주세요.

 

.claude 폴더 및 CLAUDE.md 설정 방법

Claude Desktop을 설치하면, .claude 폴더가 자동으로 생성됩니다.!

.폴더는 기본적으로 숨김 처리가 되어 있기 때문에 맥의 경우 홈디렉토리로 가셔서

cmd + shift + .

을 입력하시면 숨겨진 폴더까지 보실 수 있습니다.

그 안에 CLAUDE.md 파일을 생성합니다. (꼭 이름이 대문자 CLAUDE 여야 합니다.!!)

이때 생성하는 CLAUDE.md는 모든 클로드의 최상위 명령어와 마찬가지이므로

세부적인 프로젝트 별의 지침은 각 repository 안에 위치해야 합니다.

 

Tip 1. 꼭 중요 지침만 적자.

최상의 CLAUDE.md는 모든 프로젝트를 관통하는 걸로 꼭 필요한 부분만 작성

이게 너무 길어지면 llm 효율도 떨어지고 성능도 떨어집니다.!

 

제 최상의 CLAUDE.md 예시를 보여드릴게요!! 이게 다들 중요하잖아요?

특히 저같이 기술 이것저것 쓰면서 데모도 만들고 테스트도 해보시는 분들.. 그거 맨날 언제 고쳐ㅠ

 

CLAUDE.md 예시

## 1. 코드 작성 규칙

- **절대 모킹하지 않기**: 실제 동작하는 코드만 작성
- **오버엔지니어링 금지**: 구현을 원하는 명확한 기능만 구현, 임의로 구현 금지, 오버해서 구현 금지. 
- **네이밍 규칙**: 기능을 명확히 나타내는 이름 사용
- **라이브러리** : 라이브러리의 경우 최신 버전 지향

### 2. 답변 규칙

- **묻는 거에만 답하기**: 내 경험과 연관시키지 말기, 묻는 거에만 답하기

 

 

실제로 제가 이용하고 있는 claude.md를 가져왔어요

제가 클로드를 쓰면서 제일 힘들었던 부분이 할루이제이션...

그냥 지멋대로 판단하고 내가 필요하지도 않는데 고치고, 내 경험이랑 연관 시켜서 또 고치고

이런 부분이 너무 피곤했거든요. 그래서 시키는 일만 하고 과장하지 않는 부분을 절대반지 처럼 주니까

(클로드에게 CLAUDE.md는 마치 절대반지ㅋㅋ)

제가 수정할 일이 많이 없고 시키는 것만 해서 너무너무 편하고 좋더라구요 생산성이 진심 5배 증가 된 느낌.

 

 

Tip2. 잘 설정했으면? 초기화를 잘 시켜주자.

클로드 코드로 들어가서 슬래쉬를 입력하게 되면 여러가지 명령어들이 있습니다.

좋은 것들이 많은데 그 중에서도 md를 처음 생성하고 나면 꼭 Init을 해주셔야 합니다.

수정해도 마찬가지!! 그래야 얘가 찰떡같이 내 절대반지를 챙기며 알잘딱깔센 해줍니다!!

 

Tip3. 세부 CLAUDE.md 파일 직접 작성하지 마라!

제가 아까 각 프로젝트마다 하위 CLAUDE.md를 설정할 수 있다고 말씀 드렸었죠?

근데 이걸 한땀 한땀 작성 하고 있으신 분이 ....? 있.......????? 겠죠??

하지만 우리가 하는 것보다 ai를 다루는 것도 ai가 더 잘할지도 모릅니다.

한번 맡겨보세요. 

큰 틀을 작성해달라고 하시고 세부적으로 조정을 해보세요.

저는 세부 md를 작성하지 않아요. 차라리 클로드가 알아서 context를 읽고 대답하는 게

훨씬 좋은 성능을 보여준다고 생각합니다. 나보다.. 낫다 니가ㅠㅠ

 

Tip4. 세부 환경 변수 설정

환경설정 톱니바퀴를 누르면 아래와 같이 environment를 설정할 수 있는데요

민감한 apikey나 password 같은 경우에는 git에 올릴 수 없으니 실행할 때 빼고 올리는데

그럴때 빌드가 안될 수 있잖아요 저기에 설정해두면 우리 또 똑똑한 클로드가 잘 해줍니다..ㅎㅎ

 

Tip5. 모델은??

sonet4.5로도 충분 !! 

현재는 opus 4.5까지 나왔는데요. 가격이 미침.. 저거 쓰다간 다 골로가요.

sonet을 우리 애용합시다.!!

잘 md랑 프롬프트 잘 써주면서 어르고 달래주면 아주아주 성능이 기아급수적으로 오르시는 걸 느끼실 거에요.

 

++ 다른 글들에서는

/clear를 사용하라고 하는데 이젠 더이상 사용하실 수 없습니다.!!

최대한 대화가 길어졌다 싶으시면 new chat으로 새로운 대화를 시작해주세요!!

 

 

md 설정 조금만 달라져도 진짜.. 성능 차이가 너무 심하게 체감 했어요!!

다른 분들도 돈내고 사용하시는데 다들 똑똑하게 잘 활용하세요~~

 

요즘 llm 관련해서 관심을 많이 가지고 있는데 블로그에도 올리고 싶은 글들이 많더라구요!!

adk나 그런 부분도 다뤄볼게요! 

 

그럼 안녕!!