클로드 코드로 개인 AI 에이전트 구축하기: 위즈(Wiz) 6개월간의 교훈

한 개발자가 Claude Code를 개발 환경이자 런타임으로 사용하여 개인 AI 에이전트인 Wiz를 구축한 6개월 간의 여정을 공유했습니다. 이 프로젝트는 야심찬 "아이언맨의 자비스" 비전으로 시작했지만, 실용적인 일상 사용 시스템으로 진화했습니다.

Wiz가 실제로 하는 일

Wiz는 Claude Code 위에 구축된 개인 AI 에이전트로, 일상적인 작업을 자율적으로 실행합니다. 이 시스템은 아침 보고서, 저녁 요약, 이메일 분류 및 다양한 실험을 처리합니다. 창의적이거나 품질에 민감한 작업의 경우 개발자가 직접 개입합니다.

기술적 구현

아키텍처는 의도적으로 단순하게 설계되었습니다:

• Claude Code가 하네스/프레임워크 역할을 합니다
• CLAUDE.md 파일에 지침이 담겨 있습니다
• 메모리는 마크다운 파일에 저장됩니다
• 도구는 폴더 내 스크립트로 구현됩니다

Claude Code를 통한 개발 과정

개발자는 프로젝트 전반에 걸쳐 Claude Code를 광범위하게 사용했습니다:

• /init 명령어로 첫 CLAUDE.md 파일을 한 번에 생성했습니다
• 디버깅이 필요할 때는 오류를 Claude Code에 붙여넣어 진단을 받았습니다
• Claude Code가 대부분의 코드를 작성했으며, 개발자는 각 파일을 검토하고 문제를 수정했습니다

주요 실수와 교훈

개발자는 문제를 일으킨 9가지 구체적인 실수를 확인했습니다:

• Claude가 첫 CLAUDE.md를 신중한 검토 없이 생성하도록 내버려 둠 - 단 한 문장의 잘못된 표현으로 인해 수시간의 디버깅을 초래했습니다
• 자기 개선 기능이 가드레일 없이 핵심 지침을 재작성하도록 허용함 - 시스템이 여러 방향으로 표류하게 만들었습니다
• 모든 작은 질의에 Opus를 사용하여 점심 전에 사용 한도에 도달함 - 모델 라우팅을 구현하여 해결했습니다(간단한 작업에는 작은/로컬 모델, 일반 작업에는 Sonnet, 복잡한 호출에는 Opus 사용)
• 첫날부터 "자비스"를 구축하려고 시도함 - 약 3개월의 개발 시간을 낭비했습니다
• 모든 파이프라인의 모든 단계에 LLM 호출을 포함시킴 - 대부분은 일반 스크립트여야 했습니다

실용적인 시작점

개발자는 야심찬 시스템보다는 작고 기능적인 에이전트로 시작할 것을 권장합니다. 밤새 도착한 이메일을 읽고 한 단락의 아침 요약을 작성하는 것을 첫 프로젝트로 제안합니다.

전체 글에는 첫 번째 에이전트 구축에 대한 단계별 안내와 9가지 실수에 대한 상세 내용이 포함되어 있습니다. 개발자는 Wiz가 공개적으로 출시되는 것이 아닌 개인 프로젝트로 남아 있음을 밝혔습니다.