Strands Agents나 LangGraph로 에이전트 프로토타입은 이제 몇 시간에도 구현이 가능합니다. 문제는 그다음입니다. 로컬에서 잘 돌던 코드를 Amazon Bedrock AgentCore Runtime에 올리려면 챙길 것이 많습니다. IAM 역할, 패키징, 배포 파이프라인, 로그와 트레이스 수집까지 이어집니다. 이 과정에서 개발 흐름이 자주 끊깁니다. 실제로 에이전트를 만들어 본 분들이 공통적으로 던지는 질문이 있습니다. 코드를 고칠 때마다 로컬에서 바로 확인할 방법은 없을까요? 개발부터 배포, 운영까지 터미널 하나로 이어지는 워크 플로우는 어떻게 만들까요? 개발의 상당 부분을 맡기고 있는 Kiro CLI나 Claude Code 같은 AI 코딩 에이전트와는 어떻게 결합해야 할까요?
AWS는 2026년 4월 이 간극을 메우는 AgentCore CLI를 공개했고, 2026년 10월 28일 정식 버전 1.0을 출시했습니다. 이 명령줄 도구는 npm 패키지로 설치합니다. 프로젝트 생성부터 로컬 개발, 배포, 호출, 운영까지 에이전트의 전체 수명 주기를 터미널 하나로 묶습니다. 이 글에서는 AgentCore CLI의 구조와 핵심 명령을 살펴봅니다. 이어서 실제 개발 워크 플로우에 녹여 쓰는 방법을 봅니다. 마지막으로 Kiro CLI와 Claude Code에 연결해 에이전트 개발 자체를 자동화하는 방법까지 다룹니다.
1. 정식 출시된 AgentCore CLI 1.0
기존에 AgentCore 배포 도구로 쓰이던 Bedrock AgentCore Starter Toolkit을 기억하는 분이 많을 것입니다. 이 Python 기반 도구는 레거시로 전환되었습니다. 신규 프로젝트에는 npm 기반의 AgentCore CLI가 권장됩니다. 두 도구는 agentcore라는 같은 명령 이름을 씁니다. Starter Toolkit이 설치된 환경이라면 혼선을 막기 위해 먼저 제거해야 합니다.
새 CLI의 첫 번째 특징은 2가지 실행 모드입니다. 인수 없이 agentcore만 입력하면 터미널 UI(TUI)가 열립니다. 화면 안내를 따라가면 프로젝트 생성부터 배포, 호출까지 이어집니다. 동시에 모든 명령은 플래그 기반의 비대화형(non-interactive) 모드를 지원합니다. --json 옵션을 붙이면 구조화된 JSON 출력을 반환합니다. 사람이 직접 쓸 때는 TUI가 편하고, 스크립트나 CI/CD, 뒤에서 소개할 AI 코딩 에이전트에게는 비대화형 모드가 맞습니다.
두 번째 특징은 배포 방식입니다. agentcore create는 프로젝트 안에 AWS CDK(Cloud Development Kit) 코드를 함께 생성합니다. agentcore deploy는 이 코드를 CloudFormation 스택으로 합성해 배포합니다. 에이전트 인프라는 처음부터 코드형 인프라(IaC)로 관리됩니다.
세 번째 특징은 1.0에서 재구축된 명령 체계입니다. 시작 속도가 빨라지고 명령 구조가 일관되게 정리되었습니다. 프로젝트 없이도 하네스, 런타임, 메모리, 게이트웨이 같은 리소스를 직접 다룹니다. ID나 ARN을 지정하면 기존 리소스를 바로 호출합니다. agentcore runtime shell로 배포된 에이전트 컨테이너에 대화형 셸을 열고, agentcore runtime exec로 명령 하나를 원격 실행하는 기능도 생겼습니다. AgentCore CLI는 AgentCore가 제공되는 AWS 리전에서 지원됩니다(중국 리전은 일부 기능 제약). CLI 자체에 대한 추가 요금은 없습니다.
그림 1. AgentCore CLI 수명 주기 — create, dev, deploy, invoke 4단계와 운영 명령이 로컬 컴퓨터와 AWS 클라우드로 이어지는 흐름
2. 설치와 사전 준비
AgentCore CLI 자체는 Node.js 20.12 이상에서 동작합니다


