초보에게도 경험자에게도 모두 유용한 책

클로드 코드 에이전틱 코딩 - 아이디어를 서비스로 만드는 AI 개발 워크플로
이행철 지음 / 한빛미디어 / 2026년 8월

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

어쩌다 보니 책 수집가가 되어버렸다. <클로드 코워크 with 스킬, 플러그인>, <하네스 엔지니어링 with 클로드 코드>, <클로드 올인원 with 코워크, 코드, 디자인>에 이어 <클로드 코드 에이전틱 코딩>

책을 수집하는 것보다 내 것을 빨리 구현해 내는 것이 먼저인데...

내가 잘 못하는 것(1)

무엇을 만들지 정했고, 어떤 기능들을 넣을지까지 대충 정했는데, 막상 붙잡고 만들지 못하고 있었다. 내가 하고 있는 강의들을 좀 더 쉽게 전달하면서도 그동안 등한시(??)했던 수익화까지 챙기는 플랫폼...올해가 가기 전에 기필코 해야지 하고 계속 다짐만 하고 있던 차에 이 책에서 이 제목을 보았다. 뜨악."Chapter 07. 무엇을 만들지 정하고 작업 계획 세우기 - SPEC.md와 PLAN. md"

여기서는 먼저 사용자가 러프한 아이디어를 적고, 클로드 코드에게 인터뷰를 맡겨서 사용자가 질문에 답하며 서비스 개요, 기술 스택, 기능 요구사항, 화면 구성, 에지 케이스, 제외 범위 등이 들어 있는 SPEC.md 초안을 만들고, 이 초안을 클로드 코드에게 검토시킨다. 최종적으로는 사람이 직접 검토하고 확정을 한다.

PLAN은 이미 정한 SPEC과 프로젝트 구조를 바탕으로 클로드 코드가 설계해서 제안하면 사용자가 검토하고 승인하는 방식으로 만든다. 이때 '버티컬 슬라이스 방식'으로 진행할 것을 강조한다. 또 클로드 코드가 범위를 확장해서 스스로 어떤 파일에 어떤 코드를 넣을지 결정해버리지 않도록 구체적인 파일 경로나 구현 방법을 제외하도록 지시한다.

사실 처음부터 끝까지 빠르게 수행해서 어설프게나마 돌아가는 전체의 과정을 경험하고 다시 구체적으로 다듬는 작업을 하도록 하는 건 '학습'을 하거나 '강의'를 할 때도 마찬가지였는데, 막상 내 플랫폼을 만들 때에는 이중 삼중으로 손이 갈까봐 처음부터 너무 구체적인 것까지 결정해 내느라 진도가 나가지 못했었음을 깨달았다. 버티컬 슬라이스 방식을 강조하는 저자의 지침대로 빠르게 진행해 일단은 전체의 구조를 볼 수 있는 사이트를 만들었다. (뿌듯~)

내가 잘 못하는 것(2)

내가 잘 못하는 것 중 또 하나는 '정리, 비우기' 등의 관리이다. "Chapter 16. 클로드 코드를 날카롭게 유지하기 - 컨텍스트와 세션 관리"에서 컨텍스트를 효율적으로 관리하는 방법을 다루고 있다. 이 부분도 나에게는 많은 도움이 되었다. 게다가 이것은 비용과도 직접적인 관계가 있기 때문에도 중요하다.

전체적인 소감으로는, 막 입문하려고 하는 사람에게도 그렇게 어렵지 않고 (설명이 친절하기 때문에 충분히 따라갈 수 있고), 어느 정도 클로드 코드를 사용하고 있는 사람에게도 본인이 일하는 방식을 다시 점검하고 돌아보며 효율을 높이는 방식을 체득하는 데 도움이 되는 책이라고 생각한다.