Cmd. /init
프로젝트를 분석해 CLAUDE.md 가이드를 생성하는 명령. CLAUDE_CODE_NEW_INIT=1로 스킬·훅·개인 메모리까지 안내하는 대화형 흐름을 활성화
핵심 요약
/init은 패키지 파일·문서·설정·코드 구조 등 저장소를 분석해 프로젝트에 맞는CLAUDE.md가이드를 생성합니다.AGENTS.md·.cursorrules·.windsurfrules같은 기존 에이전트 규칙 파일도 함께 읽어 반영합니다.- 이미
CLAUDE.md가 있으면 덮어쓰지 않고 개선점만 제안하니, 기존 내용이 사라질 걱정 없이 돌려도 됩니다. CLAUDE_CODE_NEW_INIT=1을 설정하면 스킬·훅·개인 메모리 파일까지 단계별로 안내하는 대화형 흐름이 켜집니다.- 첫 세션에서
/init으로 초안을 만든 뒤/memory로 다듬는 것이 권장 흐름입니다.
명령어 원본 선언
/init공식 설명 요약
공식 문서의 정의는 다음과 같습니다.
Initialize project with a
CLAUDE.mdguide. SetCLAUDE_CODE_NEW_INIT=1for an interactive flow that also walks through skills, hooks, and personal memory files
/init은 현재 프로젝트를 분석해 작업 지침을 담은 CLAUDE.md 가이드를 만들어 주는 명령입니다.
핵심 동작:
- 패키지 파일, 문서, 설정, 코드 구조 등 저장소를 분석해 프로젝트에 맞는
CLAUDE.md초안을 작성합니다. - 이미
CLAUDE.md가 있으면 덮어쓰지 않고 개선점을 제안합니다. AGENTS.md,.cursorrules,.windsurfrules같은 기존 에이전트 규칙 파일도 함께 읽어 반영합니다.- 환경 변수
CLAUDE_CODE_NEW_INIT=1을 설정하면 대화형(다단계) 흐름이 켜집니다. 이 흐름은CLAUDE.md뿐 아니라 스킬(skills), 훅(hooks), 개인 메모리 파일까지 단계별로 안내합니다.
공식 워크플로 안내도 "레포에서의 첫 세션"에 /init으로 시작 CLAUDE.md를 만든 뒤 /memory로 다듬으라고 권장합니다. 대부분의 팀은 생성 직후 규칙을 손봐서 운영 기준으로 확정합니다.
최소 지원 버전
- 공식 명령어 문서에 최초 도입 버전이나 최소 지원 버전이 따로 적혀 있지 않습니다. 초기부터 들어 있던 기본 내장 명령입니다.
사용법
기본 실행:
/init대화형 다단계 흐름(스킬·훅·개인 메모리까지 안내)을 켜려면 세션 시작 전에 환경 변수를 설정합니다.
CLAUDE_CODE_NEW_INIT=1 claude생성 직후 추천 흐름:
/memory
/review/memory로 생성된 CLAUDE.md를 다듬고, 필요하면 /review로 점검합니다.
좋은 사용 예
- 신규 레포 온보딩 첫 단계 (첫 세션에서
/init→/memory) - 모노레포 하위 앱 단위로 규칙 파일 분리 시작
- 프로젝트 규칙이 오래돼 전면 재정비할 때 (기존
CLAUDE.md가 있으면 개선 제안을 받음) CLAUDE_CODE_NEW_INIT=1로 스킬·훅·개인 메모리까지 한 번에 셋업
비슷한 명령어 추천
| 명령어 | 차이점 | 언제 선택 |
|---|---|---|
/init | CLAUDE.md 가이드 초기 생성 | 새 프로젝트 시작 시 |
/memory | 기존 CLAUDE.md 메모리 편집·관리 | 생성 후 규칙을 다듬을 때 |
커스텀 /bootstrap-* | 팀 템플릿 적용 중심 | 조직 표준 템플릿이 이미 있을 때 |
활용 사례
- 신입 개발자 온보딩 템플릿 자동화
- 저장소별 금지 명령/검증 루틴 정의
- 코드 리뷰 기준, 브랜치 전략 문서화 시작점
AGENTS.md·.cursorrules·.windsurfrules에 흩어진 기존 규칙을CLAUDE.md로 통합
주의사항
- 생성 파일을 그대로 신뢰하지 말고 팀 정책(보안/릴리즈)을 반드시 추가하세요.
- 루트와 하위 디렉토리 규칙 충돌 여부를 확인하세요.
- 이미
CLAUDE.md가 있으면 덮어쓰지 않고 개선점만 제안하니, 기존 내용이 사라질 걱정 없이 실행해도 됩니다. - 대화형 다단계 흐름은 기본값이 아니라
CLAUDE_CODE_NEW_INIT=1환경 변수로만 켜집니다. 설정하지 않으면 표준CLAUDE.md생성으로 동작합니다.
출처
- Claude Code Docs — Commands: https://code.claude.com/docs/en/commands