비개발자도 클로드 코드로 쉽게 만드는 AI 웹 서비스

비개발자도 클로드 코드로 쉽게 만드는 AI 웹 서비스 - 기획 및 설계부터 개발 및 배포까지 혼자서 완성하는 AI 웹 실전 가이드
최원재 지음 / 위즈앤북 / 2026년 5월

"북유럽의 소개로 출판사로부터 책을 제공받아 주관적으로 작성한 글입니다"

책상에 올려두고 며칠은 표지만 봤습니다. 기술서라고 하면 대개 화면 캡처나 코드 조각을 크게 박아 두는데, <비개발자도 클로드 코드로 쉽게 만드는 AI 웹 서비스>는 크림빛 바탕에 검정과 주황 두 색만 씁니다. 제목이 네 줄로 쌓여 있고 마지막 줄 옆에 주황색 별 하나가 조용히 찍혀 있어요. 아래쪽에는 Claude Code, Vibe Coding, SpecKit이라고 적힌 동그란 배지 세 개가 나란히 놓였고, 맨 밑에 스탠드와 노트북 일러스트가 작게 들어가 있습니다. 소란스럽게 굴지 않으면서 자리를 하나 마련해 둔 표지였습니다. 혼자 앉아 뭔가 만들어보는 저녁의 그림에 가깝습니다.

북유럽 카페 서평단으로 받은 책인데, 봉투를 열었을 때 든 첫 생각은 '이건 겁주는 책은 아니겠구나'였습니다. 판형은 보통이고 분량도 과하지 않아요. 실습서라면 벽돌처럼 두꺼운 걸 떠올리게 되는데, 손에 쥐고 넘기기에 무리가 없습니다. 그래서 처음 며칠은 실습 없이 그냥 읽었습니다.

앞부분에 개발의 다섯 단계를 전통적 방식과 AI 주도 방식으로 나란히 놓은 표가 나옵니다. 기획, 설계, 개발, 테스트, 배포가 차례로 비교되는데 눈이 오래 간 곳은 맨 아랫줄이었어요. '핵심 역할' 칸에 한쪽은 코드 작성(Coding), 다른 쪽은 지휘(Directing)라고만 적혀 있습니다. 표 하나로 이 책이 하려는 말을 거의 다 해버린 셈입니다. AI의 등장이 개발자의 역할을 '의도 정의, 품질 검증, 운영 책임' 쪽으로 옮기고 있다는 진단이 뒤따르는데, 코드를 만질 일 없는 직장인이 읽어도 남의 이야기로 흘러가지 않았습니다. 회사에서 무언가를 결정하고 그 결정에 이름을 걸어야 하는 자리에 있으면, 저 문장이 어디를 겨냥하는지 자연스럽게 알게 되니까요.

이어지는 대목에서는 AI 시대에도 사람이 필요한 이유를 다섯 가지로 풉니다. 첫 항목의 첫 문장이 이렇습니다.

"AI는 '어떻게(How)'를 잘합니다. 하지만 '왜(Why)'를 스스로 만들지는 못합니다."

사용자가 겪는 불편이 정확히 무엇인지, 여러 해결책 중 왜 하필 이 방향을 택했는지, 성공을 무엇으로 볼 것인지. 이런 질문들은 기술 문제가 아니라 비즈니스 문제이고, 정답을 찾는 일보다는 선택하는 일에 가깝다고 책은 말합니다. 두 번째 이유에서는 맥락 이야기가 나옵니다. 아무 설명 없이 "쇼핑몰 만들어줘"라고 던지면 최소 검증도 어려울 만큼 빈약한 결과물이 나오거나, 쓸데없이 기능만 잔뜩 붙은 물건이 나오기 쉽다고 해요. 예산, 마감, 인력, 리스크 같은 현실의 사정을 모델은 알지 못한다는 지적이 이어집니다. 세 번째와 네 번째로 품질과 보안이 나오면서 요구 수준이 한 단계 올라가는데, 코드를 쓰지 않더라도 코드를 구조적으로 통제할 수 있어야 한다는 대목이 그렇습니다. API 키가 코드에 들어간 채로 저장소에 올라가면 유출은 시간 문제라는 경고도 이 근처에 있고요.

다섯 번째가 제일 좋았습니다. 로그인 버튼을 만들어 달라고 하면 AI는 금세 버튼을 하나 뽑아냅니다. 그런데 쓰는 사람에게 중요한 건 버튼 자체가 아니라 경험이라는 거예요. 어디에서 시선이 멈추는지, 로그인에 실패했을 때 무슨 말을 건네야 하는지 같은 것들. 이런 부분은 코드가 아닌 공감과 관찰의 영역입니다, 라고 저자는 씁니다. 사람을 직접 보고 피드백을 받고 고쳐 나가는 일이지요. 읽으면서 제가 오래 해온 일의 정체가 조금 선명해지는 기분이 들었습니다. 사람의 자리는 없어지는 게 아니라 방향과 품질과 책임 쪽으로 옮겨갈 뿐이라는 것이 이 장의 결론입니다.

책의 한가운데쯤에 중심축이 놓여 있습니다.

2025년 초 바이브 코딩 열풍이 불었을 때 계산기나 Todo 앱은 몇 분 만에 만들어졌고 "이게 정말 되는구나" 하는 감탄이 있었지만, 조금만 복잡해지면 사정이 달라졌다고 합니다. 하나를 고치면 두 개가 뜨고 두 개를 고치면 세 개가 생기는 느낌, 오류를 다 잡아 실행은 됐는데 막상 써 보니 생각과 다르게 움직이는 상황, 수정한 곳이 다른 곳을 건드려서 결국 처음부터 다시 쓰게 되는 결말. 무한 수정 루프라고 부르더군요. 원인 분석은 담백합니다. 인터넷에 사례가 많은 프로그램은 학습이 충분하지만, 회사 사정에 맞춘 재고 관리 시스템 같은 건 똑같은 데이터가 없어서 모델이 비슷해 보이는 것을 확률적으로 골라 임의로 해석해 내놓는다는 겁니다. 여기에 존재하지도 않는 라이브러리 이름을 그럴듯하게 지어내는 할루시네이션까지 겹치고요.

그래서 해법으로 제시되는 게 구체성입니다. 회원가입 기능을 만들어 달라는 말과, 이메일과 비밀번호와 비밀번호 확인 필드를 두고 형식 검증을 걸고 여덟 자 이상으로 제한하며 확인이 어긋나면 입력창 아래에 빨간 안내를 띄우라는 말은 결과가 다르다는 것. 그런데 여기서 저자가 자기 논리에 스스로 딴지를 겁니다. 전문 지식이 없는 사람이 그렇게까지 세밀하게 말할 수 있겠느냐고요. 답은 그 정리 작업조차 AI와 대화하며 만들고, 다듬어진 요구사항을 다시 AI에게 넘긴다는 것이고, 그 과정 자체가 기획이자 설계라고 합니다. 이 흐름에서 SDD, 명세 중심 개발이 등장해요. 코드보다 문서를 먼저 쓰고, 명세에 없는 것은 만들지 않는다는 원칙입니다. 사람용 기획서와 AI용 기획서를 대상과 초점, 형식과 단위로 갈라 비교한 표도 실려 있습니다.

다만 이 대목에서 한 번 멈칫했습니다. 앞에서는 모델이 How에 강하고 Why를 못 만든다고 했는데, 여기서는 사람용 기획서가 How에 치우쳐 있고 AI용 기획서는 What과 Why에 집중해야 한다고 나옵니다. 읽어 보면 층위가 다른 이야기인 걸 알겠지만, 같은 단어가 몇 챕터 사이에서 반대 방향으로 쓰이니 처음 접하는 독자는 앞으로 돌아가 확인하게 될 것 같아요. 표지에 '비개발자도'라고 크게 적어둔 책치고 본문이 요구하는 수준이 만만치 않다는 점도 함께 짚어두고 싶습니다. 저자도 처음에는 낯설고 어려울 거라고 미리 일러두긴 했습니다만.

뒤로 갈수록 손이 바빠집니다. 인증 시스템을 만들고 학습 공간을 붙이고 코드 업로드와 분석 기능을 얹은 뒤 문서 생성까지 이어지는데, 마지막 장의 설명이 특히 담백했습니다. 지금까지 만든 서비스는 제 컴퓨터 안에서만 살아 있고, 밖에서 들어오게 하려면 방화벽을 열고 컴퓨터를 스물네 시간 켜 둬야 하니 실제 운영은 불가능하다는 이야기로 시작해요. 배포를 마쳐야 비로소 누구나 들어올 수 있는 주소가 생긴다는 것. Git은 변경 이력을 관리하는 프로그램이고 GitHub는 그 기록을 인터넷 서버에 두는 소스 코드 전용 클라우드라는 설명, 보내면 Push고 가져오면 Pull이라는 정리에도 군더더기가 없습니다. 가입 화면부터 저장소 만들기까지 캡처에 번호를 붙여 안내하는 방식은 친절합니다. 이런 화면은 개편이 잦아 몇 달 뒤면 책과 달라져 있겠지만, 모르면 AI에게 물어보며 해결한다는 태도를 앞에서 충분히 익혀 뒀다면 그 정도 어긋남은 넘어갈 수 있겠지요.

읽고 나면 태도 쪽이 더 오래 남습니다. 요즘 회사마다 AI 이야기가 넘치고, 나이 좀 있는 직원들은 그 말들 앞에서 조용히 위축되곤 합니다. 이 책이 그 위축을 직접 다루지는 않아요. 대신 사람이 남아야 할 자리를 꽤 구체적으로 그려 보입니다. 무엇을 왜 만들 것인지 정하고, 나온 결과를 검증하고, 잘못됐을 때 책임을 지는 일. 새로 배워야 할 무엇처럼 보이지만 실은 오래 해온 일에 붙은 다른 이름이더군요. 개발을 업으로 삼지 않으면서도 사내에서 작은 도구 하나쯤 만들어보고 싶었던 사람이라면 말이 잘 통할 겁니다. 프롬프트 몇 줄로 끝나는 요령을 기대하고 펴면 도리어 지칠 수 있는 안내서이기도 하고요.

서평단으로 여러 책을 받아 읽어 왔지만 실용서는 늘 조심스러웠습니다. 유행이 지나면 남는 게 없을까 싶어서요. 이 한 권은 도구 이름이 바뀌어도 살아남을 문장을 몇 개 쥐여 줬다는 점에서 값을 했습니다. 의도를 세우고, 만들게 하고, 확인하고, 고친다. 그 순서만큼은 당분간 유효할 것 같습니다.

입추가 지났는데도 낮 볕은 여전히 따갑고, 저녁이 되어서야 겨우 바람이 한 자락 지나갑니다. 여름이 물러갈 준비를 하는 이맘때는 뭔가를 새로 시작하기에 어정쩡한 시기처럼 느껴지기도 하는데, 이런 책은 오히려 그런 계절에 어울립니다. 서두르지 않고 목차 순서대로 따라가다 보면 가을 어귀쯤에는 제 이름으로 된 주소 하나가 인터넷 어딘가에 생겨 있을지도 모르겠습니다.

AI가 대신 짜주는 시대에도 무엇을 왜 만들지는 사람이 정해야 한다는 것을, 열 개 장을 따라가며 조곤조곤 증명해 보이는 안내서.

#비개발자도클로드코드로쉽게만드는AI웹서비스 #최원재 #위즈앤북 #북유럽카페 #서평단 #바이브코딩 #클로드코드 #ClaudeCode #SpecKit #AI웹서비스 #AI개발 #비개발자코딩 #스펙주도개발 #SDD #TDD #직장인공부 #40대공부 #IT도서추천 #실용서추천 #책리뷰