바이브코딩에서 디버깅(오류 고치기)의 핵심은 코드를 읽는 것이 아니라 문제를 정확하게 전하는 것입니다. “어디서, 무엇을 했더니, 원래 기대한 것과 달리, 실제로 무슨 일이 일어났는지” 네 가지만 말하면 AI가 대부분의 오류를 스스로 찾아 고칩니다. 이 글에서는 오류를 발견하는 법, 전하는 법, 그리고 고치다 더 망가졌을 때 되돌리는 법을 설명합니다.
AI의 “다 됐습니다”는 시작일 뿐입니다
바이브코딩을 하다 보면 AI가 “기능을 모두 완성했습니다!”라고 보고했는데, 막상 열어 보면 버튼이 안 눌리는 경우를 자주 만납니다. AI가 거짓말을 한 것은 아닙니다. 코드를 쓰고 나서 “이 정도면 될 것”이라고 판단한 것뿐입니다. 실제로 사람이 눌러 보기 전에는 아무도 모릅니다.
그래서 AI의 완료 보고를 받으면 아래 네 가지를 직접 확인하세요.
- 첫 화면이 제대로 뜨나요?
- 버튼을 누르면 원하는 일이 일어나나요?
- 저장한 뒤 새로고침해도 내용이 남아 있나요?
- 폰에서 열어도 화면이 깨지지 않나요?
특히 폰 확인이 중요합니다. 컴퓨터에서는 멀쩡한데 폰에서 한글이 세로로 한 글자씩 쌓이거나, 화면이 옆으로 밀려 가로 스크롤이 생기는 일이 아주 흔합니다.
오류를 전하는 네 가지 공식
“안 돼요”라고만 하면 AI도 어디가 문제인지 찾아 헤맵니다. 병원에서 “아파요”보다 “어제 저녁부터, 계단을 오를 때, 오른쪽 무릎이 아파요”라고 해야 진단이 빠른 것과 같습니다.
어디서 + 무엇을 했더니 + 원래 기대한 것 + 실제로 일어난 일
회원 목록 화면에서(어디서) "엑셀로 내려받기"를 눌렀더니(무엇을 했더니) 파일이 내려받아져야 하는데(기대) 아무 반응이 없습니다(실제). 컴퓨터에서는 되고 폰에서만 안 됩니다.
여기에 두 가지를 더하면 훨씬 빨라집니다.
- 화면 캡처 — 문제가 보이는 화면을 그대로 붙여 넣습니다.
- 오류 문구 그대로 — 빨간 글씨나 경고창이 떴다면 그 문구를 고치지 말고 그대로 복사해 붙입니다. 그 한 줄이 원인을 찾는 가장 큰 단서입니다.
“어디서만 안 되는가”가 큰 단서입니다
같은 기능이 어떤 환경에서는 되고 어떤 환경에서는 안 된다면, 그 차이를 꼭 알려 주세요.
- 컴퓨터에서는 되는데 폰에서는 안 된다
- 내 컴퓨터에서는 되는데 인터넷에 올린 뒤(배포 후)에는 안 된다
- 처음에는 되다가 자료가 많아지니 일부가 안 보인다
예를 들어 마지막 경우는 무료 데이터베이스가 한 번에 가져오는 자료 수에 한도가 있어서 목록이 조용히 잘리는 일일 수 있습니다. 이런 차이를 말해 주면 AI가 원인을 훨씬 빨리 좁힙니다.
한 번에 하나씩 고치기
고칠 것이 열 가지라도 한꺼번에 말하지 마세요. AI가 몇 가지를 빠뜨리거나, 하나를 고치다 다른 곳을 망가뜨리기 쉽습니다. 가장 중요한 것 하나를 고치고, 확인하고, 다음으로 넘어가는 것이 결국 가장 빠릅니다.
같은 오류가 계속 반복될 때
AI가 고쳤다고 하는데 같은 문제가 계속되면 접근을 바꿔 보세요.
바로 고치지 마시고, 왜 이 문제가 생기는지 원인부터 찾아서 쉬운 말로 설명해 주세요. 원인을 확인한 다음에 고쳐 주세요.
고친 다음에는 제가 한 것과 똑같이 직접 눌러 보고, 정말 해결됐는지 확인한 뒤에 알려 주세요.
대화가 너무 길어져 AI가 앞의 내용을 헷갈리는 것 같으면, 지금까지의 상황을 정리해 달라고 한 뒤 새 대화에서 다시 시작하는 것도 좋은 방법입니다.
고치다 더 망가졌을 때 — 되돌리기
잘 되던 앱이 고치다가 더 망가지는 일도 생깁니다. 이때를 대비해 잘 되는 상태를 저장해 두는 습관이 필요합니다.
지금 상태가 잘 됩니다. 나중에 이 상태로 되돌아올 수 있게 저장해 주세요.
방금 고친 뒤로 더 이상해졌습니다. 아까 저장해 둔 잘 되던 상태로 되돌려 주세요.
“안 쓰는 것 다 지워 주세요”처럼 조건으로 지우라고 하면 필요한 파일이나 자료까지 함께 사라질 수 있습니다. 지울 것은 이름으로 정확히 짚어 주세요. 실제 사용자 자료가 들어 있는 곳이라면 더욱 그렇습니다.
바이브코딩에서 자주 만나는 오류와 전하는 법
| 증상 | AI에게 이렇게 말하세요 |
|---|---|
| 화면이 하얗게 아무것도 안 뜬다 | “첫 화면이 하얗게만 나옵니다. 화면에 오류 문구가 있으면 찾아서 원인을 알려 주세요.” |
| 버튼을 눌러도 반응이 없다 | “OO 화면에서 OO 버튼을 누르면 아무 일도 안 일어납니다. 직접 눌러 보고 확인해 주세요.” |
| 저장했는데 새로고침하면 사라진다 | “글을 저장하고 새로고침하면 없어집니다. 자료가 실제로 어디에 저장되는지 확인해 주세요.” |
| 폰에서만 화면이 깨진다 | “폰 크기에서 글자가 겹칩니다. 폰 화면 크기로 열어 확인하고 고쳐 주세요.” (캡처 첨부) |
| 배포한 뒤에만 안 된다 | “내 컴퓨터에서는 되는데 올린 주소에서는 안 됩니다. 배포 환경에서 빠진 설정이 없는지 봐 주세요.” |
| 자료가 많아지니 일부가 안 보인다 | “자료가 늘어난 뒤로 목록 뒷부분이 안 나옵니다. 한 번에 가져오는 개수에 한도가 있는지 확인해 주세요.” |
특히 “배포한 뒤에만 안 된다”는 오류는 바이브코딩에서 아주 흔합니다. 내 컴퓨터에는 있는 설정값(비밀 열쇠 등)이 배포한 서버에는 빠져 있는 경우가 많습니다. 이 차이를 말해 주기만 해도 AI가 금방 원인을 찾습니다.
오류를 줄이는 예방 습관
- 기능 하나를 만들 때마다 확인하고, 잘 되면 바로 저장합니다.
- 큰 변경 전에는 “무엇이 바뀌는지 먼저 설명해 주세요”라고 합니다.
- 실제 사용자 자료가 들어간 뒤에는, 고치기 전에 자료를 내려받아 둡니다.
오류가 해결되지 않을 때 시도할 순서
AI에게 여러 번 말했는데도 같은 오류가 계속된다면, 아래 순서대로 시도해 보세요.
- 원인부터 설명하게 합니다. 바로 고치게 하면 같은 방법을 반복하는 경우가 많습니다. “고치지 말고 원인부터 찾아 설명해 주세요”라고 하면 접근이 바뀝니다.
- 범위를 좁힙니다. “어제까지는 됐는데 오늘 OO를 바꾼 뒤로 안 된다”처럼 언제부터 안 됐는지 알려 주면 원인을 찾는 범위가 크게 줄어듭니다.
- 새 대화에서 다시 시작합니다. 대화가 너무 길면 AI가 앞의 잘못된 시도에 끌려갑니다. 지금까지의 상황을 정리해 달라고 한 뒤, 그 정리를 들고 새 대화를 시작하세요.
- 저장점으로 되돌립니다. 고치려다 더 꼬였다면 잘 되던 상태로 돌아가 다른 방법으로 다시 시도합니다.
- 기능을 단순하게 바꿉니다. 꼭 그 방식이어야 하는 게 아니라면, “더 단순한 방법으로 같은 결과를 낼 수 없을까요?”라고 물어보세요. 복잡한 기능일수록 오류가 잦습니다.
대부분의 오류는 1~3단계에서 해결됩니다. 5단계까지 와도 안 된다면 그 기능이 지금 도구와 환경에서 무리한 것일 수 있으니, 목표를 조정하는 것도 좋은 판단입니다.
오류는 실패가 아니라 과정입니다
바이브코딩을 처음 하는 분들이 오류를 만나면 “내가 뭘 잘못했나” 하고 위축되곤 합니다. 하지만 오류는 전문 개발자에게도 매일 생기는 일입니다. 중요한 것은 오류가 없는 것이 아니라, 오류를 정확히 전하고 하나씩 해결해 가는 과정입니다. 오히려 오류를 몇 번 해결해 보면 앱이 어떻게 돌아가는지 감이 생기고, 다음부터는 어디를 확인해야 할지 먼저 보이기 시작합니다.
오류를 해결한 뒤에는 “이 오류가 왜 생겼고 어떻게 고쳤는지 한두 줄로 정리해 주세요”라고 요청해 보세요. 그 정리를 CLAUDE.md나 메모에 남겨 두면, 비슷한 오류가 다시 생겼을 때 훨씬 빨리 해결할 수 있고 같은 실수를 반복하지 않게 됩니다.
무엇보다 오류 앞에서 조급해하지 않는 것이 중요합니다. 한 번에 다 고치려 하기보다, 하나를 정확히 고치고 확인하는 차분한 반복이 결국 가장 빨리 앱을 완성하는 길입니다.
오류를 하나 넘을 때마다 앱도, 만드는 사람도 한 뼘씩 자랍니다.
함께 읽으면 좋은 글: 바이브코딩 프롬프트 예시, 바이브코딩 순서 6단계
정리
AI의 완료 보고를 받으면 직접, 특히 폰으로 확인합니다. 문제는 “어디서 + 무엇을 했더니 + 기대 + 실제”로 전하고, 화면 캡처와 오류 문구를 그대로 붙입니다. 하나씩 고치고, 잘 되는 상태는 저장해 두면 망가져도 언제든 돌아올 수 있습니다.
바이브코딩 가이드 — 함께 읽으면 좋은 글
- 바이브코딩이란? 뜻과 원리, 장단점까지 한 번에 정리
- 바이브코딩 툴 추천 — 클로드 코드 vs 커서 vs 코덱스, 처음이라면 무엇을 쓸까
- 클로드 코드 사용법 — 데스크탑 설치부터 첫 앱 만들기까지
- 바이브코딩 순서 — 아이디어에서 완성까지 6단계
- 바이브코딩 프롬프트 예시 — AI가 한 번에 알아듣는 요청 쓰는 법
- 바이브코딩 디버깅 — 오류가 날 때 AI에게 말하는 법
- 클로드 코드 CLAUDE.md와 Skills 사용법 — AI에게 원칙을 기억시키는 법
- 챗GPT 이미지 생성 프롬프트 작성법 — 앱·블로그에 쓸 그림 만들기
- 바이브코딩 배포 방법과 보안 주의사항 — 만든 앱을 안전하게 공개하기
- 바이브코딩 사례 — 코딩 없이 만든 교회·사역 앱 8가지
