바이브코딩 디버깅 — 오류가 날 때 AI에게 말하는 법

바이브코딩 디버깅 — 오류가 날 때 AI에게 말하는 법

바이브코딩에서 디버깅(오류 고치기)의 핵심은 코드를 읽는 것이 아니라 문제를 정확하게 전하는 것입니다. “어디서, 무엇을 했더니, 원래 기대한 것과 달리, 실제로 무슨 일이 일어났는지” 네 가지만 말하면 AI가 대부분의 오류를 스스로 찾아 고칩니다. 이 글에서는 오류를 발견하는 법, 전하는 법, 그리고 고치다 더 망가졌을 때 되돌리는 법을 설명합니다.

AI의 “다 됐습니다”는 시작일 뿐입니다

바이브코딩을 하다 보면 AI가 “기능을 모두 완성했습니다!”라고 보고했는데, 막상 열어 보면 버튼이 안 눌리는 경우를 자주 만납니다. AI가 거짓말을 한 것은 아닙니다. 코드를 쓰고 나서 “이 정도면 될 것”이라고 판단한 것뿐입니다. 실제로 사람이 눌러 보기 전에는 아무도 모릅니다.

그래서 AI의 완료 보고를 받으면 아래 네 가지를 직접 확인하세요.

  • 첫 화면이 제대로 뜨나요?
  • 버튼을 누르면 원하는 일이 일어나나요?
  • 저장한 뒤 새로고침해도 내용이 남아 있나요?
  • 폰에서 열어도 화면이 깨지지 않나요?

특히 폰 확인이 중요합니다. 컴퓨터에서는 멀쩡한데 폰에서 한글이 세로로 한 글자씩 쌓이거나, 화면이 옆으로 밀려 가로 스크롤이 생기는 일이 아주 흔합니다.

오류를 전하는 네 가지 공식

“안 돼요”라고만 하면 AI도 어디가 문제인지 찾아 헤맵니다. 병원에서 “아파요”보다 “어제 저녁부터, 계단을 오를 때, 오른쪽 무릎이 아파요”라고 해야 진단이 빠른 것과 같습니다.

💡 오류를 전하는 공식

어디서 + 무엇을 했더니 + 원래 기대한 것 + 실제로 일어난 일

✍️ 오류 전달 예시
회원 목록 화면에서(어디서)
"엑셀로 내려받기"를 눌렀더니(무엇을 했더니)
파일이 내려받아져야 하는데(기대)
아무 반응이 없습니다(실제). 컴퓨터에서는 되고 폰에서만 안 됩니다.

여기에 두 가지를 더하면 훨씬 빨라집니다.

  • 화면 캡처 — 문제가 보이는 화면을 그대로 붙여 넣습니다.
  • 오류 문구 그대로 — 빨간 글씨나 경고창이 떴다면 그 문구를 고치지 말고 그대로 복사해 붙입니다. 그 한 줄이 원인을 찾는 가장 큰 단서입니다.

“어디서만 안 되는가”가 큰 단서입니다

같은 기능이 어떤 환경에서는 되고 어떤 환경에서는 안 된다면, 그 차이를 꼭 알려 주세요.

  • 컴퓨터에서는 되는데 폰에서는 안 된다
  • 내 컴퓨터에서는 되는데 인터넷에 올린 뒤(배포 후)에는 안 된다
  • 처음에는 되다가 자료가 많아지니 일부가 안 보인다

예를 들어 마지막 경우는 무료 데이터베이스가 한 번에 가져오는 자료 수에 한도가 있어서 목록이 조용히 잘리는 일일 수 있습니다. 이런 차이를 말해 주면 AI가 원인을 훨씬 빨리 좁힙니다.

한 번에 하나씩 고치기

고칠 것이 열 가지라도 한꺼번에 말하지 마세요. AI가 몇 가지를 빠뜨리거나, 하나를 고치다 다른 곳을 망가뜨리기 쉽습니다. 가장 중요한 것 하나를 고치고, 확인하고, 다음으로 넘어가는 것이 결국 가장 빠릅니다.

같은 오류가 계속 반복될 때

AI가 고쳤다고 하는데 같은 문제가 계속되면 접근을 바꿔 보세요.

✍️ 원인부터 찾기
바로 고치지 마시고, 왜 이 문제가 생기는지 원인부터 찾아서 쉬운 말로 설명해 주세요.
원인을 확인한 다음에 고쳐 주세요.
✍️ 직접 확인 요청
고친 다음에는 제가 한 것과 똑같이 직접 눌러 보고, 정말 해결됐는지 확인한 뒤에 알려 주세요.

대화가 너무 길어져 AI가 앞의 내용을 헷갈리는 것 같으면, 지금까지의 상황을 정리해 달라고 한 뒤 새 대화에서 다시 시작하는 것도 좋은 방법입니다.

고치다 더 망가졌을 때 — 되돌리기

잘 되던 앱이 고치다가 더 망가지는 일도 생깁니다. 이때를 대비해 잘 되는 상태를 저장해 두는 습관이 필요합니다.

✍️ 저장해 두기
지금 상태가 잘 됩니다. 나중에 이 상태로 되돌아올 수 있게 저장해 주세요.
✍️ 되돌리기
방금 고친 뒤로 더 이상해졌습니다. 아까 저장해 둔 잘 되던 상태로 되돌려 주세요.
⚠️ 주의

“안 쓰는 것 다 지워 주세요”처럼 조건으로 지우라고 하면 필요한 파일이나 자료까지 함께 사라질 수 있습니다. 지울 것은 이름으로 정확히 짚어 주세요. 실제 사용자 자료가 들어 있는 곳이라면 더욱 그렇습니다.

바이브코딩에서 자주 만나는 오류와 전하는 법

증상AI에게 이렇게 말하세요
화면이 하얗게 아무것도 안 뜬다“첫 화면이 하얗게만 나옵니다. 화면에 오류 문구가 있으면 찾아서 원인을 알려 주세요.”
버튼을 눌러도 반응이 없다“OO 화면에서 OO 버튼을 누르면 아무 일도 안 일어납니다. 직접 눌러 보고 확인해 주세요.”
저장했는데 새로고침하면 사라진다“글을 저장하고 새로고침하면 없어집니다. 자료가 실제로 어디에 저장되는지 확인해 주세요.”
폰에서만 화면이 깨진다“폰 크기에서 글자가 겹칩니다. 폰 화면 크기로 열어 확인하고 고쳐 주세요.” (캡처 첨부)
배포한 뒤에만 안 된다“내 컴퓨터에서는 되는데 올린 주소에서는 안 됩니다. 배포 환경에서 빠진 설정이 없는지 봐 주세요.”
자료가 많아지니 일부가 안 보인다“자료가 늘어난 뒤로 목록 뒷부분이 안 나옵니다. 한 번에 가져오는 개수에 한도가 있는지 확인해 주세요.”

특히 “배포한 뒤에만 안 된다”는 오류는 바이브코딩에서 아주 흔합니다. 내 컴퓨터에는 있는 설정값(비밀 열쇠 등)이 배포한 서버에는 빠져 있는 경우가 많습니다. 이 차이를 말해 주기만 해도 AI가 금방 원인을 찾습니다.

오류를 줄이는 예방 습관

  • 기능 하나를 만들 때마다 확인하고, 잘 되면 바로 저장합니다.
  • 큰 변경 전에는 “무엇이 바뀌는지 먼저 설명해 주세요”라고 합니다.
  • 실제 사용자 자료가 들어간 뒤에는, 고치기 전에 자료를 내려받아 둡니다.

오류가 해결되지 않을 때 시도할 순서

AI에게 여러 번 말했는데도 같은 오류가 계속된다면, 아래 순서대로 시도해 보세요.

  1. 원인부터 설명하게 합니다. 바로 고치게 하면 같은 방법을 반복하는 경우가 많습니다. “고치지 말고 원인부터 찾아 설명해 주세요”라고 하면 접근이 바뀝니다.
  2. 범위를 좁힙니다. “어제까지는 됐는데 오늘 OO를 바꾼 뒤로 안 된다”처럼 언제부터 안 됐는지 알려 주면 원인을 찾는 범위가 크게 줄어듭니다.
  3. 새 대화에서 다시 시작합니다. 대화가 너무 길면 AI가 앞의 잘못된 시도에 끌려갑니다. 지금까지의 상황을 정리해 달라고 한 뒤, 그 정리를 들고 새 대화를 시작하세요.
  4. 저장점으로 되돌립니다. 고치려다 더 꼬였다면 잘 되던 상태로 돌아가 다른 방법으로 다시 시도합니다.
  5. 기능을 단순하게 바꿉니다. 꼭 그 방식이어야 하는 게 아니라면, “더 단순한 방법으로 같은 결과를 낼 수 없을까요?”라고 물어보세요. 복잡한 기능일수록 오류가 잦습니다.

대부분의 오류는 1~3단계에서 해결됩니다. 5단계까지 와도 안 된다면 그 기능이 지금 도구와 환경에서 무리한 것일 수 있으니, 목표를 조정하는 것도 좋은 판단입니다.

오류는 실패가 아니라 과정입니다

바이브코딩을 처음 하는 분들이 오류를 만나면 “내가 뭘 잘못했나” 하고 위축되곤 합니다. 하지만 오류는 전문 개발자에게도 매일 생기는 일입니다. 중요한 것은 오류가 없는 것이 아니라, 오류를 정확히 전하고 하나씩 해결해 가는 과정입니다. 오히려 오류를 몇 번 해결해 보면 앱이 어떻게 돌아가는지 감이 생기고, 다음부터는 어디를 확인해야 할지 먼저 보이기 시작합니다.

오류를 해결한 뒤에는 “이 오류가 왜 생겼고 어떻게 고쳤는지 한두 줄로 정리해 주세요”라고 요청해 보세요. 그 정리를 CLAUDE.md나 메모에 남겨 두면, 비슷한 오류가 다시 생겼을 때 훨씬 빨리 해결할 수 있고 같은 실수를 반복하지 않게 됩니다.

무엇보다 오류 앞에서 조급해하지 않는 것이 중요합니다. 한 번에 다 고치려 하기보다, 하나를 정확히 고치고 확인하는 차분한 반복이 결국 가장 빨리 앱을 완성하는 길입니다.

오류를 하나 넘을 때마다 앱도, 만드는 사람도 한 뼘씩 자랍니다.

함께 읽으면 좋은 글: 바이브코딩 프롬프트 예시, 바이브코딩 순서 6단계

정리

AI의 완료 보고를 받으면 직접, 특히 폰으로 확인합니다. 문제는 “어디서 + 무엇을 했더니 + 기대 + 실제”로 전하고, 화면 캡처와 오류 문구를 그대로 붙입니다. 하나씩 고치고, 잘 되는 상태는 저장해 두면 망가져도 언제든 돌아올 수 있습니다.

바이브코딩 가이드 — 함께 읽으면 좋은 글