Claude Code 핵심 팁

파워 유저와 공식 모범 사례 가이드에서 검증된 기법

파워 유저 & 공식 문서에서

이 팁들은 커뮤니티에서 검증된 기법과 Anthropic 공식 가이드를 결합하여 최대의 생산성을 제공합니다.

커뮤니티 팁과 공식 문서 기반 • 공식 문서 보기

1

Claude에게 검증 기준을 알려주세요

가장 영향력 있는 한 가지: Claude에게 자기 작업을 검증하는 방법을 알려주세요. 테스트, 타입 체크, 스크린샷, 린팅 — Claude가 성공을 확인할 방법을 제공하세요.

Best Practices:

  • • 테스트 명령어를 포함하세요: '버그를 수정하고 모든 테스트가 통과하는지 확인해줘'
  • • 검증 단계를 제공하세요: '변경 후 린터를 실행해줘'
  • • 시각적 검증을 위해 /chrome 또는 Playwright MCP로 스크린샷을 사용하세요
“가장 효과적인 프롬프트는 지시뿐만 아니라 성공 기준을 포함합니다.”
2

먼저 탐색하고, 계획하고, 그 다음에 코딩하세요

바로 코드 변경에 뛰어들지 마세요. Claude가 먼저 코드베이스를 이해하고, 접근 방식을 계획한 다음 실행하도록 하세요.

Best Practices:

  • • '이 코드베이스를 탐색하고 아키텍처를 설명해줘'로 시작하세요
  • • 복잡한 작업에는 플랜 모드(Shift+Tab)를 사용하세요
  • • Claude가 코드를 작성하기 전에 계획을 검토하세요
“탐색-계획-코딩 워크플로우는 대부분의 실패를 사전에 방지합니다.”
3

@와 이미지로 구체적인 컨텍스트를 제공하세요

@filename으로 특정 파일을 참조하고, 스크린샷과 에러 이미지를 붙여넣고, Claude에게 정확히 필요한 컨텍스트를 제공하세요.

Best Practices:

  • • @를 사용하여 프롬프트에서 특정 파일을 참조하세요
  • • 에러, UI, 디자인의 스크린샷을 붙여넣으세요
  • • 에러 메시지와 스택 트레이스를 직접 복사-붙여넣기하세요
  • • Claude가 가져올 문서 URL을 참조하세요
“컨텍스트가 구체적일수록 Claude의 응답이 정확해집니다.”
4

효과적인 CLAUDE.md 파일을 작성하세요

CLAUDE.md는 가장 중요한 설정입니다. 짧고, 구체적으로, 정기적으로 정리하세요. 나쁜 CLAUDE.md = 나쁜 결과.

Best Practices:

  • • 간결하게 유지하세요 — 프로젝트 레벨은 500줄 이하로
  • • Claude가 사용해야 할 빌드/테스트/린트 명령어를 포함하세요
  • • 코드 스타일 선호와 컨벤션을 추가하세요
  • • 정기적으로 정리하세요 — 오래되거나 중복된 지시를 제거하세요

⚠️ Warning: 길고 초점 없는 CLAUDE.md는 도움보다 해가 됩니다. 양보다 질입니다.

5

컨텍스트를 적극적으로 관리하세요

컨텍스트 윈도우 관리가 핵심입니다. /clear, /compact, /btw, 새 세션을 사용하여 Claude가 최상의 성능을 발휘하도록 하세요.

Best Practices:

  • • 새 주제에는 새 대화를 시작하세요 (/clear)
  • • /compact를 사용하여 긴 대화를 압축하세요
  • • 메인 컨텍스트를 오염시키지 않는 곁다리 질문에 /btw를 사용하세요
  • • 격리된 조사 작업에 서브에이전트를 사용하세요
“AI 컨텍스트는 우유와 같습니다 — 신선하고 농축된 상태가 가장 좋습니다.”
6

조사에 서브에이전트를 활용하세요

메인 세션의 컨텍스트를 소비하지 않고 탐색, 조사, 리서치를 위해 서브에이전트를 생성하세요. 결과가 요약되어 돌아옵니다.

Best Practices:

  • • 빠른 조회를 위해 Explore 서브에이전트(Haiku, 읽기 전용)를 사용하세요
  • • 코드 변경 없이 복잡한 분석을 위해 Plan 서브에이전트를 사용하세요
  • • 반복되는 조사 패턴을 위해 커스텀 서브에이전트를 만드세요
  • • Ctrl+B로 서브에이전트를 백그라운드에서 실행하세요

CLAUDE.md Tip: 서브에이전트는 자체 컨텍스트 윈도우를 가지므로 메인 세션의 토큰을 소비하지 않습니다.

7

체크포인트로 되감기하세요

Claude가 자동으로 git 체크포인트를 생성합니다. 문제가 발생하면 /rewind를 사용하세요. Esc로 일찍 방향을 수정하세요.

Best Practices:

  • • /rewind로 이전 상태를 복원하세요
  • • Claude가 잘못된 방향으로 가고 있다면 일찍 Esc를 누르세요
  • • 변경 후 git diff를 확인하여 정확성을 검증하세요
  • • 대화가 탈선하면 /clear로 리셋하세요
“일찍 방향을 수정하세요. 되감기의 비용은 추가 변경이 있을 때마다 증가합니다.”
8

권한과 훅을 설정하세요

반복적인 승인을 자동화하고 팀 표준을 강제하기 위해 권한 모드와 훅을 설정하세요.

Best Practices:

  • • 권한 모드 사용: default, acceptEdits, dontAsk, plan
  • • 편집 후 자동 포맷팅을 위한 훅 설정
  • • 도구 사용에 보안 정책을 적용하기 위해 훅 사용
  • • 프로젝트별 허용/차단 도구 설정
9

CLI 도구와 MCP 서버를 활용하세요

Claude는 올바른 도구에 접근할 수 있을 때 가장 잘 작동합니다. GitHub CLI, AWS CLI, 데이터베이스 도구, MCP 서버를 연결하세요.

Best Practices:

  • • PR 및 이슈 관리를 위해 gh(GitHub CLI)를 설치하세요
  • • 데이터베이스, Slack 등을 위해 MCP 서버를 연결하세요
  • • claude mcp add로 새 서버를 등록하세요
  • • 커스텀 스킬을 만들어 Claude에게 도구 워크플로우를 가르치세요
“Claude + CLI 도구 + MCP = 모든 것을 커버하는 개발 워크플로우.”
10

커스텀 스킬과 서브에이전트를 만드세요

도메인 지식을 위한 재사용 가능한 스킬(SKILL.md 파일)과 전문 작업을 위한 커스텀 서브에이전트를 구축하세요.

Best Practices:

  • • 팀 컨벤션과 코드 표준을 위한 스킬을 만드세요
  • • 코드 리뷰, 디버깅, 데이터 분석을 위한 서브에이전트를 만드세요
  • • 플러그인을 통해 팀 전체에 스킬과 에이전트를 공유하세요
  • • /agents 명령어로 서브에이전트를 인터랙티브하게 생성하세요
“스킬과 서브에이전트는 Claude를 범용 어시스턴트에서 도메인 전문가로 변환합니다.”
11

흔한 실패 패턴을 피하세요

나쁜 결과로 이어지는 안티 패턴을 알고 사전에 피하세요.

Best Practices:

  • • 전체 코드베이스를 컨텍스트에 넣지 마세요
  • • '더 좋게 만들어줘' 같은 모호한 지시를 하지 마세요
  • • 검증을 생략하지 마세요 — 항상 테스트/린트/체크 명령어를 포함하세요
피해야 할 흔한 실패:
과도한 컨텍스트, 모호한 지시, 검증 없음, 복잡한 작업에서 플랜 모드 무시
“대부분의 실패는 컨텍스트가 너무 적어서가 아니라 너무 많아서 발생합니다.”

빠른 팁

🎯 'claude'를 'c'로 단축

셸 설정에 'alias c=claude'를 추가하세요. 'c -c'로 이어가기, 'c -r'로 재개.

🔄 음성 입력 활용

Space를 길게 눌러 음성으로 입력하세요. Claude는 음성 인식 오류도 잘 처리합니다.

🧪 다중 세션

병렬 작업을 위해 여러 Claude 인스턴스를 실행하세요. 격리를 위해 git worktree를 사용하세요.

🔍 세션 간 컨텍스트 전달

새로 시작하기 전에 Claude에게 HANDOFF.md를 작성하게 하세요. 다음 세션에서 로드하세요.

Claude Code는 정말 혁신적인 도구입니다

이 팁들은 실제 개발자들과 공식 모범 사례에서 나왔습니다. 검증 기준(팁 #1)과 컨텍스트 관리(팁 #5)부터 시작하세요. 각 기법을 마스터할수록 생산성 향상이 복리로 쌓입니다.

시작하기더 많은 가이드 보기