Claude Code로 29시간 만에 구축한 AWS 서버리스 AI 에이전트 플랫폼 제작기

실용적 조언

NAT Gateway 대신 퍼블릭 서브넷을 사용하여 네트워킹 비용 절감
ALB 대신 API Gateway를 사용하여 유휴 비용 제거
Lambda Container Image와 S3 세션 유지를 통한 상태 관리

섹션별 상세

Claude Code를 활용한 아키텍처 설계 및 TDD 워크플로를 적용했다. 작성자는 직접 코딩하는 대신 Claude Code와 대화하며 PRD, CDK 스택, 네트워크 설계를 진행했다. Claude Code가 구현 전 테스트 코드를 먼저 작성하게 하여 233개의 유닛 테스트를 확보했다. 이를 통해 복잡한 인프라 구축 과정에서도 코드 품질과 안정성을 유지했다.

극단적인 비용 최적화 전략을 통해 월 운영비를 획기적으로 낮췄다. 월 70달러 이상 소요되는 일반적인 서버리스 구성을 월 0.01달러 수준으로 조정했다. 비싼 NAT Gateway와 ALB를 제거하고 API Gateway와 퍼블릭 서브넷 Fargate를 조합했다. 유휴 비용이 없는 Lambda Container Image를 주력으로 사용하여 비용 효율성을 극대화했다.

서버리스 환경의 콜드 스타트 문제를 기술적으로 해결했다. 초기 68초에 달하던 콜드 스타트 시간을 Docker 최적화와 CPU 튜닝을 통해 1.35초로 단축했다. 컨테이너가 준비되는 동안 발생하는 메시지는 DynamoDB 큐에 저장했다가 준비 완료 후 소비하는 방식을 채택했다. 이를 통해 사용자 경험 저하 없이 서버리스의 비용 이점을 확보했다.

하이브리드 컴퓨팅 및 스마트 라우팅 시스템을 구축했다. 가벼운 작업은 Lambda에서 처리하고 무거운 작업은 Fargate Spot으로 자동 전환되는 구조를 설계했다. S3를 이용해 세션 컨텍스트를 유지함으로써 컴퓨팅 환경이 바뀌어도 대화의 연속성을 보장했다. Claude Code는 이 복잡한 마이그레이션과 라우팅 로직 구현을 대화만으로 완수했다.

용어 해설

서버리스(Serverless): — 서버 관리 없이 코드 실행 시에만 자원을 할당받아 비용을 지불하는 컴퓨팅 방식이다. 인프라 운영 부담을 줄이고 사용량에 비례해 비용을 최적화할 수 있어 효율적이다.
클라우드 개발 키트(AWS CDK): — 프로그래밍 언어를 사용하여 클라우드 인프라를 정의하고 배포할 수 있게 돕는 도구이다. 복잡한 클라우드 설정을 코드로 관리하여 재사용성과 안정성을 높인다.
콜드 스타트(Cold Start): — 서버리스 함수가 비활성 상태에서 처음 실행될 때 컨테이너를 준비하며 발생하는 초기 지연 시간이다. 사용자 경험에 영향을 주므로 최적화가 필수적인 요소이다.
테스트 주도 개발(TDD): — 실제 코드를 작성하기 전에 테스트 케이스를 먼저 만들어 품질을 높이는 개발 방법론이다. 코드의 결함을 조기에 발견하고 리팩터링의 안정성을 보장한다.
파게이트 스팟(Fargate Spot): — AWS의 컨테이너 실행 서비스 중 남는 자원을 활용하여 최대 70% 저렴하게 이용하는 요금제이다. 비용 절감에 유리하지만 자원 회수 가능성이 있어 중단 가능한 작업에 적합하다.

언급된 도구

Claude Code추천

AI 코딩 에이전트 및 아키텍처 설계 보조

AWS Lambda추천

서버리스 컴퓨팅 실행 환경

AWS CDK추천

코드를 통한 인프라 정의 및 배포

Amazon Bedrock추천

다양한 LLM 모델 접근 API