이것이 스프링 AI다: Claude는 써봤는데, Spring AI로 어떻게 서비스로 만들까?

서평단 활동 소개
"한빛미디어 서평단 <나는리뷰어다> 활동을 위해서 책을 협찬 받아 작성된 서평입니다."

이것이 Spring AI다

 

 

Spring AI 배우기 전! Claude, Codex CLI 만 사용했어요.

이번 4월에 리뷰로 읽은 책은『이것이 스프링 AI』입니다. 단순히 AI를 “사용하는 방법”이 아니라, 실제 서비스에 어떻게 녹여낼 수 있는지를 다루는 책이라는 점에서 개인적으로 기대가 컸습니다. 무엇보다 Java를 다시 공부하고 싶었어요...

 

저는 기존에 Java와 Spring 기반으로 백엔드 개발을 준비해왔습니다. 최근에는 Java를 아예 사용한지 3달... 되가지만! Claude나 ChatGPT 같은 생성형 AI도 적극적으로 활용하고 있습니다. 특히 여러 프롬프트 도구 중에서도 Claude CLI 환경에서 Sonnet 4.7 모델을 주로 사용하고 있으며, 회사에서는 Anthropic API Key를 통해 사용한 토큰만큼 비용을 지불하는 방식으로 AI를 활용하고 있습니다.

 

먼저, 백엔드는 FastAPI 이고, 프론트엔드는 React.js, Next.js, TypeScript입니다. 주로 사용하는 목적은 제가 상대적으로 익숙하지 않은 프론트엔드 개발 영역을 보완하기 위함이었습니다. 예를 들어, UI 구성이나 간단한 인터랙션 로직, 코드 구조 설계 같은 부분을 Claude에게 요청하면서 생산성을 높이는 방식으로 활용해왔습니다. 이 과정에서 확실히 느낀 점은, AI를 잘 활용하면 개발 속도 자체는 굉장히 빨라진다는 것이었습니다.

 

다만 현실적인 문제도 존재했습니다. Claude를 계속 사용하다 보니 토큰 비용이 점점 부담되기 시작했고, 이를 해결하기 위해 저는 비용 최적화 방법도 함께 고민하게 되었습니다. 그 결과, Skill이나 별도의 .md 파일 기반 최적화 없이, z.ai라는 프롬프트 도구를 병행 사용하면서 월 평균 약 40달러 정도 발생하던 비용을 0달러 수준까지 줄일 수 있었습니다. 대신 그 대가로 응답 속도가 상당히 느리다는 단점을 감수해야 했습니다.

 

이처럼 저는 이미 AI를 “잘 사용하는 환경”에는 어느 정도 익숙해진 상태였습니다. 하지만 여기서 명확한 한계를 느끼게 되었습니다.

AI를 사용하는 것은 가능하지만, 이것을 실제 서비스 기능으로 구현하는 것은 완전히 다른 문제였기 때문입니다. 예를 들어 Claude를 통해 텍스트를 생성하거나 아이디어를 얻는 것은 쉬웠지만, 이를 특정 데이터와 연결하거나, 사용자별 상태를 유지하거나, 구조화된 결과로 변환해서 실제 서비스 로직에 녹여내는 것은 전혀 다른 영역이었습니다.

 

결국 저는 다음과 같은 고민을 하게 되었습니다.

• AI를 “사용”하는 것을 넘어서
• AI를 “서비스 안에 넣으려면” 어떻게, 무엇을 해야 할까? 

이 지점에서 『이것이 스프링 AI』라는 책이 정확히 제가 필요로 했던 방향의 내용을 담고 있었고, 단순한 호기심이 아니라 실무적인 필요에 의해 이 책을 읽게 되었습니다. 

Claude는 ‘사용’, Spring AI는 ‘구현’

이 책을 읽으면서 가장 크게 느낀 점은 Spring AI의 사용 목적에 대한 이해였습니다. Claude나 ChatGPT는 이미 완성된 AI 서비스이고, 우리는 그것을 “사용”하는 입장입니다. 반면 Spring AI는 그 AI를 내 서비스 안으로 가져와서 “구현”하는 도구입니다. 단순히 API를 호출하는 수준을 넘어서, 데이터 흐름을 설계하고, 결과를 가공하고, 서비스 로직과 결합하는 과정까지 포함됩니다. 이 차이를 이해하는 것만으로도 이 책의 가치는 충분하다고 느꼈습니다.

 

책의 구성은 프로젝트 형식으로 개발을 하는 것이 아니라, Spring AI에서 제공하는 핵심 기능 소개와 활용 방법에 대해 배울 수 있습니다. 처음에는 Chat Model API와 프롬프트 엔지니어링부터 시작해서, 점점 구조화된 출력, 음성 및 이미지 처리 같은 멀티모달 영역으로 확장됩니다. 특히 인상 깊었던 부분은 구조화된 출력과 관련된 내용이었습니다. 단순히 AI가 텍스트를 반환하는 것이 아니라, 이를 List나 객체 형태로 변환해서 실제 백엔드 코드에서 사용할 수 있도록 만드는 과정은 실무적으로 매우 중요한 부분이라고 생각합니다. 진짜 입 코딩이 가능한 시대가 곧 다가온다는 것을 크게 느낄 수 있었습니다...

 

중반부로 가면서는 임베딩과 벡터 저장소, 그리고 RAG(Retrieval-Augmented Generation) 구조를 다룹니다. 이 부분은 요즘 AI 서비스에서 거의 필수적인 요소라고 생각되는데, 단순 개념 설명이 아니라 실제 구현 흐름까지 이어진다는 점이 좋았습니다. 특히 다양한 문서(PDF, HTML 등)를 기반으로 답변을 생성하는 구조를 직접 구현해볼 수 있다는 점에서 실무 적용 가능성이 높다고 느꼈습니다. 

멀티 에이전트까지, 생각보다 훨씬 깊이 들어간다

가장 핵심이라고 느낀 멀티 에이전트

 

후반부의 에이전트와 멀티 에이전트 파트는 이 책의 핵심이라고 생각합니다. 아직까지 Single Claude Agent로만 사용하고 있었는데, 이번 기회를 통해서 멀티 에이전트의 개념부터 이해까지 공부할 수 있어서 가장 인상 깊었어요. 특히 여행 추천, 맛집 추천 같은 도메인 예제를 통해 실제 서비스 형태로 발전하는 과정을 볼 수 있었던 점이 인상적이었습니다. 멀티 에이전트에서는 오케스트레이터를 중심으로 여러 에이전트가 협업하는 구조까지 다루는데, 이 부분은 단순한 기능 구현을 넘어 아키텍처 설계에 대한 감각을 키워주는 내용이라고 느꼈습니다.

AI를 ‘쓰는 단계’에서 ‘만드는 단계’로

이 책을 읽기 전에는 AI를 단순히 “도구”처럼 사용하는 데 익숙한 상태였습니다. 필요할 때 요청하고, 결과를 받아서 활용하는 정도였죠. 그런데 책을 읽고 나서는 생각이 많이 바뀌었습니다. 이제는 AI를 하나의 기능이 아니라, 서비스 안에 포함되어야 하는 구성 요소로 봐야 한다는 느낌이 들었습니다.

 

단순히 Chat API를 호출하는 것을 넘어서 데이터와 연결하고, 사용자 상태를 관리하고, 여러 흐름을 조합해서 기능을 만들어내는 과정이 결국 진짜 AI 개발이라는 걸 조금씩 이해하게 된 것 같습니다. 이 책은 특히 저처럼 Spring Boot 기반으로 개발을 해온 사람들에게 잘 맞는 책이라고 느꼈습니다. Python 중심의 AI 책들과는 다르게, 익숙한 Spring 구조 안에서 AI를 다루다 보니 생각보다 훨씬 빠르게 이해할 수 있었고, 부담도 적었습니다. 또 단순히 기능 하나를 설명하고 끝나는 방식이 아니라, 점점 확장해 나가면서 실제 서비스 구조로 이어질 수 있게 구성되어 있어서 “이걸 나중에 프로젝트로 만들어볼 수도 있겠다”는 생각이 자연스럽게 들었습니다.

 

정리해보면, 이 책은 AI를 한 번 써보는 수준을 넘어서 직접 만들어보고 싶은 사람들에게 방향을 잡아주는 책이라고 생각합니다. 특히 Claude나 ChatGPT를 이미 사용해봤지만, 이걸 어떻게 서비스로 연결해야 할지 막막했던 분들이라면 저처럼 꽤 많은 힌트를 얻을 수 있을 것 같습니다.

DocumentReader

책을 읽으면서 일부 기능은 직접 구현도 해봤습니다. Spring AI에서 제공하는 DocumentReader 기능을 활용해서 JSON 데이터를 읽어와 Document 형태로 변환하는 간단한 구조를 만들어봤습니다. 처음에는 이 기능이 Python 쪽에서 많이 쓰이는 개념이라서, 그냥 파일을 읽는 정도겠지… 라고 가볍게 생각했었습니다.

 

그런데 막상 구현해보니, 이 과정이 단순한 파일 처리라기보다는 이후 RAG나 벡터 저장소로 이어지는 데이터 전처리의 시작 단계라는 걸 체감할 수 있었습니다. 작은 기능 하나였지만, “아, 이런 식으로 AI 서비스가 구성되는구나”라는 흐름이 연결되면서 이해도가 확실히 올라가는 경험이었습니다.

 

마지막으로 이 책을 통해 가장 분명하게 정리된 부분이 하나 있습니다!!

 

Spring AI는 Claude CLI처럼 “프롬프트를 입력해서 결과를 받는 도구”가 아니라, AI를 실제 서비스 안에 구현하기 위해 사용하는 프레임워크라는 점입니다. 처음에는 비슷한 영역이라고 생각했지만, 직접 책을 따라가면서 느낀 건 완전히 다른 성격이라는 것이었습니다. Claude는 개발을 도와주는 강력한 도구라면, Spring AI는 그 AI 기능을 내 서비스 안에 녹여내기 위한 기반이라고 보는 게 더 맞는 것 같습니다. 그래서 이 책은 단순히 AI를 잘 쓰는 방법을 알려주는 책이 아니라, AI를 활용한 서비스를 직접 만들어보고 싶은 사람들을 위한 출발점에 더 가깝다고 느꼈습니다.

 

특히 저처럼!

• Claude나 ChatGPT는 이미 사용해봤지만,
• 그래서 Spring AI는 어떠한 차이를 갖고 서비스와 연결하는지 궁금한 개발자!
• Spring AI에서 제공하는 핵심 기능은 무엇인지 배우고 싶은 개발자!

이 책을 통해 방향을 잡는 데 큰 도움이 될 수 있을 것 같습니다. 완전히 깊게 들어가기 전에 한 번 전체 구조를 경험해보고 싶은 분들, 그리고 AI를 “사용하는 단계”에서 “서비스에 구현하는 단계”로 넘어가고 싶은 분들에게이 책을 추천하고 싶습니다.

2. 학습에 도움되는 참고 사항

이것이 Spring AI다 | 신용권 - 교보문고

이것이 Spring AI다