디버깅 지원 기능

디버깅은 Claude Code가 가장 큰 차이를 만드는 영역입니다. 스스로 실행하고 결과를 볼 수 있기 때문입니다.

기본 흐름

오류 메시지를 그대로 붙여넣는 것부터 시작합니다.

npm run build 하면 이 오류가 나. 원인 찾아서 고쳐줘.

[오류 메시지 전문 붙여넣기]

Claude는 보통 이렇게 진행합니다.

1. 오류 메시지에서 파일과 줄을 추출
2. 해당 파일을 읽고 주변 맥락 확인
3. 관련 파일까지 추적
4. 원인 설명 후 수정
5. 다시 빌드해서 통과 확인

"고쳐줘"보다 강력한 지시

증상을 말하고 원인부터 찾게 하세요.

원인 설명을 먼저 요구하면 증상만 덮는 수정을 막을 수 있습니다.

재현되지 않는 버그

가끔 결제가 중복 처리된다는 제보가 있어. 재현이 안 돼.
결제 흐름에서 동시 요청이 들어왔을 때 문제가 될 수 있는 지점을 찾아줘.

로그와 코드를 함께 훑어 가능성 있는 경로를 좁히는 데 유용합니다.

로그를 활용하기

로그가 너무 길면 잘라서 주세요.

npm run test 2>&1 | tail -50

전체 로그를 통째로 넣으면 정작 중요한 부분이 묻힙니다.

이분 탐색

언제부터 깨졌는지 모를 때:

git log --oneline -20 을 보고, 
이 버그와 관련 있어 보이는 커밋을 골라줘.
그 커밋의 diff를 확인해서 원인일 가능성을 판단해줘.

수정 후 반드시 할 것

고친 내용이 다른 곳을 깨뜨리지 않았는지 
전체 테스트를 돌려서 확인해줘.

부분 수정이 다른 곳을 망가뜨리는 일은 흔합니다. 확인까지 지시에 포함하세요.

흔한 함정

• 오류 메시지를 요약해서 전달 → 핵심 정보가 빠집니다. 전문을 그대로 주세요.
• 여러 버그를 한꺼번에 → 원인이 뒤섞입니다. 하나씩 처리하세요.
• "에러 없애줘" → 예외를 삼켜버리는 코드가 나올 수 있습니다.

연습 문제

1. 일부러 타입 오류를 만들고 "왜 나는지 설명부터 해줘"라고 지시해 보세요.
2. 테스트를 하나 깨뜨린 뒤 "원인 찾고 고친 다음 전체 테스트 통과 확인까지"를 시켜 보세요.

코스 완료

입문 코스를 마쳤습니다. 다음은 Claude Skills의 기초로 이어집니다.