쉽게 배우는 Claude Code ⑤ /init·/memory — 프로젝트에 '우리 집 규칙' 알려주기

새 동료가 팀에 올 때 “우리는 이렇게 일해요” 하고 안내문을 건네듯, Claude Code에도 프로젝트 규칙을 한 번 적어두면 매 세션마다 알아서 지켜 줍니다.

한 줄로

/init은 프로젝트에 맞춘 안내문(CLAUDE.md)을 자동으로 만들어 주고, /memory는 그 안내문에 ‘우리 집 규칙’을 적어두는 명령입니다.

여기서 핵심은 CLAUDE.md라는 파일입니다. 프로젝트 루트에 두는 ‘프로젝트 안내문’으로, 여기 적은 내용(아키텍처, 코딩 관례, 빌드·테스트 방법, 하지 말 것 등)은 매 세션에 자동으로 Claude의 맥락에 로드됩니다. 즉 Claude에게 ‘우리 프로젝트 규칙’을 알려주는 메모리인 셈입니다.

언제 쓰나

가장 중요한 부분입니다. 다음 상황이라면 /init이나 /memory를 떠올리시면 됩니다.

예제 1) 매번 똑같은 설명을 반복하고 있다

세션을 새로 열 때마다 “이 프로젝트는 pnpm을 써”, “테스트는 npm test로 돌려”, “이 폴더는 건드리지 마” 같은 말을 반복하고 계신가요? 그렇다면 /memory로 CLAUDE.md에 한 번 적어두세요.

/memory

한 번 적어두면 다음 세션부터는 Claude가 그 규칙을 매번 알아서 지킵니다. 반복 설명이 사라집니다.

예제 2) 새 레포에서 Claude가 구조를 몰라 헤맨다

방금 클론하거나 새로 만든 저장소라 안내문이 아직 없는 경우입니다. 이럴 때는 /init으로 안내문부터 만드세요.

/init

Claude가 README와 실제 코드 구조를 읽어서 그 프로젝트에 맞는 CLAUDE.md 초안을 만들어 줍니다. 빈 템플릿이 아니라, 실제 폴더 구성과 빌드 방법 등이 반영된 내용입니다.

예제 3) 새 규칙이 생겼다

작업하다 보면 “우리는 항상 TypeScript를 쓴다”, “이 디렉터리는 자동 생성물이니 수정 금지” 같은 규칙이 새로 생기기 마련입니다. 그때그때 /memory로 CLAUDE.md에 한 줄씩 추가해 두면, 그다음부터 Claude가 그 규칙을 지키며 일합니다.

어떻게

흐름은 간단합니다.

저장소를 새로 클론/생성한 직후 → /init 안내문(CLAUDE.md)이 자동으로 생성됩니다. 보통 새 프로젝트에서 첫 세션에 한 번만 하면 됩니다.
규칙이 생길 때마다 → /memory CLAUDE.md(메모리 파일)를 편집해 프로젝트 맥락(아키텍처·관례·자주 쓰는 방법)을 추가하거나 수정합니다. 세션에서 학습한 내용을 쌓아두는 ‘자동 메모리’도 여기서 관리합니다.

두 명령의 역할을 표로 정리하면 이렇습니다.

명령	하는 일	언제
`/init`	프로젝트에 맞춘 `CLAUDE.md` 초안을 자동 생성	새 저장소의 첫 세션에 한 번
`/memory`	`CLAUDE.md` 편집, 자동 메모리 관리	규칙·맥락을 추가·수정할 때 수시로

CLAUDE.md에 들어가면 좋은 내용은 다음과 같습니다.

프로젝트가 무엇이고 어떻게 구성돼 있는지(아키텍처)
코딩 관례(예: 항상 TypeScript)
빌드·테스트 방법(예: 테스트는 npm test)
하지 말 것(예: 이 폴더는 건드리지 말 것)

팁 & 함정

/init 결과물도 한 번 훑어보세요. 자동 생성이라 대체로 정확하지만, 사람이 한 번 읽고 다듬으면 더 좋습니다.
CLAUDE.md는 간결하게. 이 파일은 매 세션 자동으로 로드되므로, 길수록 그만큼 토큰을 씁니다. ‘꼭 필요한 규칙’ 위주로 짧게 유지하세요.
반복 설명이 보이면 신호입니다. 같은 말을 두 번 이상 하고 있다면 /memory로 적어둘 때가 된 것입니다.
자동 메모리는 보조 수단입니다. 세션에서 배운 것을 쌓아두는 기능으로, 역시 /memory에서 관리합니다.

한 장 정리

CLAUDE.md = 프로젝트 루트에 두는 안내문. 매 세션 자동 로드되는 ‘우리 프로젝트 규칙’.
/init = 새 레포에서 그 안내문을 자동으로 만들기. 첫 세션에 한 번.
/memory = 안내문에 규칙을 적고 다듬기. 수시로.
효과: 매번 반복하던 설명이 사라지고, Claude가 규칙을 알아서 지킵니다.

다음 편: /code-review — 커밋·PR 전 마지막 점검.