베스트 프랙티스

Claude Code를 효과적으로 사용하는 프로 개발자들의 노하우

핵심 팁

⚡

시스템 프롬프트 활용

.claude/CLAUDE.md에 프로젝트 규칙을 설정하면 매번 설명할 필요가 없습니다. TypeScript strict, Tailwind 클래스 순서, 컴포넌트 분리 규칙 등을 미리 정의하세요.

🎯

맥스트 토큰 최적화

너무 긴 응답은 잘린 코드를 생성할 수 있습니다. 복잡한 작업은 작은 단위로 분할하고, --max-tokens 옵션으로 응답 길이를 조절하세요.

📁

파일 컨텍스트 제공

관련 파일 경로를 알려주면 AI가 정확한 맥락에서 작업을 수행합니다. claude src/components/Button.tsx src/hooks/useAuth.ts — 여러 파일을 동시에 컨텍스트에 추가하세요.

🔄

반복 패턴 추출

자주 사용하는 패턴은 메모로 저장해두고 재사용하세요. /memory 명령어로 자주 쓰는 프롬프트, 코드 스니펫, 설정을 저장합니다.

📝

인용문으로 정확한 지시

수정할 코드 영역을 인용문 (`)으로 감싸면 AI가 정확한 위치를 이해합니다. "function validate() {`...기존 코드...`}을 더 읽기 쉽게 바꿔줘"

🔧

점진적 리팩토링

한 번에 모든 것을 바꾸려 하지 마세요. 먼저 구조를 변경하고, 타입을 업데이트하고, 마지막으로 테스트를 통과시키는 식으로 단계별로 진행하세요.

프롬프트 작성

구체적인 맥락 제공
'코드 바꿔줘' — 너무 모호함
기대 결과 명시
'좋게 해줘' — 주관적 기준
기술 스택 명시
프레임워크 생략
단계별 지시
한 번에 모든 것 요청

워크플로우

작은 단위로 분할 요청
전체 리팩토링 한 번에
결과 검토 후 피드백
검증 없이 커밋
테스트 실행 병행
테스트 없이 진행
변경 이력 추적
무분별한 자동 저장

보안 & 품질

API 키 확인 후 커밋
비밀키 코드에 포함
에러 핸들링 검토
try-catch 생략 허용
의존성 버전 확인
최신 버전 무조건 적용
보안 스캔 실행
자동 생성 코드 신뢰

고급 활용법

CLAUDE.md 파일 활용

프로젝트 루트에 .claude/CLAUDE.md 파일을 생성하면 AI가 매번 컨텍스트를 설명하지 않아도 됩니다. 프로젝트 규칙, 코드 스타일, 선호하는 패턴을 미리 정의하세요.

bash
# CLAUDE.md

## 프로젝트 규칙
- TypeScript strict 모드 사용
- Tailwind CSS 클래스는 sm: -> lg: 순서
- 컴포넌트는 파일별 분리 (Single Responsibility)

## Claude Code 지시사항
- 코드 수정 시 기존 스타일 유지
- 테스트 파일도 함께 생성/수정
- 커밋 메시지는 Conventional Commits 형식

메모 기능 활용

/memory 명령어로 자주 쓰는 정보를 저장하고 검색하세요. API 엔드포인트, 데이터 구조, 비즈니스 로직 등을 메모해두면 AI가 일관성 있게 동작합니다.

bash
# 자주 쓰는 명령어 메모
/memory "프로덕션 배포 명령어": npm run build && npm run deploy

# API 엔드포인트 메모
/memory "사용자 API": GET /api/users, POST /api/users

# 데이터 구조 메모
/memory "User 인터페이스": id, name, email, role, createdAt

커스텀 명령어 생성

반복적인 작업을 자동화하기 위해 커스텀 스크립트와 함께 Claude Code를 사용하세요. shell 스크립트를 작성하고, AI가 실행 결과를 분석합니다.

bash
#!/bin/bash
# deploy.sh - 배포 자동화 스크립트
echo "빌드 시작..."
npm run build

echo "테스트 실행..."
npm test -- --coverage

echo "배포 준비 완료"
# Claude Code에 이 스크립트 실행 및 결과 분석 요청

권장 워크플로우

1

명확한 목표 설정

무엇을 만들지 구체적으로 정의

2

맥락 제공

관련 파일, 기술 스택 설명

3

작은 단위로 실행

한 번에 하나의 작업 요청

4

결과 검토 & 테스트

생성된 코드 검증

5

피드백 & 반복

필요시 수정 요청 후 재검토