/init

어떻게 동작하나

/init을 실행하면 Claude가 코드베이스를 분석해, 찾아낸 빌드 명령, 테스트 방법, 프로젝트 관례를 담은 CLAUDE.md를 만듭니다. 이미 CLAUDE.md가 있으면 덮어쓰지 않고 개선안을 제안합니다.

만들어진 파일은 출발점입니다. 공식 문서도 "Claude가 스스로 찾지 못하는 지침"을 직접 보태며 다듬으라고 안내합니다. 코드에서 읽어낼 수 있는 사실은 초안이 채워 주지만, 팀 합의나 하지 말아야 할 일 같은 맥락은 사람이 적어야 합니다.

사용 방법

프로젝트 루트에서 claude를 실행한 뒤 /init을 입력합니다. 생성이 끝나면 파일을 열어 내용을 검토합니다. /memory로 열어서 고치는 방법도 있습니다.

• 1단계: 프로젝트 루트에서 claude 실행
• 2단계: /init 입력
• 3단계: 생성된 CLAUDE.md에서 틀린 명령, 불필요한 설명을 삭제
• 4단계: 코드로는 알 수 없는 규칙(커밋 규칙, 건드리면 안 되는 폴더 등)을 추가
• 5단계: 새 세션에서 /context를 실행해 Memory files 목록에 올라오는지 확인

claude
/init

대화형 모드와 변형

환경 변수 CLAUDE_CODE_NEW_INIT=1을 설정하면 /init이 여러 단계의 대화형 흐름으로 바뀝니다. 먼저 CLAUDE.md, 스킬, hook 중 무엇을 만들지 묻고, 서브에이전트로 코드베이스를 살핀 뒤 후속 질문으로 빈칸을 채우고, 파일을 쓰기 전에 검토할 수 있는 제안을 보여 줍니다. 셸에서 설정하거나 설정 파일의 env 블록에 넣을 수 있고, /init의 실행 방식만 바꾸므로 켜 둔 채로 써도 됩니다.

OpenAI Codex나 Google Gemini CLI 설정을 발견하면 /import로 가져올지 제안하기도 합니다. 이미 AGENTS.md를 쓰는 저장소라면 CLAUDE.md에서 @AGENTS.md로 가져오는 방법을 쓸 수 있습니다.

이웃 기능과의 관계

• CLAUDE.md: /init이 만들어 내는 결과물이자 이후 직접 관리할 파일입니다.
• /memory: 만든 뒤에 파일을 열어 편집하고 자동 메모를 켜고 끄는 명령입니다. /init은 처음 만들기, /memory는 이후 관리입니다.
• 자동 메모(auto memory): Claude가 대화 중 교정을 보고 스스로 적는 메모로, /init과는 별개입니다.

실제 예시

프로젝트 루트에서 claude 실행 후 /init

/init

CLAUDE_CODE_NEW_INIT=1 claude 로 실행한 뒤 /init

흔한 실수와 쓰지 말아야 할 때

• 생성된 초안을 검토 없이 그대로 쓰는 것. 분석이 틀린 명령이나 사소한 사실을 적을 수 있습니다. 실제로 돌려 보고 확인하세요.
• 길어진 초안을 그대로 두는 것. 공식 권장은 파일당 200줄 이내입니다. 쓸모없는 항목은 지우세요.
• /init 한 번으로 끝났다고 생각하는 것. 프로젝트가 바뀌면 CLAUDE.md도 같이 고쳐야 합니다.
• 코드베이스가 거의 비어 있을 때 기대하는 것. 분석할 내용이 없으면 초안도 빈약합니다. 이때는 직접 몇 줄 쓰는 편이 낫습니다.

자주 묻는 질문