Cmd. /init
프로젝트를 분석해 CLAUDE.md 가이드를 생성하는 명령. CLAUDE_CODE_NEW_INIT=1로 스킬·훅·개인 메모리까지 안내하는 대화형 흐름을 활성화
핵심 요약
- 프로젝트
CLAUDE.md초기화 - 입력 위치·지원 조건을 확인한 뒤 아래 실행 예를 사용합니다.
역할
프로젝트 CLAUDE.md 초기화
/init사용 조건
| 항목 | 기준 |
|---|---|
| 입력 위치 | 실행 중인 CLI의 입력창 |
| 종류 | 내장 명령 |
| 상태 | 현재 공식 표 |
| 별칭 | — |
| 공식 최소 버전 | 명시되지 않음 |
| 검증 기준 | 2026-09-22 · Claude Code 2.1.278 |
설치본의 명령 메뉴와 계정·조직 설정에 따라 사용할 수 있는 항목이 달라집니다.
사용 예
/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-* | 팀 템플릿 적용 중심 | 조직 표준 템플릿이 이미 있을 때 |
실행 결과와 유지 범위
프로젝트 지침 파일을 만들거나 갱신하는 흐름을 시작합니다. 제안된 파일 내용과 프로젝트 범위를 검토합니다.
공식 문서의 정의는 다음과 같습니다.
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로 다듬으라고 권장합니다. 대부분의 팀은 생성 직후 규칙을 손봐서 운영 기준으로 확정합니다.
주의사항
- 생성 파일을 그대로 신뢰하지 말고 팀 정책(보안/릴리즈)을 반드시 추가하세요.
- 루트와 하위 디렉토리 규칙 충돌 여부를 확인하세요.
- 이미
CLAUDE.md가 있으면 덮어쓰지 않고 개선점만 제안하니, 기존 내용이 사라질 걱정 없이 실행해도 됩니다. - 대화형 다단계 흐름은 기본값이 아니라
CLAUDE_CODE_NEW_INIT=1환경 변수로만 켜집니다. 설정하지 않으면 표준CLAUDE.md생성으로 동작합니다.
공식 근거
전체 명령 목록 · 검증 범위 · 이 명령의 변경 기록