코딩 에이전트에게 「업로드한 사진을 S3에 저장하는 기능 만들어 줘」라고 시키면 코드는 금방 나와요. 막히는 건 그다음이죠. 제대로 도는지 보려면 진짜 AWS 계정에 키를 넣고, 버킷을 만들고, 요금이 나올까 신경 써야 하거든요. aws-emulator는 AWS가 2026년 11월 11일 공개한 무료 로컬 에뮬레이터로, AWS 계정 없이 내 컴퓨터나 CI에서 S3·DynamoDB 같은 AWS API를 흉내 내 코드를 시험하게 해 주는 프로그램이에요.
에이전트가 「돌려 보고, 틀리면 고치고」를 수십 번 반복해도 청구서가 쌓이지 않는다는 점이 이 도구의 핵심이에요. 다만 모든 테스트를 맡길 수 있는 도구는 아니에요. 어디까지 믿어도 되는지가 이 글의 절반이에요.
AWS가 직접 만든 로컬 에뮬레이터
공식 문서에 따르면 aws-emulator는 화면(GUI)이 없는 프로그램이에요. 실행하면 내 컴퓨터에 AWS API 주소 하나가 열리고, 앱이나 AWS CLI가 진짜 AWS 대신 그 주소로 요청을 보내요. 요청과 리소스 데이터는 AWS로 나가지 않고, 추가 요금도 없어요. 실제로 AWS에 배포할 때 쓰는 리소스 비용만 내면 되는 셈이에요.
라이선스는 CC0-1.0이라 사실상 퍼블릭 도메인에 가까워요(vendor 폴더만 Apache 2.0). 2026년 11월 12일 기준 GitHub 별은 2,951개, 최신 릴리스는 11월 11일에 나온 v1.0.322예요. 11월 8일부터 11일 사이에만 v1.0.265에서 v1.0.322까지 연달아 나왔고, 문서도 업데이트가 하루에 여러 번 나온다고 설명해요.
만든 방식도 화제였어요. About Amazon에 실린 AWS 시니어 수석 엔지니어 매튜 골드버그의 글에 따르면, 이 에뮬레이터는 테스트를 쓰고 이슈를 찾고 고치는 자율 AI 에이전트 팀이 만들었어요. 첫 SQS 버전은 15분쯤, 나머지 AWS를 덮는 프로토타입은 주말 하루가 걸렸다고 해요.

저장소 첫 화면. 마지막 커밋 작성자가 IssueFinderAgent라는 에이전트 이름으로 나와요.
저장소에 들어가 보면 그 말이 화면으로 보여요. 기여자 칸은 비어 있고, 커밋은 약 2만 9,700개예요. 9월에 만든 저장소치고 엄청난 숫자죠. 커밋 메시지도 「fix: cognito-idp-getuser-refuses-a-revoked-access-token」처럼 이슈 이름을 그대로 딴 꼴이 이어져요. 안 되는 기능과 고쳐진 기능을 issues/ 폴더에 나눠 기록해 두니, 내 프로젝트에 필요한 API가 지금 되는지 미리 볼 수 있어요.
지원 범위는 「API 모델이 공개된 AWS 서비스」예요. 서비스 개수는 InfoWorld가 426개, GeekWire가 200개 넘게로 보도마다 다르고, AWS 공식 문서엔 숫자가 없어요. 아직 만들지 않은 작업을 부르면 HTTP 501(NotImplemented)이 돌아와요.
언제 쓰면 좋을까요
잘 맞는 상황은 세 가지예요. 공식 문서가 꼽은 용도와도 겹쳐요.
- 에이전트에게 AWS 코드를 반복해서 돌려 보게 할 때. 버킷을 만들고 지우고, 테이블에 쓰고 읽는 일을 몇십 번 해도 비용과 정리 부담이 없어요. 에이전트가 틀린 설정으로 진짜 리소스를 만들어 둘 걱정도 없죠.
- 프로토타입을 빠르게 만들 때. AWS 계정을 만들기 전, 아이디어가 굴러가는지부터 보고 싶은 단계에 맞아요.
- CI에서 통합 테스트를 돌릴 때. 인스턴스마다 포트·키·메모리 상태가 따로라서 여러 테스트나 여러 에이전트가 동시에 띄워도 서로 간섭하지 않는다고 AWS는 설명해요. 리소스가 메모리에만 있으니 재시작하면 깨끗한 상태로 돌아가요.
반대로 안 맞는 상황도 분명해요. 가장 큰 건 권한 검사예요. 에뮬레이터는 IAM 정책과 리소스 정책을 AWS처럼 평가하지 않아요. 에뮬레이터에서 잘 돌았다고 실제 AWS에서 「Access Denied」가 안 난다는 보장은 없다는 뜻이에요. 보안 테스트에는 쓰지 말라고 문서가 직접 적어 두었어요.
여러 리전을 오가는 구조도 문제예요. 리전과 계정을 나누지 않아서, 리전마다 에뮬레이터를 따로 띄워야 해요. 동작 검증도 us-west-2(글로벌 서비스는 us-east-1)에서만 해요. 장시간 실행과 부하 테스트는 검증되지 않았고요. InfoWorld에 실린 IDC 분석가도 스로틀링이나 장애 같은 상황을 재현하지 못한다는 점을 한계로 짚었어요.

공식 문서의 한계 목록. IAM 정책 미평가, 한 리전·한 계정, 멈추면 리소스 삭제가 적혀 있어요.
정리하면, 「코드가 AWS API를 제대로 부르고 있나」를 볼 때는 쓸 만하고, 「배포하면 정말 안전하게 돌아가나」를 볼 때는 결국 진짜 AWS가 필요해요. 혼자 바이브코딩으로 서비스를 만드는 중이라면 개발 단계는 에뮬레이터로 돌리고, 배포 직전 한 번만 실제 계정에서 확인하는 흐름이 맞아요. 비용은 줄이고 권한 문제는 놓치지 않거든요.
aws-emulator는 어떻게 쓰나요
준비물은 운영체제마다 달라요.
| 환경 | 설치 경로 | 메모 |
|---|---|---|
| Linux (x86_64·aarch64) | RPM·Debian 패키지 | 바로 설치. 대기 메모리 약 160 MiB |
| macOS·Windows | Docker | 미리 만든 이미지 없음. 공식 Dockerfile로 직접 빌드 |
| Rust 프로젝트 | 임베디드 모드 | 테스트 코드 안에서 실행 |
맥에서 작업한다면 Docker 빌드를 손으로 하기보다 에이전트 스킬을 쓰는 편이 훨씬 수월해요. 필요한 건 AWS CLI 2.35.0 이상 하나예요. 버전을 본 뒤 아래 명령 한 줄을 실행하면, AWS CLI가 찾은 코딩 에이전트(Kiro, Cursor, Claude Code 등) 모두에 스킬이 설치돼요. 명령은 에이전트 시작하기 문서에 적힌 그대로예요.
aws --version
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1
스킬은 운영체제에 맞춰 Linux 패키지나 Docker로 에뮬레이터를 설치하고, 실행한 다음 CLI·SDK를 연결해요. 연결·인증서·서명 오류도 고쳐 주고요. sudo를 실행하거나 셸 프로필을 고치는 것처럼 작업 폴더 밖을 건드릴 때는 먼저 물어본다고 문서에 적혀 있어요. 에이전트에게 맡겨도 시스템을 바꾸는 허락은 내가 쥐고 있는 셈이에요.

에이전트 스킬이 해 주는 일 네 가지와 설치 단계. sudo를 쓰기 전에 사용자에게 먼저 묻는다고 적혀 있어요.
스킬을 깔았으면 에이전트에게 이렇게 요청하면 돼요. 문서가 드는 예시는 「Install AWS Emulator and point my project at it.」와 「Will my app in this repo work on AWS Emulator?」 두 가지예요. 한국어로 조금 더 구체적으로 쓰려면 두 갈래로 나눠 요청하면 좋아요.
첫째는 설치와 연결이에요. 에뮬레이터를 깔고 프로젝트를 거기에 붙여 달라고 하면서, 테스트하는 셸에서는 실제 AWS 키 환경 변수를 비우고 연결 뒤 aws sts get-caller-identity 결과를 보여 달라고 덧붙이는 식이에요. 둘째는 점검이에요. 이 저장소가 쓰는 AWS 작업을 찾아, 에뮬레이터에서 믿을 수 있는 부분과 아닌 부분을 나눠 달라고 요청하면 돼요.
두 번째 요청이 특히 쓸 만해요. 스킬은 프로젝트가 쓰는 AWS 작업을 찾아 서비스별 검증 점수(fidelity)와 맞대 보고, 어디까지 믿어도 되는지 알려 줘요. 동작 차이를 찾으면 이슈 초안을 써서 올리기 전에 보여 주고요.
연결이 됐는지는 숫자 하나로 알 수 있어요. aws sts get-caller-identity를 실행했을 때 계정 번호가 000000000000으로 나오면 에뮬레이터에 붙은 거예요. 진짜 계정 번호가 나오면 아직 실제 AWS를 부르고 있다는 뜻이니 바로 멈춰야 해요.
손으로 연결할 때 걸리기 쉬운 부분도 있어요. 기본 주소는 내 컴퓨터(127.0.0.1)의 9297번 포트인데, 주소를 localhost라고 쓰면 S3 요청이 제대로 닿지 않아요. 에뮬레이터는 실행할 때마다 새 키를 만들어 두고, Node.js는 NODE_EXTRA_CA_CERTS, Java는 truststore, Rust와 .NET은 SSL_CERT_FILE로 인증서를 따로 믿게 해 줘야 하고요. 이런 자잘한 설정을 스킬이 대신 잡아 주니, 에이전트로 일하는 사람이라면 스킬 경로가 맞아요.
LocalStack·Floci·moto와 무엇이 다른가
로컬에서 AWS를 흉내 내는 도구는 전에도 있었어요. 긱뉴스에 이 소식이 올라왔을 때도 댓글은 Floci·LocalStack·Moto와 비교하는 이야기로 채워졌어요.
| aws-emulator | LocalStack | Floci | moto | |
|---|---|---|---|---|
| 만든 곳 | AWS | LocalStack | 오픈소스 커뮤니티 | 오픈소스 커뮤니티 |
| 라이선스 | CC0-1.0 | 상용 플랜 | MIT | Apache-2.0 |
| 비용 | 무료 | Hobby 무료(비상업만), Base 월 39달러, Ultimate 월 89달러(연간 결제) | 무료 | 무료 |
| 계정·토큰 | 필요 없음 | 계정·인증 토큰 필요 | 필요 없음 | 필요 없음 |
| 형태 | Rust로 만든 로컬 서버 | Docker 이미지 | Java로 만든 로컬 서버 | Python 테스트용 모킹 라이브러리 |
요금과 별 수는 2026년 11월 12일 기준
LocalStack은 2026년 3월 23일부터 이미지를 하나로 합치면서 인증 토큰이 있어야 쓸 수 있게 바뀌었어요. 무료 플랜도 상업 용도엔 못 써요. 회사 일이나 수익을 내는 서비스라면 이 부분이 걸리죠. 대신 유료 플랜에는 aws-emulator에 없는 IAM 정책 테스트가 들어 있어요. 권한까지 로컬에서 보고 싶다면 아직은 LocalStack 유료 쪽이 답이에요.
Floci는 계정 없이 쓰는 무료 도구로, LocalStack 자리에 그대로 갈아 끼울 수 있다고 소개해요(포트 4566). moto는 2013년부터 이어진 Python 라이브러리라 성격이 조금 달라요. 서버를 띄우는 게 아니라 테스트 코드에 @mock_aws를 붙여 AWS 호출을 가로채는 방식이에요.

로컬 AWS 에뮬레이터 세 가지의 GitHub 별 개수. 공개 시기가 서로 달라요.
별 수만 보면 aws-emulator(2,951개)는 Floci(31,502개)의 10분의 1이 안 돼요. 하지만 Floci는 2026년 2월, moto는 2013년에 저장소가 생겼고, aws-emulator는 공식 공개 후 하루 이틀 지난 숫자예요. 인기보다는 「AWS가 직접 만들고 API 모델에서 출발했다」는 점이 이 도구를 고르는 이유가 될 거예요.
쓰기 전에 알아 둘 것
가장 먼저 볼 건 보안이에요. 공식 보안 문서에 따르면 에뮬레이터는 Lambda 함수 코드 같은 것을 실행할 때 내 컴퓨터와 격리하지 않아요. 내 사용자 권한 그대로 돌아간다는 뜻이에요. 그래서 믿을 수 있는 코드만 넘기고, 실제 자격 증명과 실데이터는 넣지 말라고 해요. IDC 분석가도 샌드박스가 없는 점을 보안 위험으로 꼽았어요.
Docker로 띄울 때 포트를 -p 9297:9297처럼 짧게 쓰면 같은 네트워크 전체에 열린다고 문서가 경고해요. 에이전트에게 맡길 때도 127.0.0.1로만 열었는지 한 번 물어보는 게 좋아요.
원격 측정(telemetry)이 기본으로 켜져 있다는 점도 알아 두면 좋아요. 익명 사용량 데이터를 보내는 건데, aws-emulator --telemetry off나 환경 변수 EMULATOR_TELEMETRY=off로 끌 수 있어요.
유지보수 방식도 독특해요. 저장소는 풀 리퀘스트를 받지 않고, 버그와 동작 차이는 GitHub Issues로만 받아요. 보안 수정은 최신 릴리스에만 나오고, 릴리스가 하루에도 여러 번 나오니 오래된 버전을 붙잡고 있으면 손해예요. 테스트마다 상태를 빠르게 초기화하는 기능이 없다는 아쉬움도 긱뉴스 댓글에 나왔어요. 지금은 재시작이 초기화 방법이에요.
이 글은 저장소와 공식 문서를 직접 열어 보고 쓴 것이고, 에뮬레이터를 설치해 S3·DynamoDB 호출을 돌려 보지는 않았어요. 실제 동작은 내 프로젝트에서 위의 두 번째 요청으로 먼저 점검받는 게 가장 확실해요.
자주 묻는 질문
정말 완전히 무료인가요?
에뮬레이터 자체에는 요금이 없어요. AWS 계정도 필요 없고요. 나중에 진짜 AWS에 배포하면 그때 쓰는 리소스 비용만 나와요.
클로드 코드나 커서에서도 쓸 수 있나요?
네. 스킬 설치 명령은 AWS CLI가 찾은 코딩 에이전트 모두에 스킬을 깔아 주고, 문서가 예로 든 에이전트에 Kiro·Cursor·Claude Code가 들어 있어요. 다만 AWS CLI 2.35.0 이상이 먼저 깔려 있어야 해요.
에뮬레이터를 끄면 만든 데이터는 어떻게 되나요?
모두 사라져요. 리소스를 메모리에만 두기 때문이에요. 테스트용으로는 오히려 편하지만, 데이터를 남겨 두고 이어서 쓰는 용도에는 맞지 않아요.
LocalStack을 쓰고 있는데 갈아타야 할까요?
IAM 정책 테스트를 쓰고 있다면 아직은 그대로 두는 편이 나아요. aws-emulator는 권한을 평가하지 않거든요. 상업 프로젝트에서 무료 도구가 필요했거나 토큰 없이 CI를 돌리고 싶었다면 옮겨 볼 만해요.
참고한 자료 8
- aws/aws-emulator (GitHub)
- AWS Emulator is now available for building and testing AWS applications locally (AWS What's New)
- What is AWS Emulator? (AWS Emulator User Guide)
- Getting started with an AI coding agent (AWS Emulator User Guide)
- AWS Emulator: a local emulator built 100% by autonomous AI agents (About Amazon)
- AWS unveils local emulator service to help enterprises accelerate app development and testing (InfoWorld)
- AWS distills its cloud into a local emulator that runs on your PC (The Register)
- LocalStack Pricing
이 글은 AI가 자료 조사와 초안 작성을 돕고, 운영자가 직접 써 보고 확인해 고친 뒤 발행했어요. 틀린 내용을 발견하면 알려 주세요.