클로드 코드로 기술 서적 구축하기: 과정과 함정

r/ClaudeAI의 한 개발자가 기존 자료를 찾을 수 없어 중급 Claude Code 기능에 관한 기술 EPUB 책을 만드는 과정을 기록했습니다. 완전한 Claude 과제 파일은 다른 사람들이 활용할 수 있도록 GitHub에서 이용 가능합니다.

책 제작 과정

개발자는 다음과 같은 구체적인 워크플로우를 따랐습니다:

• Claude에게 모든 Anthropic 문서를 참고 자료로 로컬 드라이브에 수집하도록 요청
• Claude, Gemini, Perplexity를 사용해 사람들이 Claude Code를 실제로 어떻게 사용하는지 연구, 특히 프런트 오피스 금융(그들의 분야)에서의 사례
• Claude Code에게 표준 논픽션 구조로 기술 책을 작성하도록 요청: 각 장은 요약으로 시작하고, Anthropic 문서의 기술 기능을 소개한 후, 해당 기능의 실제 적용 사례를 제시하고, 장의 핵심 포인트로 마무리

과정에서 얻은 주요 교훈

개발자는 Claude Code 작업 시 중요한 제약 사항을 발견했습니다:

• 단순히 Claude Code에게 수집한 모든 자료로 책을 쓰라고 요청하면, 모든 내용을 읽고 압축하여 '경계선상으로 멍청하다'고 표현된 평범한 결과물을 생성
• 제약 없이 '에이전트를 사용하라'고 지시하면 장당 하나의 에이전트를 생성하고, 세션 제한에 도달(당시 Pro 플랜 사용 중)하여 모든 에이전트의 작업이 손실됨
• 해결책: Claude에게 한 번에 2-3개 이하의 에이전트만 실행하고, 완료될 때까지 기다린 후 다음 배치를 시작하도록 지시

개발자는 결과물인 책이 약 1.5개월 전 것으로, AI 관련 서적의 수명을 신문에 비유하며 '기본적으로 구식'이라고 언급했습니다.

GitHub 저장소에는 언급된 모든 내용이 포함된 완전한 Claude 과제 파일이 있어 다른 사람들이 바퀴를 다시 발명하지 않고도 자신만의 버전을 구축할 수 있습니다. 개발자는 이 동일한 접근 방식이 어떤 책에도 적용될 수 있다고 언급했습니다 - 자료를 수집하고, 과제를 구성하고, Claude에게 나머지를 맡기면 됩니다.