새 프로젝트 받았을 때 첫 명령, /init으로 AI에게 '우리 코드' 알려주기

새 프로젝트를 받았는데 Claude가 우리 코드 구조를 몰라서 매번 "이건 어디 있고, 빌드는 어떻게 하고"를 처음부터 설명하느라 지친 적 있나요? 그 설명을 한 번만 해두면 좋을 텐데요. 그게 바로 /init입니다. 폴더를 알아서 훑어보고 '이 프로젝트는 이런 구조다'라는 안내서를 자동으로 만들어줍니다.

정의

/init은 지금 프로젝트의 안내서(CLAUDE.md)를 자동 생성하는 명령입니다. CLAUDE.md는 Claude가 매 대화 시작 때 자동으로 읽는 '프로젝트 설명서'예요. 신입사원에게 주는 업무 매뉴얼 같은 거죠.

/init을 돌리면 Claude가 폴더 전체를 훑어서 빌드 방법, 테스트 도구, 코드 구조, 자주 쓰는 패턴 등을 파악해 이 파일에 정리해둡니다. 그러면 다음부터는 매번 설명하지 않아도 Claude가 우리 프로젝트를 이해한 상태로 빠르게 시작해요.

사용법 (난이도별)

기초 — 기본 생성

프로젝트 폴더에서 대화창에 이렇게 입력합니다.

/init

입력하면 Claude가 폴더를 분석하기 시작합니다. 화면에 파일들을 살펴보는 과정이 흐르고, 끝나면 프로젝트 구조·빌드 명령 등이 정리된 CLAUDE.md 파일이 만들어져요. 파일은 프로젝트 폴더 안에 생깁니다.

응용 — 규칙까지 함께 넣기

/init 한국어 주석 규칙도 넣어줘

/init 뒤에 원하는 규칙을 적으면, 자동 분석한 내용에 더해 내 규칙도 안내서에 함께 담아줍니다. "한국어 주석을 쓴다", "들여쓰기는 스페이스 2칸" 같은 우리 팀 약속을 처음부터 넣어둘 수 있어요.

심화 — 대화형 정밀 설정

CLAUDE_CODE_NEW_INIT=1 claude
/init

CLAUDE_CODE_NEW_INIT=1이라는 설정값을 붙여 Claude Code를 켠 뒤(claude) /init을 실행하면, 단순 분석에서 끝나지 않고 스킬·훅(자동 실행 기능)까지 단계별로 물어보고 제안서를 보여주는 정밀 모드로 동작합니다. 더 꼼꼼하게 세팅하고 싶을 때 쓰는 고급 방법이에요.

실전 사례

새로 받은 외주 코드가 구조도 낯설고 빌드 방법도 몰라 막막했어요. 일일이 파악하기 전에 일단 이걸 돌렸습니다.

/init

Claude가 폴더를 훑어 구조와 빌드·테스트 명령을 정리한 CLAUDE.md를 만들어줬고, 저는 그 파일만 읽고도 프로젝트를 빠르게 이해했습니다. 그 파일을 깃(Git — 코드 버전 관리 도구)에 올려 팀과 공유하니, 새로 합류한 동료도 같은 문서로 시작할 수 있었어요. 한 번의 /init이 온보딩 문서까지 된 거죠.

이렇게 더 씁니다

• 새 프로젝트마다 먼저: 코드를 받자마자 /init으로 구조를 정리시키는 걸 첫 습관으로 만듭니다.
• 다른 설정도 통합: AGENTS.md나 .cursorrules 같은 기존 설정 파일이 있으면 읽어서 CLAUDE.md에 반영해줍니다.
• 정밀 모드: CLAUDE_CODE_NEW_INIT=1로 스킬·훅까지 단계별로 세팅합니다.
• 팀 공유: 만든 CLAUDE.md를 깃에 올리면 팀원 모두가 같은 이해로 시작해, 온보딩이 빨라집니다.

팁: /init으로 만든 CLAUDE.md는 완성본이 아니라 출발점입니다. 작업하다 Claude가 자주 헷갈리는 부분이 있으면 /memory로 파일을 열어 규칙을 다듬으세요. 살아있는 안내서로 키워갈수록 Claude가 점점 똑똑해집니다.

다른 사람들은 이렇게 씁니다

• /init이 빌드 시스템·테스트 프레임워크·코드 패턴을 감지해 CLAUDE.md 토대를 만들어 준다. — CLAUDE.md best practices (TurboDocx)
• 처음 프로젝트에 클로드 코드를 도입할 때 가장 먼저 실행하면 좋은 명령. — 클로드 코드 필수 명령어 (노라보자)

정리

핵심은 한 문장입니다. 새 프로젝트를 받으면 일단 /init부터. 폴더를 분석해 구조·빌드·테스트를 정리한 안내서를 자동으로 만들어주니, AI가 우리 프로젝트를 이해한 채 빠르게 시작합니다. 만든 파일은 팀과 공유해 온보딩 문서로도 쓰고, /memory로 계속 다듬어가세요.

기준: Claude Code v2.1.154 (2026.05)