8. 새로운 시작, 압도적인 개발의 자유로움 (부제: AI 바이브 코딩의 함정에 빠지다)

👤 관리자

조회 수 104

들어가며: 텅 빈 도화지 앞에 서다

우분투 노트북 서버에 완벽한 원격(Remote) 개발 환경을 구축하고 VS Code를 열었을 때, 제 눈앞에 펼쳐진 것은 워드프레스의 복잡한 관리자 창이 아닌 그야말로 '텅 빈' 폴더였습니다. 테마의 제약도, 플러그인의 충돌도 없는 완벽한 자유. 하지만 그 압도적인 자유로움은 곧바로 뼈저린 막막함으로 다가왔습니다. "그래서, 이제 여기서부터 뭘 어떻게 시작해야 하지?" 자유에는 언제나 그만큼의 책임과 설계 능력이 필요하다는 것을 깨닫는 순간이었습니다.

1. 나만의 커뮤니티 웹사이트 기획, 그리고 FastAPI의 선택

가볍고 직관적인 FastAPI, 사랑받는 이유가 있다.

<가볍고 직관적인 FastAPI, 사랑받는 이유가 있다.>

제가 만들고 싶은 것은 단순한 블로그가 아니라, 유저들이 서로 소통하고 랭킹을 겨루거나 자료를 공유할 수 있는 **'나만의 커뮤니티 웹사이트'**였습니다.

이 목표를 달성하기 위해 제가 워드프레스(PHP)를 버리고 새롭게 선택한 백엔드 프레임워크는 바로 파이썬(Python) 기반의 FastAPI였습니다.

FastAPI를 선택한 이유: 이름 그대로 실행 속도가 매우 빠르고, 코드가 직관적이라 초보자가 배우기 쉽다는 장점이 컸습니다. 무엇보다 제가 평소 즐겨 쓰는 제미나이나 클로드 같은 AI들이 파이썬 언어에 대한 이해도가 압도적으로 높았기 때문에, AI의 도움을 받으며 개발하기에 최적의 환경이라고 판단했습니다.

</li></ul>

2. 막막함을 뚫어준 AI, 기존 코드를 새 환경으로 이식하다

하지만 파이썬 문법조차 가물가물한 초보가 다짜고짜 웹 서버를 띄울 수는 없었습니다. 저는 고민 끝에, 지난 한 달간 워드프레스 환경에서 코파일럿과 씨름하며 어설프게나마 끄적였던 기존의 코드와 기획안들을 싹 다 긁어모아 AI(제미나이, 클로드)에게 던져주었습니다.

"내가 기존에 이런 느낌으로 게시판과 기능들을 만들려고 했어. 이걸 FastAPI 기반의 파이썬 코드로 완전히 새롭게 번역하고 기본 뼈대를 세워줘."

결과는 놀라웠습니다. AI는 제가 짜놓았던 엉성한 논리를 분석하더니, 순식간에 FastAPI의 구조에 맞게 <code>main.py</code> 파일을 생성하고 서버가 돌아가는 완벽한 초기 환경(Boilerplate)을 뚝딱 만들어 주었습니다. 터미널에 명령어를 입력하고 브라우저에 <code>localhost</code>를 쳤을 때 제가 원하던 기능의 뼈대가 하얀 화면에 나타나는 것을 보며, 저는 다시 한번 "역시 AI가 최고야!"를 외쳤습니다.

3. '바이브 코딩(Vibe Coding)'의 시작, 그리고 찾아온 위기

초기 세팅이 너무 쉽게 끝나자 저는 엄청난 자신감에 휩싸였습니다. 코딩의 작동 원리나 파이썬의 구조를 깊게 공부할 생각은 하지 않고, 그저 머릿속에 떠오르는 아이디어를 AI에게 한국어로 지시하기 시작했습니다.

"여기에 로그인 기능 붙여줘." "게시글 업로드할 때 이미지도 같이 올라가게 수정해 줘." "오른쪽에 유저 랭킹 보드도 하나 추가해 봐."

이렇게 개발자가 코드의 원리를 모른 채 AI의 결과물만 복사하고 붙여넣으며 느낌(Vibe)대로 코딩하는 것을 요즘 말로 **'바이브 코딩(Vibe Coding)'**이라고 부릅니다. 처음 몇 번은 이 바이브 코딩이 기적을 만드는 것 같았습니다.

하지만 기능이 하나둘씩 추가되면서 AI가 결코 만능이 아니라는 무서운 사실을 깨닫게 되었습니다.

4. 사공이 많으면 배가 산으로 간다: 붕괴되는 코드

AI에게 새로운 기능을 요청할 때마다 코드가 이상하게 꼬이기 시작했습니다. 어제 분명히 AI와 함께 완벽하게 구현해 놓았던 '게시글 작성' 버튼이, 오늘 '댓글 기능'을 추가해 달라고 요청한 직후 흔적도 없이 사라져 버렸습니다.

알고 보니 AI는 대화가 길어지고 코드가 방대해질수록 예전의 맥락을 까먹는(Context Window 제한) 치명적인 약점이 있었습니다. 새로운 기능을 끼워 넣기 위해 기존의 멀쩡했던 함수를 자기 마음대로 삭제해 버리거나, 데이터베이스 연결 코드를 임의로 수정해서 아예 서버 자체를 다운시켜 버리기도 했습니다.

바이브 코딩의 한계: 저는 전체적인 시스템 설계도(Architecture)가 없는 상태였고, AI는 전체 숲을 보지 못한 채 제가 요청한 나무 한 그루만 계속 심어대고 있었습니다.

</li></ul>

에러가 나면 또 AI에게 에러 메시지를 복사해 주고, AI가 준 수정본을 넣으면 다른 곳이 터지는 끔찍한 악순환. 코드는 누더기처럼 기워져 괴물이 되어갔고, 제 커뮤니티 웹사이트라는 배는 목적지를 잃고 완전히 산으로 가고 있었습니다.

마치며: 위기를 극복할 새로운 시스템이 필요하다

선장이 필요하다.

<선장이 필요하다.>

압도적인 자유로움을 기대하며 넘어온 FastAPI 환경이었지만, 구조에 대한 이해 없이 AI에게 100% 의존하는 바이브 코딩은 결국 모래 위에 성을 쌓는 것과 같았습니다.

이대로는 한 달이 지나도 제대로 된 웹사이트 하나 완성하지 못할 것이 뻔했습니다. 내가 짠 코드가 어제는 어땠고 오늘은 어떻게 변했는지 안전하게 기록하고, AI가 코드를 망쳐놓더라도 언제든 '정상 작동하던 과거'로 되돌릴 수 있는 명확한 해결책, 즉 **'코드 관리 시스템'**이 절실하게 필요해졌습니다.

지난편 보러가기: 7. 우분투(Ubuntu) 노트북 서버 구축과 완벽한 원격 개발 환경 만들기

다음편 보러가기: 9. 기본부터 다시 하기: 마음을 비우고 FastAPI 서버와 Cloudflare 터널을 뚫다