Claude Code 창시자가 공개한 실전 사용 팁

1. 병렬 작업을 최대한 활용

• 3~5개의 git worktree를 동시에 실행하고 각각 별도의 Claude 세션을 병렬로 운영하는 것이 클로드 코드 팀 내부에서 최고의 생산성 향상 팁
• 일부는 git checkout 방식을 선호하지만, 대부분의 Claude Code 팀원은 worktree 선호
  • 이로 인해 Claude Desktop 앱에 네이티브 worktree 지원 기능이 추가됨
• worktree에 이름을 붙이고 shell alias(za, zb, zc)를 설정해 한 번의 키 입력으로 전환하는 방식도 활용
• 로그 확인과 BigQuery 실행 전용 "analysis" worktree를 별도로 운영하는 팀원도 있음

2. 복잡한 작업은 항상 Plan Mode로 시작

• 복잡한 작업은 plan 모드로 시작하고, 계획 수립에 에너지를 쏟아 Claude가 한 번에 구현을 완료하도록 유도
• 하나의 Claude가 계획을 작성하면, 두 번째 Claude를 띄워 스태프 엔지니어 역할로 검토시키는 방식도 사용
• 작업이 잘못되는 순간 즉시 plan 모드로 돌아가 재계획하는 것이 중요하며, 무리하게 밀어붙이지 말 것
• 검증 단계에서도 명시적으로 plan 모드 진입을 지시하는 것이 효과적

3. CLAUDE.md에 지속적으로 투자

• 매번 수정할 때마다 "CLAUDE.md를 업데이트해서 같은 실수를 반복하지 않도록 해라"라고 지시
• Claude는 스스로 지켜야 할 규칙을 매우 잘 문서화하는 특성이 있음
• 시간이 지나며 CLAUDE.md를 지속적으로 수정하고, Claude의 실수율이 측정 가능하게 줄어들 때까지 반복
• 한 엔지니어는 모든 작업/프로젝트에 대해 notes 디렉토리를 유지하고 PR마다 업데이트하도록 Claude에 지시, CLAUDE.md가 이를 참조하도록 설정

4. 자체 Skill을 만들고 git에 커밋

클로드 코드 팀의 팁:

• 하루에 한 번 이상 반복하는 작업은 Skill 또는 Slash Command로 만들기
• /techdebt 슬래시 커맨드를 만들어 세션 종료 시 중복 코드를 찾아 제거
• 7일치 Slack, GDrive, Asana, GitHub를 하나의 컨텍스트 덤프로 동기화하는 슬래시 커맨드 셋업
• analytics-engineer 스타일 에이전트를 만들어 dbt 모델 작성, 코드 리뷰, dev 환경 테스트 수행
• 더 알아보기 Extend Claude with skills

5. 버그 수정은 Claude에게 맡김

• Slack MCP를 활성화하고 Slack 버그 스레드를 Claude에 붙여넣은 뒤 "fix"라고만 입력하면 컨텍스트 전환 없이 수정 가능
• 또는 "Go fix the failing CI tests"라고만 지시하고 방법은 Claude에게 맡길 것
• docker logs를 Claude에 전달해 분산 시스템 트러블슈팅에 활용 — 놀라울 정도로 유능함

6. 프롬프트 수준 끌어올리기

• "이 변경사항을 엄격히 검토하고, 내가 테스트를 통과할 때까지 PR 만들지 마"라고 지시해 Claude를 리뷰어로 활용
• "이게 작동한다는 걸 증명해봐"라고 하며 main 브랜치와 feature 브랜치 간 동작 차이를 diff하도록 요청
• 평균적인 수정 결과가 나오면 "지금까지 알게 된 모든 것을 바탕으로 이걸 버리고 우아한 솔루션을 구현해"라고 지시
• 작업 전달 전 상세한 스펙 작성과 모호함 제거가 출력 품질 향상의 핵심

7. 터미널과 환경 설정

• 클로드 코드 팀에서는 Ghostty 터미널 선호
  • 동기화 렌더링, 24비트 컬러, 적절한 유니코드 지원이 장점
• /statusline으로 상태바를 커스터마이징해 컨텍스트 사용량과 현재 git 브랜치 항상 표시
• 터미널 탭에 색상 코드와 이름을 붙이고 tmux 사용 — 작업/worktree당 하나의 탭
• 음성 받아쓰기 활용 권장
  • 타이핑보다 3배 빠르게 말할 수 있고, 프롬프트가 훨씬 상세해짐
  • macOS에서 fn 키 두 번 누르기로 활성화
• 추가 팁 : Optimize your terminal setup

8. 서브에이전트 활용

• Claude가 더 많은 연산을 투입하길 원하면 요청에 "use subagents"를 추가
• 개별 작업을 서브에이전트에 위임해 메인 에이전트의 컨텍스트 윈도우를 깔끔하고 집중된 상태로 유지
• 권한 요청을 Opus 4.5로 라우팅하는 hook 설정 — 공격 스캔 후 안전한 요청은 자동 승인

9. 데이터·분석 작업에 Claude 활용

• Claude Code에 "bq" CLI를 사용해 즉석에서 메트릭을 가져오고 분석하도록 요청
• 코드베이스에 BigQuery skill을 체크인해두고 팀 전체가 Claude Code에서 직접 분석 쿼리 실행
• 6개월 이상 SQL을 직접 작성하지 않았음
• CLI, MCP, API가 있는 모든 데이터베이스에 동일하게 적용 가능

10. Claude를 활용한 학습

• /config에서 "Explanatory" 또는 "Learning" 출력 스타일을 활성화하면 Claude가 변경 사항의 이유(why) 를 설명
• 익숙하지 않은 코드를 설명하는 시각적 HTML 프레젠테이션 생성 요청 — 놀라울 정도로 좋은 슬라이드를 제작함
• 새로운 프로토콜과 코드베이스 이해를 위해 ASCII 다이어그램으로 그리도록 요청
• 간격 반복 학습(spaced-repetition) skill 구축
  • 사용자가 이해한 내용을 설명하면 Claude가 빈틈을 채우는 추가 질문을 하고 그 결과를 저장