클로드 코드4분 읽기

클로드 코드 설치부터 CLAUDE.md 규칙 파일까지, 첫 두 편 정리

터미널이 낯설어도 클로드 코드를 처음 시작해 보고 싶은 분께 맞습니다. 설치 후 첫 대화와 CLAUDE.md 규칙 파일 만드는 법을 세 단계로 정리했습니다.

글 꾸비 · 2026.09.09

한 줄 요약

클로드 코드는 설치한 뒤 프로젝트 폴더에서 실행하면 바로 대화가 시작됩니다. 반복되는 지시는 CLAUDE.md에 한 줄씩 적어 두면 세션마다 자동으로 적용됩니다.

AI에게 이렇게 시키기

이 폴더에 CLAUDE.md 파일을 만들어 줘.
- 내가 매번 반복하는 지시를 규칙 한두 줄로 정리해서 넣어 줘
- 꼭 필요한 규칙만 남기고 짧게 유지해 줘
- 만든 뒤 새 세션에서 규칙이 적용되는지 확인하는 방법도 알려 줘

클로드 코드는 터미널(명령어를 입력하는 화면)에서 대화하듯 쓰는 AI 코딩 도구입니다. 이 글은 시리즈의 첫 두 편인 설치와 프로젝트 규칙 파일을 다룹니다.

저도 처음 설치할 때 터미널을 거의 써 본 적이 없어서, 화면에 뜨는 안내를 하나씩 따라가는 것부터 시작했습니다.

1편. 설치와 첫 대화는 어떻게 하나요

클로드 코드는 명령줄 도구로 설치합니다. 설치가 끝나면 프로젝트 폴더로 이동해서 실행 명령을 입력하는 것만으로 대화가 시작됩니다.

첫 화면에서는 무엇을 하고 싶은지 그냥 문장으로 말하면 됩니다. "이 폴더에 뭐가 있는지 봐줘" 같은 간단한 요청부터 시작하는 걸 권합니다.

CLAUDE.md는 클로드가 세션 시작할 때 자동으로 읽는 규칙 파일이며, 프로젝트 폴더에 둡니다. 이 파일에 "이 프로젝트에서는 이렇게 해라"는 규칙을 적어 두면, 매번 같은 지시를 반복하지 않아도 됩니다.

공식 문서는 이 파일을 꼭 필요한 것만 담아 짧게 유지하라고 권합니다. 세션마다 다시 불러오는 파일이라, 길어지면 그만큼 매번 컨텍스트(대화가 기억하는 범위)를 차지하기 때문입니다.

STEP 1

아무 폴더에서나 클로드 코드를 실행해 첫 대화를 걸어 봅니다.

STEP 2

그 폴더에 CLAUDE.md 파일을 만들고 "답변은 한국어로" 같은 규칙 한 줄을 적어 봅니다.

STEP 3

새 세션을 열어 그 규칙이 자동으로 적용되는지 확인합니다.

CLAUDE.md에 너무 많은 걸 적음

저는 처음에 CLAUDE.md에 너무 많은 걸 적으려다 파일이 길어졌습니다. 꼭 필요한 규칙만 남기고 나머지는 지웠더니 오히려 클로드가 더 정확하게 따랐습니다. 규칙은 많다고 좋은 게 아니라는 걸 이때 알았습니다.

CLAUDE.md는 꼭 만들어야 하나요?

필수는 아닙니다. 다만 프로젝트마다 반복해서 알려주는 규칙이 있다면 만들어 두는 편이 편합니다.

설치가 어렵진 않나요?

터미널이 익숙하지 않으면 처음엔 낯설 수 있습니다. 안내 문구를 하나씩 따라가면 되고, 막히는 부분은 공식 문서에서 그대로 찾을 수 있습니다.

한 폴더에 CLAUDE.md를 여러 개 둘 수 있나요?

프로젝트 폴더와 그 안의 하위 폴더 각각에 둘 수 있습니다. 상위 규칙이 공통, 하위 규칙이 그 폴더만의 규칙이 되는 식입니다.

시작은 설치와 대화 한 번이면 충분합니다. 규칙 파일은 처음부터 완벽하게 쓰려 하지 말고, 반복되는 지시가 생길 때마다 한 줄씩 추가하면 됩니다. 다음 단계부터는 슬래시 명령, 파일 도구, Bash처럼 실제로 손을 움직이는 도구가 나옵니다.