Claude Code를 활용한 시스템 인프라 오케스트레이터 'Lattice' 구축 사례

실용적 조언

Claude Code를 사용하여 복잡한 프로젝트를 진행할 때는 보안 취약점 노출을 줄이기 위해 코드 리뷰 단계를 강화해야 한다.
Proxmox와 같은 가상화 환경에서 커스텀 스케줄러를 실험하고 싶다면 Lattice의 examples/homelab 설정을 참고할 수 있다.

섹션별 상세

작성자는 Claude Code를 활용하여 Proxmox 노드 간의 워크로드 스케줄링을 담당하는 커스텀 오케스트레이터 Lattice를 개발했다. AI 에이전트에게 시스템 설계 의도를 전달하고 코드를 생성하게 하는 '바이브 코딩(Vibe Coding)' 방식을 통해 9년 차 엔지니어의 전문 지식을 인프라 자동화 도구로 구현했다. 현재 이 시스템은 작성자의 개인 미디어 스택을 관리하는 홈랩 환경에서 실제로 작동하고 있다.

AI를 통해 생성된 코드의 양이 약 130,000라인(LOC)에 달하며, 이는 보안 측면에서 매우 넓은 공격 표면을 가진다는 점이 지적됐다. 작성자는 AI가 대량의 코드를 빠르게 작성할 수 있지만, 그만큼 보안 취약점을 검토해야 할 범위가 방대해지므로 실제 운영 환경(Production)에서 바로 사용하는 것은 권장하지 않는다고 밝혔다. 이는 AI 코딩 에이전트가 생산성은 높여주지만 보안 검증의 책임은 여전히 인간에게 있음을 시사한다.

시스템 설계 결정에 대한 논리적 근거를 설명하기 위해 별도의 문서화 작업을 병행하고 있다. AI가 코드를 작성하는 'AI 공격(AI Offense)'적인 측면과 대조적으로, 인간 개발자가 설계 의도와 합리성을 글로 설명하는 과정을 통해 프로젝트의 완성도를 높이려 시도했다. 깃허브 저장소와 함께 제공된 기술 블로그를 통해 구체적인 아키텍처 결정 과정을 공유하며 커뮤니티의 피드백을 유도했다.

용어 해설

바이브 코딩(Vibe Coding): — 개발자가 엄격한 설계나 명세 대신 AI 에이전트에게 대략적인 의도와 방향성(vibe)을 전달하며 상호작용을 통해 코드를 생성해 나가는 개발 방식이다. AI의 추론 능력에 의존하여 복잡한 로직을 빠르게 구현할 수 있게 해주며, 최근 Claude Code와 같은 도구의 등장으로 주목받고 있다.
오케스트레이터(Orchestrator): — 여러 컴퓨팅 노드에 걸쳐 워크로드의 스케줄링, 배포, 관리 및 네트워킹을 자동화하는 시스템이다. 본 게시물에서는 Proxmox 노드 간의 작업 부하를 관리하기 위해 직접 구축한 시스템인 Lattice를 의미하며, 복잡한 인프라 자원을 효율적으로 운영하는 핵심 역할을 수행한다.
프록스목스(Proxmox): — 가상 머신과 컨테이너를 관리하기 위한 오픈소스 가상화 관리 플랫폼이다. 서버 하드웨어 자원을 가상화하여 효율적으로 분할 사용할 수 있게 해주며, 홈랩(Homelab)이나 소규모 데이터센터 환경에서 인프라 구축의 기반으로 널리 사용된다.

언급된 도구

Claude Code추천

AI 기반 자율 코딩 에이전트 및 CLI 도구

Lattice중립

Proxmox 노드용 커스텀 워크로드 오케스트레이터

Proxmox추천

가상화 및 컨테이너 관리 플랫폼

언급된 리소스

GitHubLattice GitHub Repository

문서Lattice Design Decisions & Rationale