Claude Code 상세 사용법 01: 설치와 첫 프로젝트 온보딩 | DAKER 커뮤니티
Claude Code 상세 사용법 01: 설치와 첫 프로젝트 온보딩
Claude Code는 터미널에서 프로젝트를 읽고, 파일을 수정하고, 테스트까지 이어가는 agentic coding 도구입니다. 처음 쓸 때 가장 흔한 실수는 설치 직후 바로 "기능 만들어줘"라고 던지는 것입니다. 좋은 출발점은 설치, 로그인, 프로젝트 루트 확인, CLAUDE.md 초기화 순서입니다.
1. 설치와 업데이트 확인
공식 문서 기준으로 Claude Code는 터미널에서 실행하는 CLI 흐름을 기본으로 설명합니다. 설치 후에는 먼저 명령이 잡히는지 확인하세요.
claude --version업데이트가 필요하면 CLI에서 최신 버전을 확인합니다.
claude update처음 실행은 프로젝트 폴더가 아니라도 가능하지만, 실제 작업은 반드시 저장소 루트에서 시작하는 편이 좋습니다.
cd path/to/your-project
claude2. 로그인보다 중요한 질문
로그인은 /login으로 계정을 전환할 수 있습니다. 하지만 로그인 직후에는 권한보다 맥락을 먼저 정리해야 합니다. Claude에게 바로 수정 지시를 내리기 전에 다음처럼 물어보세요.
이 저장소의 구조를 먼저 읽고, 빌드/테스트/배포 명령을 추정하지 말고 파일 근거와 함께 정리해줘.이 질문은 Claude Code가 프로젝트를 탐색하게 만들고, 사용자는 잘못된 실행 명령을 초기에 잡을 수 있습니다.
3. /init으로 프로젝트 기억 만들기
공식 slash command 문서에는 /init이 프로젝트용 CLAUDE.md 가이드를 초기화하는 명령으로 소개됩니다. 이 파일은 Claude Code가 매번 참고할 작업 규칙입니다.
/init생성 후에는 이런 내용을 담아두면 좋습니다.
# Project Rules
- 패키지 설치 전 반드시 확인한다.
- 변경 후 `npm test`를 실행한다.
- 배포 관련 파일은 요청 없이 수정하지 않는다.
4. 첫 작업은 작게
첫 작업은 "전체 리팩터링"보다 작은 검증 작업이 좋습니다.
README와 package.json을 읽고, 이 프로젝트를 로컬에서 실행하는 최소 절차를 5단계로 정리해줘.그다음에 파일 수정을 맡깁니다.
테스트를 깨뜨리지 않는 범위에서 README의 로컬 실행 절차만 보강해줘. 수정 전후 diff를 보여줘.핵심은 Claude Code를 마법 버튼처럼 쓰지 않는 것입니다. 설치 직후에는 프로젝트의 지도, 명령, 금지선을 먼저 합의하세요. 이 루틴을 만들면 이후 AI 코딩과 바이브코딩 속도가 빨라져도 품질 기준은 흔들리지 않습니다.