바이브 코딩 막혔을 때 혼자 해결하는 5단계
AI 코딩 도구로 개발하다 막히는 건 정상입니다. 문제는 막혔을 때 어떻게 접근하느냐입니다. AI에게 계속 같은 에러를 붙여넣는 것만이 방법은 아닙니다. 이 글에서는 막혔을 때 혼자 시도해볼 수 있는 5단계를 소개합니다.
1단계: 에러 메시지를 제대로 읽기
에러가 나면 당황해서 바로 AI에게 가져가는 경우가 많습니다. 하지만 에러 메시지 자체에 원인의 80%가 담겨 있습니다. 잠깐 멈추고 읽어보세요.
에러 메시지에서 찾아야 할 것들
- 에러 종류: TypeError, SyntaxError, ReferenceError 등 — 각각 원인이 다릅니다
- 파일명과 줄 번호: 에러 메시지에
at file.js:42처럼 나오면, 그 줄을 직접 확인하세요 - 핵심 문장: "Cannot read properties of undefined", "is not a function" 같은 문장이 실제 원인을 알려줍니다
에러 메시지가 영어라서 모르겠다면, 그 문장을 그대로 구글에 검색해보세요. 대부분 Stack Overflow에 똑같은 문제를 겪은 사람이 있습니다.
2단계: 변경 사항을 최소화해서 테스트하기
바이브 코딩을 하다 보면 한 번에 많은 코드를 추가하는 경우가 있습니다. 그러면 어디서 에러가 났는지 파악하기 어렵습니다. 이럴 때는 최소 재현(minimal reproduction) 방법을 씁니다.
방법
- 추가한 코드를 일부 주석 처리하고, 어느 부분에서 에러가 나는지 좁혀가세요
- 새로운 파일에 문제가 되는 코드만 분리해서 테스트해보세요
console.log()를 중간중간 넣어서 어느 시점까지 코드가 정상 실행되는지 확인하세요
3단계: 공식 문서 확인하기
AI가 만들어준 코드가 맞는 방법인지 의심될 때는 공식 문서를 확인하세요. AI는 구버전 API를 사용하거나 존재하지 않는 함수를 만들어내는 경우가 있습니다.
자주 참고하는 공식 문서
- Next.js:
nextjs.org/docs - React:
react.dev - Node.js:
nodejs.org/docs - npm 패키지:
npmjs.com에서 패키지명 검색 후 README 확인
특히 사용하는 함수나 메서드가 공식 문서에 실제로 있는지 확인하는 것이 중요합니다.
4단계: AI에게 더 잘 물어보기
AI에게 같은 질문을 반복하면 비슷한 답이 돌아옵니다. 컨텍스트를 바꿔서 물어보면 다른 답을 얻을 수 있습니다.
효과적으로 AI에게 물어보는 방법
- 버전 명시: "Next.js 14 App Router 기준으로" 처럼 구체적으로 적어주세요
- 에러 메시지 전달: "에러가 났어요" 대신 에러 메시지 전체를 복사해서 붙여넣으세요
- 관련 파일 포함: 에러나는 파일만이 아니라 관련된 파일들도 같이 붙여넣으세요
- 시도한 것 언급: "이미 X를 시도했는데 안 됐어요" 라고 하면 AI가 다른 방향을 제시합니다
- 다른 AI 써보기: ChatGPT로 안 되면 Claude, Gemini를 시도해보세요. AI마다 잘하는 영역이 다릅니다
5단계: 잠깐 쉬거나 도움 요청하기
같은 문제를 2시간 이상 붙잡고 있다면, 계속 혼자 하는 것이 효율적이지 않을 수 있습니다. 두 가지 선택지가 있습니다.
잠깐 쉬기
뇌가 지쳤을 때는 새로운 아이디어가 나오기 어렵습니다. 산책을 하거나 다른 일을 하다 돌아오면 바로 보이는 경우가 많습니다. 실제로 개발자들 사이에서는 "샤워할 때 문제가 풀린다"는 말이 있습니다.
도움 요청하기
개발 커뮤니티(Discord, 오픈 카톡방)에 올려보거나, halper 같은 전문 도움 서비스를 이용해보세요. 같은 문제를 겪어본 사람의 도움은 혼자 몇 시간을 소비하는 것보다 훨씬 빠를 수 있습니다.
정리: 막혔을 때 확인 순서
- 에러 메시지를 끝까지 읽는다
- 변경 사항을 최소화해서 원인을 좁힌다
- 공식 문서에서 해당 함수/API가 맞는지 확인한다
- 컨텍스트를 풍부하게 해서 AI에게 다시 물어본다
- 2시간 이상이면 쉬거나 도움을 요청한다