클로드가 어떻게 움직이는지, 책 한권에 다 있었다
클로드 코드가 알아서 파일 찾고 도구 골라 쓰는 거, 매번 신기하다고만 생각하고 넘어갔었다. 근데 그 원리를 통째로 책 한 권에 풀어놓고 깃허브에 공개한 사람이 있더라. 별이 2만4천 개 넘게 붙었다.
이름은 ai-agent-book. 이보제라는 사람이 쓴 《深入理解 AI Agent》(AI 에이전트 깊이 이해하기)라는 전자책인데, 책 전체를 깃허브에 그냥 다 올려놨다. PDF나 EPUB로 내려받아 읽어도 되고, 온라인 페이지에서 검색까지 걸어가며 봐도 된다.
처음엔 그냥 이론서겠거니 하고 넘기려다가, 목차에 있는 공식 하나 보고 멈췄다. '에이전트 = LLM(클로드 같은 AI 모델) + 컨텍스트(지금까지 대화 맥락을 기억하는 부분) + 도구(파일 읽기·검색처럼 실제로 뭘 할 수 있게 해주는 기능)'. 이 세 가지 조합 하나로 10개 챕터를 다 풀어간다. 근데 더 눈에 띈 건 이론만 있는 게 아니라 실습 코드가 93개나 딸려 있다는 거였다. 그중 70개 넘는 건 따로 떼서 바로 돌려볼 수 있게 짜놨다더라. 이론 한 챕터 읽고 끝나는 게 아니라, 바로 옆에 손으로 만져볼 수 있는 코드가 붙어 있는 구조다.
책만 있었으면 그냥 즐겨찾기 해두고 안 열어봤을 텐데, 이 실습 코드 뭉치를 통째로 Claude Code에 던져보니까 얘기가 달라졌다. 레포를 클론해서 챕터 폴더 하나를 열고 '이 코드 실행해서 뭐 하는 건지 하나씩 설명해줘'라고 시키면, 클로드가 코드를 실제로 돌리면서 지금 뭘 하고 있는 건지 옆에서 계속 설명해준다. 예전엔 에이전트 원리 궁금하면 블로그 여기저기 뒤져서 읽고 이해한 건지 만 건지 애매하게 넘어갔는데, 이제는 코드가 돌아가는 걸 직접 보면서 설명을 들으니 훨씬 명확하게 남는다.
주말에 사이드로 뭔가 에이전트 비슷한 걸 만들다가 '컨텍스트를 대체 어떻게 관리해야 하나' 싶어서 며칠 헤맨 적이 있는데, 그때 이 책 컨텍스트 챕터 코드를 클로드랑 같이 한 줄씩 읽었으면 시간을 꽤 아꼈겠다 싶더라. 이론만 봤으면 흘려 읽고 말았을 텐데, 코드가 실제로 실행되는 걸 보면서 왜 이렇게 짰는지 클로드한테 되물으니까 그제야 감이 잡혔다.
책은 눈으로 읽으면 거기서 끝나지만, 옆에 돌아가는 코드가 있으면 읽은 게 머리에 남는다.
원문은 중국어인데 영어, 일본어, 러시아어까지 포함해서 9개 언어로 번역이 돼 있다. 그것도 저자 혼자가 아니라 여러 사람이 나눠서 번역해 올린 거더라. 에이전트 뭐라도 만들어보다가 원리 몰라서 막힌 적 있는 사람, 어느 부분에서 제일 헷갈렸나 궁금하다. 나는 컨텍스트 관리가 아직도 제일 헷갈린다.
출처: GitHub — ai-agent-book
[댓글 @goodtek_xyz]
컨텍스트 관리가 진짜 본게임이죠 ㅎㅎ
[댓글 @flowoodzx]
93개 실습 코드가 진짜 핵심이네요 컨텍스트 관리 챕터 저도 궁금한게 압축 타이밍인데 언제 요약해서 넘기고 언제 그냥 다 들고 가야하는지 그 기준이 항상 애매하더라구요
[댓글 @ajs6888]
原来它不是在玄学找文件啊
