Vibe coding

02강. Claude Code 핵심 조작법

🎯 학습 목표

  • 좋은 프롬프트를 작성하는 기본 원칙을 이해한다.
  • 컨텍스트 윈도우 개념과 효율적인 컨텍스트 관리법을 익힌다.
  • 세션을 저장하고 재개하는 방법을 안다.
  • /help, /clear, /compact 등 핵심 슬래시 명령을 활용한다.

📖 개념 설명

Claude Code를 잘 쓰는 핵심은 ‘명확한 의도 전달’과 ‘컨텍스트 관리’입니다. Claude는 대화 내용을 컨텍스트 윈도우라는 제한된 메모리에 담아 작업합니다. 대화가 길어질수록 초반 내용이 흐려질 수 있으므로, 무엇을 기억시키고 무엇을 비울지 관리하는 것이 중요합니다.

프롬프트는 막연한 명령보다 구체적인 맥락이 중요합니다. “버그 고쳐줘”보다 “로그인 버튼을 누르면 콘솔에 TypeError가 뜨는데, auth.js의 login 함수를 확인해줘”가 훨씬 좋은 결과를 냅니다. AI에게 충분한 정보를 주는 것은 사람 동료에게 일을 맡기는 것과 같습니다. 동료에게 “그거 좀 해줘”라고만 하면 엉뚱한 결과가 오듯, AI에게도 대상 파일, 증상, 기대 동작이라는 세 가지 단서를 갖추어 전달하면 결과의 정확도가 눈에 띄게 올라갑니다.

슬래시 명령은 Claude Code의 제어판입니다. /help로 사용 가능한 명령을 보고, /clear로 대화를 초기화하며, /compact로 긴 대화를 요약해 컨텍스트를 절약합니다. 작업 주제가 바뀔 때 /clear로 깨끗하게 시작하면 Claude가 이전 작업에 끌려가지 않아 정확도가 올라갑니다.

세션 관리도 중요합니다. 작업 도중 터미널을 닫아도 이전 대화를 이어갈 수 있어, 긴 작업을 여러 날에 걸쳐 진행할 수 있습니다. 이는 마치 작업 중이던 문서를 저장해 두고 다음 날 다시 여는 것과 같습니다. 다만 시간이 많이 지난 세션은 맥락이 흐려질 수 있으므로, 재개 직후 “지금까지 무엇을 했는지 요약해줘”라고 물어 상태를 동기화하는 습관이 좋습니다.

컨텍스트 윈도우를 조금 더 자세히 살펴봅시다. Claude는 대화의 모든 내용과 읽어 들인 파일을 일정 크기의 메모리에 담아 추론합니다. 이 메모리가 가득 차면 오래된 내용이 밀려나거나 요약되어, AI가 초반 지시를 잊는 것처럼 보일 수 있습니다. 따라서 한 세션에서 너무 많은 주제를 다루기보다, 주제가 끝나면 정리하거나 초기화하는 것이 정확도를 높입니다. 큰 작업은 여러 개의 깨끗한 세션으로 나누는 것이 오히려 효율적입니다.

또한 프롬프트를 쓸 때 ‘한 번에 하나의 명확한 목표’를 주는 것이 핵심입니다. 사람이 동시에 여러 지시를 받으면 일부를 놓치듯, AI도 한 메시지에 서로 다른 요청을 잔뜩 담으면 일부를 빠뜨릴 수 있습니다. 복잡한 작업은 단계로 쪼개고, 각 단계가 끝날 때마다 결과를 확인한 뒤 다음으로 넘어가는 리듬이 가장 안정적입니다.

💻 실습

먼저 사용 가능한 명령을 확인합니다.

# 도움말 보기
> /help

# 현재 컨텍스트 사용량 확인 및 요약
> /compact

# 주제가 바뀔 때 대화 초기화
> /clear

좋은 프롬프트와 나쁜 프롬프트를 비교해 봅니다.

# 나쁜 예: 맥락 없음
> 에러 고쳐줘

# 좋은 예: 파일, 증상, 기대 동작을 명시
> src/utils/date.js 의 formatDate 함수가 "Invalid Date"를 반환해.
> 입력은 "2026-06-09" 형식이고, "2026년 6월 9일"로 출력되길 원해.
> 원인을 찾아서 수정하고, 왜 그랬는지 설명해줘.

세션을 종료한 뒤 다시 이어가려면 프로젝트 폴더에서 재개 옵션으로 실행합니다.

# 이전 대화 이어서 재개
claude --continue

# 또는 과거 세션 목록에서 선택
claude --resume

⚠️ Windows 환경 주의사항

  • PowerShell에서 멀티라인 프롬프트를 붙여넣을 때 줄바꿈이 명령으로 즉시 전송될 수 있습니다. 긴 프롬프트는 한 번에 붙여넣거나 Claude Code의 입력 모드를 활용하세요.
  • 경로를 프롬프트에 적을 때 Windows 백슬래시는 일부 도구에서 이스케이프로 오해될 수 있으니, 의심되면 슬래시(/)로 적어보세요.
  • Windows Terminal에서 한글이 깨지면 폰트를 한글 지원 폰트(예: D2Coding, Cascadia Code)로 바꾸세요.

💡 팁

  • 대화가 20~30턴을 넘어가면 /compact로 정리해 정확도와 속도를 유지하세요.
  • 한 번에 하나의 작업에 집중시키세요. 여러 요청을 한꺼번에 던지면 일부가 누락될 수 있습니다.
  • “왜 그렇게 했는지 설명해줘”를 붙이면 학습 효과가 커지고 검증도 쉬워집니다.
  • 중요한 결정은 CLAUDE.md 파일에 적어두면 매 세션 자동으로 기억됩니다.
  • 긴 코드를 붙여넣기보다 “그 파일을 직접 읽어줘”라고 하면 컨텍스트를 더 효율적으로 씁니다.
  • 주제를 바꿀 때는 /clear로 깨끗이 시작해 이전 작업의 간섭을 끊으세요.