나만의 AI 서비스 출시를 하루 앞둔 밤이었습니다. 마지막 점검을 하는데, 로그인이 안 됐습니다. 곧장 AI 디버깅에 들어갔지만, 어제까지 멀쩡하던 기능이 꿈쩍도 하지 않았습니다. 등에 식은땀이 흘렀습니다. “여기까지 와서 망하는 건가.” 6개월을 쏟은 프로젝트가 무너지는 줄 알았습니다.
결론부터 말하면, 무사히 출시했습니다. 그리고 그 사고에서 AI로 개발할 때 가장 중요한 디버깅 패턴 하나를 배웠습니다. 이 글은 그 밤의 사고 일지입니다.
AI 디버깅, 코드부터 의심하며 헤맸다
곧장 클로드 AI에게 물었습니다. “로그인이 안 돼. 원인을 찾아줘.” 클로드 AI는 충실하게 코드를 파고들기 시작했습니다. 인증 함수를 의심하고, 토큰 처리를 뜯어보고, 세션 로직을 다시 짰습니다. 그렇게 한참을 헤맸는데 — 코드는 다 정상이었습니다. 고칠 게 없었어요. 시간만 흘렀습니다.
돌이켜보면 당연한 일이었습니다. AI는 제가 보여준 것만 볼 수 있습니다. 대화창에 들어 있는 건 코드뿐이었으니, AI 입장에서는 코드 안에서 답을 찾는 게 최선이었던 거죠. 문제는 진짜 원인이 그 시야 밖에 있었다는 점입니다.
AI 디버깅의 진짜 원인은 ‘코드 밖’이었다
막막함 속에서 코드가 아니라 그 바깥을 보기 시작했습니다. 그리고 범인을 찾았습니다. Supabase 대시보드의 설정 한 칸이었습니다. 인증 관련 설정값 하나가 바뀌어 있었고, 코드는 멀쩡한데 그 설정 때문에 로그인이 막혀 있었던 거죠.
문제는 ‘코드’가 아니라 ‘코드 밖’에 있었습니다. 이걸 깨닫는 순간, 그동안 AI와 함께 코드만 의심하며 보낸 시간이 아깝게 느껴졌습니다.
깨달은 패턴 — AI가 코드부터 의심하면, 코드 밖도 함께 의심하라
이 사고 이후 저는 디버깅 루틴을 바꿨습니다. AI가 버그를 코드 안에서만 찾으려 할 때, 저는 의식적으로 ‘코드 밖’을 함께 점검합니다. 진짜 원인이 숨어 있기 쉬운 영역은 크게 3가지입니다.
| 점검 영역 | 예시 |
|---|---|
| ⚙️ 환경변수 (.env) | 키 누락·오타·환경 불일치 |
| 🌐 DNS · 도메인 설정 | 도메인 연결, HTTPS, 리디렉션 |
| 🎛️ 외부 대시보드 설정 | Supabase·Vercel·결제사 콘솔의 설정값 |
이 세 가지를 코드 디버깅과 병행하면, 버그 잡는 시간이 체감상 절반으로 줄었습니다. AI는 코드를 잘 보지만, 코드 밖 인프라 설정은 의외로 놓치기 쉽습니다. 그 빈틈을 사람이 메워주는 것이죠.
실전 AI 디버깅 3단계 루틴
같은 사고를 두 번 겪지 않으려고, 그날 이후 굳힌 루틴을 단계별로 정리하면 이렇습니다.
1단계 — 타임라인부터 확인합니다. “언제까지 됐고, 언제부터 안 되는가”를 먼저 특정합니다. 코드 배포가 없었는데 기능이 죽었다면, 그 자체가 ‘코드 밖’ 신호입니다. 제 경우에도 마지막 배포와 장애 사이에 코드 변경이 없었다는 사실이 결정적인 힌트였습니다.
2단계 — 안과 밖을 병렬로 점검합니다. AI에게는 “코드에서 의심 지점을 좁혀줘”라고 시키고, 그동안 사람은 환경변수·DNS·외부 대시보드를 차례로 엽니다. 한쪽이 끝나길 기다리지 않고 동시에 진행하는 것이 핵심입니다. 이렇게 역할을 나누면 같은 시간에 두 배의 영역을 커버할 수 있고, 출시 전날처럼 1분이 아까운 상황에서 특히 효과가 큽니다.
3단계 — ‘최근에 바뀐 것’ 목록을 만듭니다. 코드 커밋뿐 아니라 콘솔 설정 변경, 요금제 전환, 키 갱신까지 포함해서요. 버그의 8할은 ‘마지막으로 바뀐 무언가’ 근처에 있었습니다. 이 목록을 통째로 넘겨주면 AI 디버깅의 정확도가 눈에 띄게 올라갑니다.
참고로 이런 사고를 직접 잡아내면 비용도 함께 절약됩니다. 외주였다면 견적이 어땠을지는 시리즈 ③ 외주 8천만 원 vs AI 도구 30만 원 비교에서 다뤘습니다.
한계와 주의사항
물론 모든 버그가 ‘코드 밖’에 있는 건 아닙니다. 진짜 코드 버그도 많습니다. 핵심은 ‘코드만 파기 시작하면, 코드 밖도 동시에 의심하라’는 균형입니다. 한쪽만 파다 시간을 통째로 날리는 일을 막자는 것이지, 코드 점검을 건너뛰자는 게 아닙니다. 특히 인증·결제·배포처럼 외부 서비스에 의존하는 기능일수록 ‘코드 밖’ 가능성을 먼저 떠올리세요. 또 하나, 외부 대시보드를 점검할 때는 설정값을 복사해 AI에게 보여주세요. ‘코드 밖’ 정보를 대화창 안으로 가져오는 순간, AI의 시야도 함께 넓어집니다.
정리
- 출시 D-1 로그인 장애 → AI는 코드만 의심했지만 코드는 정상
- 진짜 원인은 Supabase 대시보드 설정 한 칸 — ‘코드 밖’
- 패턴: AI 디버깅을 시작하면 환경변수·DNS·외부 대시보드도 함께 의심
- 결과: 디버깅 시간 절반 단축
이런 식의 사고 일지를 110페이지, 84개 커밋의 가장 가슴 철렁했던 순간들로 묶어 책 4부에 담았습니다. 무료 1챕터부터 → atmbook.app
여러분도 ‘코드인 줄 알았는데 코드 밖’이었던 경험 있으신가요? 댓글로 들려주세요. 👇
이 시리즈의 다른 글
- ① AI에게 일 시키는 5가지 황금규칙
- ② 코딩 없이 만든 글로벌 앱 moa365
- ③ 외주 8천만 원 vs AI 도구 30만 원
- ④ (현재 글) AI 디버깅, 진짜 원인은 ‘코드 밖’
- ⑤ AI 에이전트를 ‘팀’으로 — 4부서 R&R
*© AI Trend Master | atmbook.app | aitrend.kr*
AITREND.KR News Letter
