기본 명령어
💡 이 챕터에서 배우는 것: 파일 작업, 코드 분석, 디버깅, Git 연동 등 자주 쓰는 명령 패턴
전제 지식
첫 번째 실행을 완료하고 기본 인터페이스에 익숙해진 상태여야 합니다.
명령 패턴의 기본 원칙
Claude Code에 명령을 줄 때 효과적인 방식:
✅ 좋은 예: "src/auth/login.js 파일을 읽고, 비밀번호 해싱 로직을 설명해줘"
✅ 좋은 예: "현재 디렉토리의 README를 보고, 누락된 설치 단계를 추가해줘"
❌ 나쁜 예: "코드 고쳐줘" (너무 모호함)
❌ 나쁜 예: "좋은 코드 작성해줘" (기준이 없음)
구체적인 파일명 + 명확한 작업 + 원하는 결과 조합이 핵심입니다.
1. 파일 읽기 및 분석
파일 내용 이해하기
> utils/helpers.js를 읽고 각 함수가 무엇을 하는지 설명해줘
> src/components/Button.tsx의 Props 타입을 분석해줘
> config/database.js에서 환경변수로 바꿔야 할 하드코딩된 값을 찾아줘
전체 프로젝트 이해하기
> 이 프로젝트의 폴더 구조를 보고 전체 아키텍처를 설명해줘
> package.json을 보고 이 프로젝트가 어떤 기술 스택을 쓰는지 알려줘
> README.md를 읽고 핵심 내용을 한국어로 요약해줘
2. 코드 작성
새 파일 생성
> utils/validation.js 파일을 만들어줘.
이메일, 전화번호, 비밀번호(8자 이상, 특수문자 포함) 유효성 검사 함수 포함.
> components/Modal.jsx를 만들어줘.
props: isOpen, onClose, title, children
tailwind CSS로 스타일링
기존 코드에 기능 추가
> UserService.js에 사용자 검색 기능을 추가해줘.
이름 또는 이메일로 검색, 대소문자 구분 없이.
> api/routes/products.js에 페이지네이션 파라미터를 추가해줘.
?page=1&limit=20 형식으로.
3. 디버깅
에러 분석 및 수정
> npm run build 해서 에러 확인하고 수정해줘
> 터미널에 이 에러가 났어: [에러 메시지 붙여넣기] — 원인과 해결법 알려줘
> tests/ 폴더의 모든 테스트를 실행하고 실패하는 것들을 고쳐줘
성능 문제
> UserList 컴포넌트가 너무 자주 리렌더링되는 것 같아. 원인을 찾고 최적화해줘
> 이 SQL 쿼리가 느려: [쿼리 붙여넣기] — 최적화 방법을 제안해줘
4. 리팩토링
코드 품질 개선
> utils.js가 너무 커. 기능별로 separate 파일로 분리해줘
> 이 함수를 더 읽기 쉽게 리팩토링해줘, 동작은 동일하게 유지하면서
> Promise 기반 코드를 async/await으로 변환해줘
코드 스타일 통일
> 프로젝트의 .eslintrc 규칙에 맞게 controllers/ 폴더 전체를 수정해줘
> 모든 컴포넌트에서 var를 const/let으로 교체해줘
5. 테스트 작성
> UserService.js의 각 함수에 대한 Jest 단위 테스트를 작성해줘
> 현재 테스트 커버리지를 확인하고 누락된 edge case 테스트를 추가해줘
> E2E 테스트: 로그인 → 대시보드 이동 → 로그아웃 흐름을 Playwright로 작성해줘
6. 문서화
> 모든 public 함수에 JSDoc 주석을 추가해줘
> API 엔드포인트 목록을 읽고 README에 API 문서 섹션을 추가해줘
> CHANGELOG.md를 최근 커밋 메시지를 기반으로 업데이트해줘
7. Git 작업
Claude Code는 git 명령도 실행할 수 있습니다:
> git status 확인하고 수정된 파일들을 요약해줘
> 변경사항을 검토하고 적절한 커밋 메시지를 작성해서 커밋해줘
> 현재 브랜치와 main의 차이를 분석하고 PR 설명 초안을 작성해줘
자주 쓰는 슬래시 커맨드
/model # 현재 모델 확인
/model claude-opus-4-6 # Opus로 전환 (복잡한 작업)
/model claude-haiku-4-5-20251001 # Haiku로 전환 (빠른 작업)
/cost # 이번 세션 비용
/clear # 대화 초기화 (새 컨텍스트로 시작)
/status # 현재 설정 확인
/help # 전체 도움말
실전 워크플로우 예시
"기능 추가" 워크플로우
1. > 이 프로젝트 구조를 파악해줘 (이해)
2. > 사용자 프로필 편집 기능을 어떻게 구현하면 좋을지 계획 세워줘 (계획)
3. > 계획대로 구현해줘 (실행)
4. > 테스트 작성해줘 (검증)
5. > 변경사항 커밋해줘 (마무리)
"버그 수정" 워크플로우
1. > npm test 실행하고 실패 테스트 보여줘
2. > [실패한 테스트 파일]을 분석하고 원인 찾아줘
3. > 수정해줘
4. > 다시 npm test 실행해서 확인해줘
핵심 정리
- 구체적인 파일명 + 명확한 작업 조합이 효과적
- 파일 읽기 → 분석 → 수정 → 검증 순으로 단계적으로 진행
/model로 작업에 맞는 모델 선택 (비용 최적화)- Claude Code는 git, npm, python 등 터미널 명령도 직접 실행
레벨 1 완료!
축하합니다! 레벨 1 — 입문을 모두 마쳤습니다.
다음으로 배울 것:
- CLAUDE.md로 Claude의 행동을 커스터마이즈
- 슬래시 커맨드 완전 정복
- Git 연동 심화
- 컨텍스트 관리 및 메모리 시스템
이 페이지에 오류가 있나요? 오류 제보하기 →