Claude 로 디버그하기
뭔가 잘못되면 Claude가 디버그 파트너예요
⏱ 예상 ~7분
01 · 읽기
뭔가는 망가져요. 그건 실패가 아니에요 — 소프트웨어를 만들 때 일반적인 상황이에요. 초보자와 경력 있는 엔지니어의 차이는 경력 있는 사람이 절대 실수 안 한다는 게 아니에요. 그들은 어떻게 문제를 명확히 설명 하고 효과적으로 해결책을 찾는지 알아요.
Claude Code 는 훌륭한 디버그 파트너예요. 하지만 어디가 잘못됐는지 말해야 도와줄 수 있어요. '안 돼' 같은 모호한 설명은 Claude에게 단서를 거의 안 줘요. '폼이 제출은 되는데 성공 메시지가 안 나타나' 같은 구체적인 설명은 Claude를 바로 문제로 안내해요.
버그를 보고하는 핵심 패턴: X 를 예상했는데, Y 를 받았고, 이것들을 시도했어요.
02 · 프롬프트 템플릿
터미널에서 에러를 보면 정확한 에러 메시지를 복사해서 Claude에게 붙여넣어요. 다른 말로 옮기지 말기 — 정확한 문구에 중요한 단서가 있어요, 파일명, 줄 번호, 에러 코드 같은 거요.
서버를 실행하니까 이런 에러가 떴어: {{error_message}}03 · 프롬프트 템플릿
모든 버그에 에러 메시지가 있는 건 아니에요. 가끔은 브라우저에서 보기에 그냥 이상한 거예요. 시각적인 버그는 본 것 vs 예상한 것을 설명해요.
{{element}} 가 지금 {{problem}} 인데, {{expected}} 여야 해04 · 퀴즈
Claude에게 버그를 보고할 때 항상 포함해야 하는 건?
- 여러분의 운영체제
- 여러분의 에디터 이름
- 정확한 에러 메시지
- 지금 몇 시인지
05 · 빈칸 채우기
버그를 설명할 때는 이런 패턴을 써요: '_____ 를 예상했는데, Y 를 받았어요'.
06 · 읽기
문제를 명확히 설명하는 건 진짜 스킬이에요 — 그리고 AI 와도, 사람 동료와도 더 잘 협업하게 해줘요.
핵심 정리
- 문제를 명확히 설명하는 게 가장 중요한 디버그 스킬이에요
- 마법의 패턴: 'X 를 예상했는데, Y 를 받았고, 이것들을 시도했어요'
- 정확한 에러 메시지를 복사해요 — 다른 말로 옮기지 말고요
- 시각적 버그는 본 것 vs 예상한 것을 설명해요
- 컨텍스트 포함: 뭘 하다가 망가졌어요?
07 · 퀴즈
웹 페이지에 버튼이 있어요. 누르면 성공 메시지가 보여야 하는데 아무 일도 안 일어나요. 어떤 버그 보고가 Claude가 가장 빨리 고치게 도와줘요?
- 버튼이 안 돼
- 내 페이지에 문제가 있는데 고쳐 줄래?
- JavaScript 고쳐 줘
- index.html 의 제출 버튼을 눌러도 아무 반응이 없어 — 폼 아래에 성공 메시지가 나타나길 예상했는데, 아무 메시지도 안 보여. Console 에 에러도 없어.
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.