파일 편집 & 코드 작성

파일 읽기

Claude Code는 프로젝트 파일을 직접 읽어 맥락을 파악합니다.

src/components/Header.tsx 파일을 읽어줘. package.json과 tsconfig.json을 읽고 프로젝트 설정을 파악해줘.

여러 파일을 동시에 읽을 수도 있습니다.

src/services/ 디렉토리의 모든 서비스 파일을 읽고 공통 패턴을 분석해줘.

---

파일 생성 & 수정

새 파일 생성

src/utils/validator.ts 파일을 만들고 이메일, 전화번호, URL 유효성 검사 함수를 작성해줘.

기존 파일 수정

src/app/api/users/route.ts에 페이지네이션 파라미터(page, limit)를 추가해줘.

여러 파일 동시 수정

User 모델에 profileImage 필드를 추가해줘. 관련된 타입 정의, API 라우트, 서비스 파일도 모두 업데이트해줘.

---

버그 수정

오류 메시지와 함께 요청하면 더 정확하게 수정합니다.

npm run build를 실행했더니 이 에러가 났어: Type error: Argument of type 'string | undefined' is not assignable to parameter of type 'string'. at src/lib/auth.ts:35 고쳐줘.

---

리팩토링

src/pages/dashboard.tsx 파일이 너무 커. 컴포넌트를 적절히 분리해서 src/components/dashboard/ 디렉토리 아래에 나눠줘. UserController 클래스의 중복 코드를 제거하고 공통 로직을 별도 헬퍼 함수로 추출해줘.

---

Git 작업

상태 확인 및 커밋

변경된 파일을 확인하고 의미 있는 커밋 메시지로 커밋해줘.

브랜치 작업

feature/user-profile 브랜치를 만들고 현재 작업 내용을 커밋해줘.

코드 리뷰 준비

main 브랜치와 diff를 확인하고 PR 설명을 작성해줘.

---

테스트 작성

src/utils/price.ts의 calculateDiscount 함수에 대한 Jest 단위 테스트를 작성해줘. 경계값과 예외 케이스를 포함해줘. npm test를 실행하고 실패하는 테스트를 모두 수정해줘.

---

코드 검색

이 프로젝트에서 deprecated된 API를 사용하는 파일을 모두 찾아줘. "TODO" 주석이 있는 모든 위치를 찾고 목록을 만들어줘.

---

문서화

src/api/ 디렉토리의 모든 엔드포인트를 분석하고 README.md에 API 문서 섹션을 추가해줘. 복잡한 비즈니스 로직이 있는 함수에 JSDoc 주석을 추가해줘.