Claude Code 유용한 팁

실무에서 Claude Code를 더 효과적으로 활용하기 위한 팁과 워크플로우를 모았습니다.

프롬프트 작성 요령

구체적으로 요청하기

모호한 요청보다 구체적인 요청이 훨씬 좋은 결과를 냅니다.

나쁜 예	좋은 예
"버그 고쳐줘"	"`src/auth/login.ts`의 JWT 만료 처리 로직에서 500 에러가 발생해. 스택 트레이스는 이거야: ..."
"리팩토링해줘"	"`UserService` 클래스를 Repository 패턴으로 분리해줘. DB 접근 로직을 `UserRepository`로 옮겨줘."
"테스트 작성해줘"	"`src/utils/date.ts`의 `formatDate` 함수에 대한 Jest 단위 테스트를 엣지 케이스 포함해서 작성해줘."

맥락 제공하기

이 프로젝트는 Next.js 15 + TypeScript + Prisma 스택이야.
현재 users 테이블에 soft delete를 추가하려고 해.
deletedAt 컬럼 추가 마이그레이션과 관련 쿼리 수정을 해줘.

단계별 진행

한 번에 너무 많은 작업을 요청하면 오류가 발생할 수 있습니다. 큰 작업은 단계별로 나눠서 진행하세요.

생산성 향상 워크플로우

코드 리뷰 자동화

방금 작성한 PR 변경사항을 리뷰해줘.
보안 취약점, SOLID 원칙 위반, 성능 이슈에 집중해줘.

레거시 코드 이해

`src/legacy/payment.js` 파일을 읽고
이 코드가 무엇을 하는지 설명해줘.
그 다음 TypeScript로 마이그레이션 계획을 세워줘.

반복 작업 자동화

`docs/api/` 디렉토리의 모든 라우트 파일을 읽고
OpenAPI 3.0 스펙 문서를 자동 생성해줘.

단축키 & 빠른 명령어

단축키 / 명령어	동작
`↑` / `↓`	이전/다음 입력 히스토리
`Ctrl+C`	현재 작업 중단
`Ctrl+L`	화면 지우기
`/clear`	대화 기록 초기화
`/compact`	컨텍스트 압축 (긴 대화 시)
`! <명령어>`	셸 명령 직접 실행
`#` 로 시작	메모리에 기억 저장

CLAUDE.md 활용 팁

프로젝트 루트에 CLAUDE.md를 잘 작성할수록 Claude가 더 정확하게 동작합니다.

1# 프로젝트 규칙2 3## 코딩 컨벤션4- TypeScript strict mode 사용5- 함수형 컴포넌트만 사용 (클래스 컴포넌트 금지)6- 커밋 전 `npm run lint && npm test` 필수7 8## 주의사항9- `.env` 파일 절대 커밋 금지10- `src/legacy/` 디렉토리 수정 금지 (담당자 협의 필요)11- DB 마이그레이션은 반드시 리뷰 요청 후 실행12 13## 자주 쓰는 명령어14- `npm run dev` — 개발 서버 시작15- `npm test` — 전체 테스트 실행16- `npm run build` — 프로덕션 빌드

비용 절감 팁

/compact 명령어로 긴 대화를 압축하여 토큰 사용량 줄이기
반복 작업은 CLAUDE.md에 패턴을 정의하여 매번 설명 반복 방지
대규모 파일 탐색보다 Grep/Glob으로 먼저 범위 좁히기
작업이 완료되면 /clear로 컨텍스트 초기화 후 새 작업 시작

자주 묻는 질문

Q. Claude Code가 실수로 파일을 삭제하거나 잘못 수정하면? Git을 사용하고 있다면 git checkout -- . 또는 git stash로 복구할 수 있습니다. 중요한 작업 전에는 항상 커밋을 해두세요.

Q. 대화 중 작업을 중단하고 싶으면? Ctrl+C를 누르면 현재 실행 중인 작업을 중단합니다. 파일 수정이 진행 중이었다면 부분적으로 변경될 수 있으니 Git으로 확인하세요.

Q. 컨텍스트 한도에 도달하면? /compact 명령어로 대화를 요약하거나, /clear로 초기화 후 필요한 맥락만 다시 제공하세요.