추가 비용 없이 Claude Code와 AWS Agent Plugins를 결합한 서버리스 개발 환경 구축

Context

Claude Code의 AWS 제어 기능을 활용하기 위해 Agent Plugins 도입 필요. Anthropic API의 직접 결제 대신 기존 Kiro Pro 구독을 활용한 비용 최적화 설계 요구. 로컬 프록시를 통한 API 라우팅 과정에서 도구 이름 길이 제한 및 아키텍처별 빌드 오류 발생.

Technical Solution

• kiro-gateway를 로컬에 구축하고 ANTHROPIC_BASE_URL 환경 변수를 설정하여 Claude Code의 요청을 Kiro Pro API로 라우팅하는 구조
• Skills, MCP servers, Hooks, References로 구성된 Agent Plugins를 설치하여 AWS 리소스 설계부터 배포까지의 워크플로우 자동화
• deploy-on-aws 플러그인을 통해 분석, 추천, 추정, 생성, 배포로 이어지는 5단계 파이프라인 구축 및 보안 기본값이 적용된 CDK/CloudFormation 코드 생성
• MCP 서버의 긴 도구 이름(71자)이 Kiro API 제한(64자)을 초과하는 문제를 해결하기 위해 요청 시 이름을 단축하고 응답 시 복원하는 투명한 패치 적용
• Apple Silicon 환경에서 guardpycfn 빌드 실패 문제를 해결하기 위해 rustup target add x86_64-apple-darwin 명령으로 타겟 툴체인 추가
• aws-serverless 플러그인의 Hook 기능을 활용하여 template.yaml 수정 시 sam validate가 자동으로 실행되는 실시간 검증 체계 마련

Impact

• 월 10,000회 요청 기준 서버리스 TODO API 예상 비용 약 $0.40/month 산출 (Lambda $0.00, API Gateway $0.30, DynamoDB $0.10)

Key Takeaway

표준 API 프로토콜을 준수하는 게이트웨이 설계를 통해 다양한 LLM 제공자 간의 전환 비용을 낮추고 인프라 제어 권한을 추상화할 수 있는 전략.