Document 01READ · PRACTICE · VERIFY
01. 설치와 프로젝트 시작
지원 환경을 확인하고 작업할 저장소에서 Claude Code를 시작합니다.
- Node.js와 Git 환경 확인
- 공식 설치 방식 선택
- 프로젝트 루트에서 실행
- 인증 후 첫 저장소 설명 요청
cd my-project
claude
> 이 프로젝트의 구조와 실행 방법을 먼저 설명해줘 프로젝트 폴더Claude Code 공식 시작 가이드
Anthropic · Resource folder
Claude Code
터미널에서 프로젝트 전체를 읽고 계획·구현·검증하는 에이전트 코딩 워크플로를 익힙니다.
학습 자료4개 문서
Document 02READ · PRACTICE · VERIFY
02. 프로젝트 컨텍스트 문서
도구가 매번 추측하지 않도록 명령어, 구조, 금지 사항과 완료 조건을 한곳에 정리합니다.
- 빌드·테스트 명령 기록
- 핵심 디렉터리 설명
- 코딩 규칙 명시
- 수정 금지 영역 표시
# Project guide
- npm run lint && npm test
- 기능 수정 전 관련 테스트를 먼저 확인
- 생성 파일과 사용자 데이터는 수정하지 않기 Document 03READ · PRACTICE · VERIFY
03. 계획 → 구현 → 검증
큰 요청을 바로 수정시키지 않고 탐색과 계획, 작은 변경, 검증 순서로 진행합니다.
- 관련 파일만 먼저 탐색
- 변경 범위와 위험 정리
- 작은 단위로 구현
- diff·lint·test 확인
먼저 코드를 수정하지 말고 관련 파일과 데이터 흐름을 조사해줘.
그다음 변경 계획과 충돌 가능성을 제시해줘. Document 04READ · PRACTICE · VERIFY
04. 리뷰와 안전 체크
완료 보고를 그대로 믿지 않고 변경 내용과 테스트 근거를 사람이 다시 확인합니다.
- 예상 밖 파일 변경 확인
- 비밀키 노출 검사
- 모바일·오류 상태 확인
- 되돌리는 방법 기록
git diff --stat
git diff
npm run lint
npm testApply what you learned