Claude Code 팀이 직접 공개한 실전 꿀팁 11가지

Claude Code 제작자 Boris Cherny가 Claude Code 팀에게 직접 들은 "실전 사용 팁"을 공유했습니다. 이 글에서는 팀 내부에서 검증된 생산성 극대화 비법을 정리합니다.

---

TIP 1. 병렬 작업을 기본값으로 삼아라

팀이 꼽은 생산성 1위 팁입니다.

3~5개의 git worktree를 동시에 띄우고 각각 별도의 Claude 세션을 병렬로 돌리는 방식입니다. Claude Desktop에 네이티브 worktree 지원이 추가된 것도 팀 대부분이 이 방식을 선호했기 때문입니다.

운영 팁:

• worktree에 이름을 붙이고 alias(예: za, zb, zc)로 1키 이동
• 로그 읽기나 BigQuery 분석만 담당하는 전용 analysis worktree를 따로 운영

📎 참고: Git Worktrees로 병렬 세션 운영하기

---

TIP 2. 복잡한 작업은 무조건 Plan 모드부터

복잡한 작업은 항상 Plan Mode로 시작하세요.

에너지를 "계획"에 집중하면 Claude가 구현을 1-shot으로 끝낼 확률이 올라갑니다. 팀 내부에서는 Claude 한 명이 plan을 작성하고, 다른 Claude가 staff engineer처럼 plan을 리뷰하는 방식도 사용합니다.

핵심 원칙:

• 문제가 꼬이면 즉시 Plan Mode로 돌아가 재계획 (계속 밀어붙이지 않기)
• 빌드뿐 아니라 "검증 단계"도 Plan Mode로 하라고 명시적으로 지시

---

TIP 3. CLAUDE.md에 투자해서 실수를 줄여라

CLAUDE.md는 Claude의 작업 규칙과 운영 원칙을 담는 핵심 파일입니다.

매번 교정이나 수정 후, 마지막에 이렇게 지시하세요:

"CLAUDE.md를 업데이트해서 다음엔 같은 실수 하지 않게 해."

Claude는 자기 규칙을 만드는 데 특히 강합니다. CLAUDE.md를 계속 편집/개선해서 실수율이 눈에 띄게 줄 때까지 반복하세요.

팀 사례:

• 작업/프로젝트마다 notes 디렉토리를 유지
• PR마다 notes 업데이트
• CLAUDE.md가 이 notes를 참조하도록 구성

---

TIP 4. 스킬(명령)을 만들고 git에 커밋해서 재사용

자주 하는 작업을 스킬/커맨드로 만들어 git에 커밋하면 프로젝트가 바뀌어도 그대로 재사용할 수 있습니다.

팀 운영 규칙:

• 하루에 1번 이상 하는 일은 스킬/커맨드로 만들기
• /techdebt 슬래시 커맨드로 매 세션 종료 때 중복 코드 탐지/제거
• 최근 7일 Slack/GDrive/Asana/GitHub를 한 번에 컨텍스트 덤프로 동기화하는 커맨드 구성
• Analytics engineer 스타일 agent 만들기 (dbt 모델 작성, 코드 리뷰, dev 테스트 등)

📎 참고: Skills로 Claude 확장하기

---

TIP 5. 버그 수정은 Claude에게 맡겨라

Claude는 대부분의 버그를 스스로 고칠 수 있습니다.

팀 방식:

• Slack MCP 활성화
• Slack 버그 스레드를 붙여넣고 "fix"라고만 말하기

또는 이렇게만 말해도 됩니다:

"실패하는 CI 테스트 고쳐."

핵심: micromanage 하지 말 것. 어떻게 고칠지 간섭하지 않기. docker logs를 붙여 분산 시스템 트러블슈팅에도 활용 가능합니다 (의외로 잘 합니다).

---

TIP 6. 프롬프팅을 한 단계 올리기

Claude를 단순 실행자가 아니라 리뷰어/검증자로 세팅하세요.

예시 프롬프트:

• "이 변경사항을 엄격하게 검증해. 내가 테스트 통과하기 전엔 PR 만들지 마."
• "이게 동작한다는 걸 증명해줘." (main vs feature 동작 비교 등)

어설픈 수정이 나오면 이렇게 리셋:

"지금까지 배운 걸 바탕으로 이건 폐기하고 우아한 해결책으로 다시 구현해."

일을 넘기기 전에 스펙을 구체적으로 써서 모호성을 제거할수록 결과가 좋아집니다.

---

TIP 7. 터미널/환경 세팅에 투자

팀은 Ghostty 터미널을 선호합니다. synchronized rendering, 24-bit color, 유니코드 지원 등이 장점입니다.

Claude 세션 juggling 팁:

• /statusline으로 상태바에 컨텍스트 사용량 + 현재 git 브랜치 표시
• 탭 색상/이름 구분, tmux 사용
• "탭 1개 = 작업 1개/worktree 1개" 운영

음성 인식(voice dictation) 활용:

• 말이 타이핑보다 약 3배 빠름
• 프롬프트 디테일이 훨씬 좋아짐
• macOS에서는 fn 키 2번 연속으로 활성화

📎 참고: 터미널 설정 가이드

---

TIP 8. Subagents로 연산과 컨텍스트를 분리

더 많은 compute가 필요하면 요청에 **"use subagents"**를 덧붙이세요.

세부 작업을 subagent에게 넘겨 메인 에이전트 컨텍스트를 깨끗하게 유지할 수 있습니다.

고급 팁: 권한 요청(permission request)은 hook으로 Opus 4.5에 라우팅 → 공격 탐지 후 안전한 요청 자동 승인

📎 참고: Permission Request Hooks

---

TIP 9. 데이터/분석 작업도 Claude로 처리

Claude Code에 bq CLI를 사용하게 해서 실시간 메트릭 조회/분석이 가능합니다.

팀은 BigQuery skill을 코드베이스에 커밋해두고 공통으로 사용합니다. Boris는 6개월 이상 SQL을 직접 쓰지 않았다고 언급했습니다.

원리상 CLI/MCP/API가 있는 DB라면 동일하게 적용 가능합니다.

---

TIP 10. Claude로 학습 효율까지 올리기

/config에서 "Explanatory" 또는 "Learning" 출력 스타일을 활성화하면 변경의 why(왜)를 설명하게 만들 수 있습니다.

낯선 코드 이해 팁:

• 시각적 HTML 프레젠테이션 생성 요청 (슬라이드 퀄리티가 좋음)
• ASCII 다이어그램으로 프로토콜/코드베이스 구조 설명 요청

Spaced Repetition 학습 스킬 만들기:

1. 내가 이해한 내용을 설명
2. Claude가 후속 질문으로 빈틈을 메움
3. 결과를 저장해서 반복 학습

---

TIP 11. 권한 요청이 너무 많을 때

"Claude가 계속 permission을 물어봐서 답답하다"는 질문에 대한 답변입니다.

해결책: /permissions로 사전 허용(pre-allow) 설정

Boris는 이 문제를 적극적으로 개선 중이라고 언급했습니다.

---

마무리

이 11가지 팁은 Claude Code 팀이 실제로 매일 사용하는 검증된 방법들입니다. 특히 병렬 worktree 운영, Plan Mode 우선, CLAUDE.md 지속 개선은 즉시 적용해볼 만한 핵심 전략입니다.

자신만의 스킬과 워크플로우를 만들어가며 Claude Code와의 협업 효율을 높여보세요.