AWS Emulator는 AWS 공식 로컬 AWS 에뮬레이터입니다. 내 컴퓨터에 HTTPS endpoint를 띄우고, AWS CLI, AWS SDK, 코딩 에이전트가 클라우드와 똑같은 API로 이를 호출합니다. AWS 계정이 필요 없고, 만들어지는 것도 실제 클라우드 리소스가 아닙니다. AWS News Blog에 따르면 2026년 11월 11일(미국 시간)에 정식 출시(GA)되었고, 베이징 시간으로는 11월 12일 새벽 2시경입니다.
2026년 11월 13일(베이징 시간, UTC+8) Debian 13 x86_64 머신에 당시 LTS 채널 버전인 AWS Emulator 1.0.322를 설치했습니다. AWS CLI 2.40.1로 S3 버킷, DynamoDB 테이블, SQS 큐, Lambda 함수를 만들고, 이어서 Claude Code 2.1.319와 Codex CLI 0.167.0에게 각각 에뮬레이터를 상대로 코드를 작성하고 테스트를 돌리게 했습니다. 아래 명령, 소요 시간, 출력은 모두 이번 실행에서 나온 것입니다.
핵심 요약
| 질문 | 답변 |
|---|---|
| AWS Emulator란? | AWS 공식 로컬 AWS API 에뮬레이터로, Rust로 구현되었고 GUI는 없습니다. AWS에 따르면 400개가 넘는 API 모델로 만들어졌고 200개가 넘는 AWS 서비스를 다룹니다. |
| 요금이 드나요? AWS 계정이 필요한가요? | AWS에 따르면 추가 서비스 요금이 없고 AWS 계정도 필요 없습니다. 소스는 GitHub에 CC0(퍼블릭 도메인)으로 공개되어 있습니다. |
| 설치 방법은? | Linux는 RPM 또는 Debian 패키지를 설치합니다. macOS와 Windows는 공식 문서의 Dockerfile로 이미지를 직접 빌드합니다(공식 빌드 이미지는 없습니다). Rust 프로젝트는 임베디드 모드도 쓸 수 있습니다. |
| 사용 방법은? | aws-emulator를 실행하면 기본으로 https://127.0.0.1:9297에서 대기합니다. 환경 변수 몇 개로 AWS CLI와 SDK를 여기로 향하게 하면 애플리케이션 코드는 바꿀 필요가 없습니다. |
| 실측 결과 | 다운로드와 설치에 약 6초, 시작 후 약 0.3초 만에 헬스 체크가 ok를 반환했습니다. S3, DynamoDB, SQS, Lambda 모두 동작했습니다. 같은 "S3 + DynamoDB + pytest" 작업을 Claude Code는 약 32초, Codex는 약 81초에 끝냈고 둘 다 2 passed였습니다. |
| 가장 주의할 점 | IAM 정책을 AWS처럼 평가하지 않고, 단일 계정·단일 리전만 에뮬레이션합니다. 권한과 보안은 프로덕션 전에 실제 AWS에서 테스트해야 합니다. |
AWS Emulator란
AWS News Blog에 따르면 AWS Emulator는 시작할 때 자체 자격 증명, config 파일, 인증서를 만들어 ~/.aws/emulator/9297/에 씁니다. SDK 환경 변수를 그쪽으로 향하게 하면 요청이 AWS가 아니라 내 컴퓨터로 갑니다. AWS SDK와 같은 API 모델로 만들어졌기 때문에 돌아오는 데이터와 오류도 클라우드와 같은 형식입니다.
주된 용도는 코딩 에이전트입니다. @AWSNewsroom에 따르면 AWS Emulator의 코드는 한 줄도 빠짐없이 Amazon Bedrock AgentCore에서 실행되는 자율 AI 에이전트가 작성했으며, 수백 개의 에이전트가 세 팀으로 나뉘어 테스트 작성, 기능 구현, 리뷰를 맡습니다. AWS의 Swami Sivasubramanian이 쓴 All Things Distributed 기고문에 따르면, 에이전트는 먼저 "피델리티 테스트"를 작성해 실제 AWS에서 통과시킨 뒤, 같은 테스트를 통과할 때까지 에뮬레이터를 구현합니다. AWS CTO @Werner는 이 에뮬레이터가 전부 에이전트가 작성하고 테스트한 것이며, 200개가 넘는 AWS 서비스에 대해 실제와 가까운 테스트 환경을 제공한다고 밝혔습니다.
출시 반응도 큽니다. X 공개 데이터에 따르면 11월 13일 새벽(베이징 시간) 기준 @AWSNewsroom 출시 게시물은 조회 약 11.1만, 좋아요 705, 재게시 206회였고, @awsdevelopers 출시 게시물은 조회 약 7.8만, 좋아요 1203, 북마크 758회였습니다. GitHub 저장소 aws/aws-emulator는 같은 시점에 스타 약 4400개입니다.
타임라인
| 시간(베이징 시간) | 내용 |
|---|---|
| 11월 11일 | 1.0.322 출시(aws-emulator -v의 출시일은 2026.11.10) |
| 11월 12일 오전 2시경 | AWS News Blog, Werner, AWS 공식 계정이 GA 발표 |
| 11월 13일 0:16 | LTS/latest에서 받은 패키지는 여전히 1.0.322. 같은 시각 GitHub Releases에 v1.0.336 등장 |
AWS Emulator는 릴리스가 매우 잦고, 공식 skill도 항상 최신 버전을 쓰라고 요구합니다. 여러분이 설치할 때는 버전 번호가 저희보다 높을 가능성이 큽니다.
AWS Emulator 설치
공식 문서(Getting started)에는 네 가지 방법이 있습니다. AI 코딩 에이전트에게 맡기기, Linux 패키지, Docker, Rust 임베디드 모드입니다.
Linux: RPM 또는 Debian 패키지
# Debian / Ubuntu (x86_64)
curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb
# Amazon Linux / Fedora / RHEL (x86_64)
sudo dnf install -y https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm
# 버전 확인
aws-emulator -v
ARM 머신에서는 파일 이름을 aws-emulator_arm64.deb 또는 aws-emulator-aarch64.rpm으로 바꿉니다. 패키지는 /opt/aws-emulator/에 설치되고 aws-emulator 명령이 /usr/bin/에 들어갑니다.
실제 출력:
Version: 1.0.322
Release date: 2026.11.10
Commit: 7753983c6e495ec3612695b1336bf4936fc7b7fd
deb 패키지는 약 171 MB이고, 다운로드는 1.7초, 다운로드와 apt-get install을 합쳐 약 6초 걸렸습니다. 공식 문서에는 GPG 검증 절차도 있습니다. 각 패키지 옆에 같은 이름의 .sig 파일이 있고, https://downloads.aws.com/keys/gpg/current.asc를 가져온 뒤 지문이 98BC F336 A3BE 53B7 34E9 67C5 2E5B F49B D940 F624여야 합니다. 절차대로 검증해 Good signature from "SSM Publishing <ssm-publishing@amazon.com>"를 확인했습니다.
macOS / Windows: Dockerfile로 직접 빌드
Docker 가이드에 따르면 공식 빌드 이미지는 없고, 아래 Dockerfile로 직접 빌드해야 합니다. Apple 실리콘에서는 x86_64.rpm을 aarch64.rpm으로 바꿉니다.
FROM public.ecr.aws/amazonlinux/amazonlinux:2023-minimal
ADD https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator-x86_64.rpm /tmp/aws-emulator.rpm
RUN rpm -i /tmp/aws-emulator.rpm && rm /tmp/aws-emulator.rpm \
&& mkdir -p /home/emulator && chown 1000 /home/emulator
USER 1000
ENV HOME=/home/emulator
EXPOSE 9297
ENTRYPOINT ["aws-emulator", "-b", "0.0.0.0"]
docker build -t aws-emulator .
mkdir -p ~/.aws/emulator
PORT=9297
docker run --rm --memory=2g --memory-swap=2g -p 127.0.0.1:$PORT:$PORT \
-e HOME="$HOME" -v "$HOME/.aws/emulator:$HOME/.aws/emulator" \
aws-emulator -p $PORT
포트는 -p 9297:9297이 아니라 -p 127.0.0.1:9297:9297로 써야 합니다. 짧은 형태로 쓰면 네트워크의 다른 컴퓨터도 접근할 수 있습니다. 이번 테스트 머신에는 Docker가 없어서 Docker 경로는 공식 문서를 정리만 했고 실행하지는 않았습니다.
시작하고 AWS CLI를 연결하기
첫 번째 터미널에서 에뮬레이터를 시작합니다(-t off는 기본으로 켜져 있는 익명 텔레메트리를 끕니다).
aws-emulator -t off
로그는 JSON Lines 형식이고, endpoint, config, 인증서 경로를 알려 주는 줄이 있습니다.
"endpoint_url":"https://127.0.0.1:9297","health_check_url":"https://127.0.0.1:9297/__admin/health","config_file":"/home/box/.aws/emulator/9297/config","ca_file":"/home/box/.aws/emulator/9297/ca.pem"
두 번째 터미널에서 환경 변수를 설정합니다. 이 묶음은 AWS News Blog에 나온 것이며, 마지막 줄은 실제 AWS 자격 증명을 지웁니다.
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_EC2_METADATA_DISABLED=true
export AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1
export AWS_DEFAULT_REGION=us-east-1
unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE
먼저 에뮬레이터에 연결됐는지 확인합니다.
curl --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health
aws sts get-caller-identity
이번에는 시작 후 약 0.27초 만에 헬스 체크가 ok를 반환했습니다. get-caller-identity는 에뮬레이터 고정 계정 000000000000과 ARN arn:aws:iam::000000000000:user/emulator를 돌려줍니다. 이 계정이 보이면 요청이 실제 AWS로 가지 않는다는 뜻입니다. 유휴 상태 상주 메모리는 약 283 MB였습니다.
실측: S3, DynamoDB, SQS, Lambda
aws s3 mb s3://aicodewith-emu-demo
echo "hello from the emulator" > hello.txt
aws s3 cp hello.txt s3://aicodewith-emu-demo/
aws s3 ls s3://aicodewith-emu-demo/
aws dynamodb create-table --table-name notes \
--attribute-definitions AttributeName=id,AttributeType=S \
--key-schema AttributeName=id,KeyType=HASH --billing-mode PAY_PER_REQUEST
aws dynamodb wait table-exists --table-name notes
aws dynamodb put-item --table-name notes --item '{"id":{"S":"n1"},"msg":{"S":"hello"}}'
aws dynamodb get-item --table-name notes --key '{"id":{"S":"n1"}}'
| 작업 | 결과 | 명령당 시간 |
|---|---|---|
| s3 mb / s3 cp / s3 ls | make_bucket: aicodewith-emu-demo, 24바이트 업로드, 목록에 hello.txt | 약 0.55–0.6초 |
| dynamodb create-table | 상태 CREATING | 약 0.5초 |
| 테이블 생성 직후 put-item | ResourceNotFoundException: Requested resource not found | 약 0.5초 |
| wait table-exists 후 put-item / get-item | 쓰기 성공, {"id":"n1","msg":"hello"} 읽기 | 약 0.5초 |
| sqs create-queue / send-message / receive-message | 보낸 메시지 본문 "hi" 수신 | 약 0.5초 |
| lambda create-function(Python 3.13) + invoke | StatusCode: 200, 함수 반환값 {"ok": true, "echo": {"a": 1}} | 약 0.6초 |
명령당 약 0.5초의 대부분은 AWS CLI 자체의 시작 시간이고, 에뮬레이터 응답은 빠릅니다.
알아 둘 동작이 두 가지 있으며, 둘 다 실제 AWS와 같습니다.
- 막 만든 DynamoDB 테이블에는 바로 쓸 수 없습니다. 생성 직후 상태는
CREATING이고, 바로put-item하면ResourceNotFoundException이 납니다. 쓰기 전에aws dynamodb wait table-exists를 실행하거나 코드에서 waiter를 쓰세요. 에이전트가 짠 테스트가 가장 자주 넘어지는 지점입니다. - Lambda는 역할의 신뢰 정책을 검사합니다. 처음에 Statement가 비어 있는 역할로 함수를 만들자
The role defined for the function cannot be assumed by Lambda오류가 났습니다. 신뢰 정책에lambda.amazonaws.com의sts:AssumeRole을 추가하자 함수가 만들어졌습니다.
Claude Code·Codex·Cursor가 에뮬레이터를 상대로 일하게 하기
방법 1: 공식 aws-emulator skill 설치
AI 코딩 에이전트 가이드에 따르면 AWS CLI 2.35.0 이상에서는 명령 하나로 공식 skill을 설치할 수 있습니다. 그다음 에이전트에게 "Install AWS Emulator and point my project at it"라고 말하면 됩니다.
aws agent-toolkit add-skill --skill-name aws-emulator --region us-east-1
이 명령은 컴퓨터에서 감지된 모든 에이전트에 skill을 설치하며 AWS 계정이 필요 없습니다. AWS CLI 2.40.1에서 한 번에 약 0.6초 걸렸고, 감지된 에이전트마다 다음 디렉터리에 썼습니다.
- Claude Code:
~/.claude/skills/aws-emulator/ - Codex:
~/.agents/skills/aws-emulator/ - Cursor:
~/.cursor/skills/aws-emulator/
주의: AWS_ENDPOINT_URL이 설정된 셸에서 이 명령을 실행하지 마세요. 처음에 이미 에뮬레이터를 가리키는 터미널에서 실행했더니 skill 다운로드 요청까지 에뮬레이터로 가서 UnknownService ... GetLatestSkillVersion 오류가 났습니다. 깨끗한 터미널에서 실행하면 해결됩니다.
skill에는 스크립트 없이 문서만 들어 있습니다. Linux, Docker, Rust 임베디드 모드 설치 절차, SDK별 연결 방법, 오류 대조표, "내 프로젝트가 에뮬레이터에서 돌아갈까" 호환성 점검 절차가 포함됩니다. skill의 일반적인 구조는 "Agent Skills 사용법"을 참고하세요.
방법 2: 환경 변수를 설정하고 에이전트에게 작업 맡기기
Claude Code, Codex, Cursor의 에이전트는 모두 터미널에서 명령을 실행합니다. 그래서 가장 간단한 방법은 에이전트를 시작하는 터미널에 앞 절의 환경 변수를 먼저 설정해 두는 것입니다. 에이전트가 실행하는 aws 명령과 boto3 테스트는 자동으로 에뮬레이터로 가고, 에이전트가 실수해도 실제 계정에는 닿지 않습니다. Cursor 터미널도 같은 환경 변수를 읽습니다. 이번에 Cursor에서는 skill만 설치했고 작업은 돌리지 않았습니다.
Claude Code와 Codex에게 같은 작업을 줬습니다. 프로젝트는 빈 Python 저장소이고, .venv에 boto3 1.44.1과 pytest 9.2.0을 미리 설치해 두었습니다.
The shell already points the AWS CLI and SDKs at a local AWS Emulator (AWS_ENDPOINT_URL=https://127.0.0.1:9297); never use a real AWS account.
1. Write notes.py with save_note(bucket, table, note_id, text): put the text in S3 at notes/<note_id>.txt and put an item {id, s3_key} in the DynamoDB table; and get_note(bucket, table, note_id) that returns the text by reading the item and then the S3 object.
2. Write tests/test_notes.py with pytest: create a uniquely named bucket and table (string key "id", PAY_PER_REQUEST, wait until the table exists) against the emulator, then test save/get round trip and that get_note of a missing id raises KeyError.
3. Run .venv/bin/pytest -q until it passes, then verify with the aws CLI that the object and item exist. Finish with a 3-line summary.
| 클라이언트 | 모델 | 실제 소요 시간 | 결과 |
|---|---|---|---|
| Claude Code 2.1.319(claude -p) | claude-opus-5-5 | 약 32.3초, 5턴 | notes.py와 tests/test_notes.py 작성, 2 passed. aws CLI로 객체 notes/n1.txt와 해당 항목 확인 |
| Codex CLI 0.167.0(codex exec) | gpt-6.1-sol | 약 80.9초 | notes.py, tests/test_notes.py에 pytest.ini까지 작성. 2 passed in 3.36s, 이어서 스크립트로 객체와 항목 확인 |
둘 다 스스로 get_waiter("table_exists")를 써서 "생성 직후 쓰기" 함정을 피했습니다. 이후 Claude Code 디렉터리에서 저희가 직접 .venv/bin/pytest -q를 다시 돌려도 2 passed in 3.24s였고, aws s3 ls에는 두 실행이 만든 notes-test-* 버킷이 보였습니다. 에이전트의 자체 보고는 참고만 하고, 최종 판단은 직접 다시 돌린 결과로 하세요.
이번에는 둘 다 비대화형으로 실행했습니다. Claude Code에는 --permission-mode bypassPermissions, Codex에는 --dangerously-bypass-approvals-and-sandbox를 붙였습니다. 이는 일회용 테스트 디렉터리에만 적합합니다. 실제 저장소에서는 hooks로 위험한 명령을 막으세요. 자세한 내용은 "Claude Code / Codex / Cursor Agent Hooks 설정"을 참고하세요. 한 화면에서 Claude Code와 Codex를 함께 쓰고 싶다면 "T3 Code로 Claude Code와 Codex 연결하기"를 보세요.
Claude Code / Codex를 AICodeWith API Key에 연결하기
위 테스트에서 두 클라이언트 모두 AICodeWith API Key를 사용했습니다. 공식 구독으로 로그인하고 싶지 않다면 각 CLI의 전역 설정만 작성하면 됩니다.
Claude Code는 ~/.claude/settings.json을 작성합니다(자세한 내용은 "Claude Code 서드파티 API 설정").
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "내 AICodeWith API Key"
}
}
Codex는 ~/.codex/config.toml을 작성합니다(다운로드와 설치는 "Codex 다운로드", 항목 설명은 "Codex config.toml 설정 가이드").
model_provider = "aicodewith"
model = "gpt-6.1-sol"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "내 AICodeWith API Key"
작성 후 먼저 각각 확인합니다: claude -p "Reply with exactly: pong", codex exec --skip-git-repo-check "Reply with exactly: pong". 이번에는 둘 다 pong을 반환했고, Claude Code는 약 4.3초, Codex는 약 4.8초 걸렸습니다.
두 종류의 자격 증명을 섞지 마세요. AICodeWith Key는 에이전트가 모델을 호출할 때만 씁니다. AWS 쪽은 에뮬레이터가 시작할 때마다 만드는 EMULATOR...로 시작하는 임시 키를 쓰며, 모델 Key와는 관계가 없습니다.
CI에 넣기
공식 문서에 따르면 에뮬레이터 상태는 메모리에만 있고, /__admin/health는 스크립트와 컨테이너가 준비될 때까지 기다리기 위한 경로입니다. 아래는 GitHub Actions 예시이며, 설치와 시작 명령은 위에서 Debian에서 실행한 것과 같습니다.
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install and start AWS Emulator
run: |
curl -fsSLo aws-emulator.deb https://downloads.aws.com/aws-emulator/packages/aws-emulator/LTS/latest/aws-emulator_amd64.deb
sudo apt-get install -y ./aws-emulator.deb
aws-emulator -t off &
until curl -sf --cacert ~/.aws/emulator/9297/ca.pem https://127.0.0.1:9297/__admin/health; do sleep 0.2; done
- name: Run tests against the emulator
run: |
export AWS_ENDPOINT_URL=https://127.0.0.1:9297
export AWS_SHARED_CREDENTIALS_FILE=~/.aws/emulator/9297/emulator_credentials
export AWS_CONFIG_FILE=~/.aws/emulator/9297/config
export AWS_EC2_METADATA_DISABLED=true AWS_DISABLE_HOST_PREFIX_INJECTION=true
export AWS_REGION=us-east-1 AWS_DEFAULT_REGION=us-east-1
pytest -q
CI 작업 환경 변수에 실제 AWS 자격 증명을 넣지 마세요. AWS도 같은 권고를 합니다.
한계: 할 수 없는 것
AWS News Blog와 Fidelity 문서에 따르면:
- IAM 정책을 평가하지 않습니다. AWS에서는 거부될 요청이 에뮬레이터에서는 성공할 수 있으므로 보안 테스트에 쓰지 마세요.
- 단일 계정, 단일 리전만 지원합니다. 계정 간·리전 간 동작은 없습니다.
- 아직 구현되지 않은 작업은 HTTP 501(`NotImplemented`)을 반환합니다. 테스트가 조용히 통과하지 않고 바로 실패합니다.
- 피델리티는 서비스마다 다릅니다. 컨트롤 플레인 API(리소스 생성·조회·삭제)가 AWS와 가장 가깝고, 데이터 플레인 API와 CloudFormation, Terraform, CDK 같은 IaC 도구 지원은 서비스별 차이가 큽니다. 릴리스마다 서비스별 피델리티 점수가 GitHub Releases에 공개되며, 테스트 세트는 aws-emulator-evaluation-suite 저장소에 공개되어 있습니다.
- 재시작하면 모두 사라집니다. 중지 후 다시 시작하자 기존 버킷과 테이블이 없어졌고,
emulator_credentials의 Access Key도EMULATORC3...에서EMULATOR1D...로 바뀌었습니다. 재시작할 때마다 자격 증명 파일을 다시 읽어야 합니다.
자주 만나는 오류와 해결
| 오류 / 증상 | 원인 | 해결 |
|---|---|---|
| AccessDenied: Sign the request with the emulator credentials | 다른 키로 서명함. 예: 환경 변수에 남은 실제 AWS 키(이번에 가짜 키로 재현) | unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_PROFILE 후 AWS_SHARED_CREDENTIALS_FILE을 이번 실행의 emulator_credentials로 지정 |
| DynamoDB 테이블 생성 직후 ResourceNotFoundException | 테이블이 아직 CREATING(이번에 발생) | aws dynamodb wait table-exists 또는 코드에서 waiter 사용 |
| UnknownService: could not resolve a target service | 에뮬레이터용이 아닌 요청이 에뮬레이터로 감. 예: AWS_ENDPOINT_URL이 설정된 터미널에서 skill 설치(이번에 발생) | AWS_ENDPOINT_URL이 없는 터미널에서 실행 |
| SSL: CERTIFICATE_VERIFY_FAILED | 클라이언트가 이번 실행의 ca.pem을 신뢰하지 않음 | AWS_CONFIG_FILE 설정. Node는 NODE_EXTRA_CA_CERTS, Java는 truststore.p12. 인증서 검증은 끄지 말 것 |
| sts get-caller-identity에 실제 계정이 나옴 | 그 명령에 AWS_ENDPOINT_URL이 적용되지 않아 AWS로 감 | 환경 변수가 설정된 터미널이나 스크립트에서 실행 |
| Address already in use | 포트가 사용 중 | 다른 포트 사용(예: aws-emulator -p 9300), 환경 변수의 포트도 함께 변경 |
| NotImplemented / HTTP 501 | 설치된 버전에 해당 작업이 아직 없음 | 최신 버전으로 올린 뒤 Releases에서 해당 서비스의 피델리티 점수 확인 |
FAQ
AWS Emulator의 API는 실제 AWS와 같나요?
AWS에 따르면 AWS SDK와 같은 Smithy API 모델로 구현되어 요청과 오류 형식이 AWS와 같습니다. 동작까지 맞는지는 서비스별 피델리티 점수에 달려 있습니다. 이번에 만난 DynamoDB CREATING 상태와 Lambda 신뢰 정책 검사는 모두 AWS와 같았습니다.
macOS에 바로 설치할 수 있나요?
바로는 안 되고 Docker를 써야 합니다. 공식적으로는 Linux 패키지만 배포하며, macOS와 Windows에서는 공식 Dockerfile로 이미지를 빌드합니다.
프로덕션이나 보안 테스트에 써도 되나요?
안 됩니다. 공식적으로 개발과 테스트 전용이라고 밝히고 있으며, IAM 정책을 평가하지 않고 프로덕션 워크로드용도 아닙니다.
에이전트가 실수로 실제 AWS 리소스를 바꾸지 않을까요?
에이전트를 시작하는 터미널에 AWS_ENDPOINT_URL을 설정하고 실제 자격 증명을 unset했다면 요청은 내 컴퓨터로만 갑니다. 에뮬레이터도 자신이 만든 EMULATOR... 키로 서명된 요청만 받습니다. 시작하기 전에 aws sts get-caller-identity를 한 번 실행해 계정이 000000000000인지 확인하세요.
Claude Code, Codex, Cursor 중 무엇이 더 맞나요?
셋 다 됩니다. 모두 공식 skill을 설치할 수 있고 터미널의 환경 변수를 그대로 이어받습니다. 이번 같은 작업에서 Claude Code와 Codex 모두 한 번에 통과했습니다. 평소 쓰는 도구를 고르면 됩니다.
참고 자료
- AWS News Blog: Test your applications against AWS locally with AWS Emulator
- Swami Sivasubramanian: AWS Emulator and the engineer's job when agents write the code
- GitHub: aws/aws-emulator
- AWS Emulator 사용자 가이드: Getting started
- Getting started on Linux
- Getting started with Docker
- Fidelity in AWS Emulator
- @AWSNewsroom 출시 게시물
- @awsdevelopers 출시 게시물
- @Werner 게시물



