Claude Code 버그 수정 방법 에러 디버깅 실전 예시

🐛

에러가 나면 그대로 보여주세요 — Claude가 찾아서 고칩니다

에러 메시지를 그대로 보여주면 된다

💡

에러가 나면 복잡하게 생각할 필요 없습니다. 에러 메시지를 그대로 Claude에게 보여주세요. 원인을 찾아서 코드를 직접 수정해줍니다.

상황 1 에러 메시지 붙여넣기

이 에러가 나는데 고쳐줘:

TypeError: Cannot read properties of undefined (reading 'map')
  at UserList.vue:15

Claude가 해당 파일을 열어서 15번째 줄을 확인하고, 원인을 파악한 뒤 코드를 수정합니다.

상황 2 증상만 설명해도 된다

로그인하면 빈 화면이 나와. 콘솔에 에러는 없는데 화면에 아무것도 안 뜸.

상황 3 특정 상황에서만 발생하는 버그

목록에 데이터가 10개 이상이면 스크롤이 안 돼.
9개까지는 잘 되는데 10개부터 멈춰.

에러 위치 파악

에러 메시지에서 관련 파일과 줄 번호를 확인

코드 확인

해당 파일을 열어서 코드를 분석

관련 파일 탐색

연결된 다른 파일도 함께 확인 (import, 의존성 등)

원인 분석 및 수정

원인을 파악하고 수정 방안을 결정한 뒤 코드 수정 (승인 후)

테스트로 확인

필요하면 테스트를 실행해서 수정이 잘 되었는지 검증

📋

에러 메시지 전체를 보여주세요

일부만 보여주면 원인을 못 찾을 수 있습니다

🔁

재현 방법을 알려주세요

“로그인 버튼 누르면 발생”, “데이터 10개 이상일 때” 등

🎯

한 번에 요청하면 됩니다

“에러 원인 분석하고, 수정하고, 테스트 코드도 작성해줘”

💻

추가 정보를 주세요

“환경은 Windows고, Node 20 쓰고 있어” 등

📋

Plan 모드로 먼저 분석

바로 고치기 불안하면 Shift+Tab 2번으로 원인만 먼저 파악