Cloud Sessions (클라우드 세션)

🔬 Preview 기능

Cloud Sessions는 현재 Preview 단계입니다. 기능·UI·가용 범위는 정식 출시 전까지 변경될 수 있습니다.

최소 버전 요건

• Kiro IDE 1.0.293 이상 (Agent Focus Mode에서 시작)
• Kiro CLI는 V3 세션에서 지원 (2026년 9월말 기준 2.2x 이상, V3가 기본 하네스)
• 실행 리전 및 동시 세션 수 등 제한은 조직 설정과 릴리스에 따라 달라질 수 있습니다

최신 요건은 kiro.dev/changelog에서 확인하세요.

목표

에이전트 세션을 로컬 머신이 아닌 관리형 클라우드 샌드박스에서 실행하는 방법을 이해하고, 어떤 app에서 시작할 수 있는지, 세션을 어떻게 분리(disconnect)·재개(resume)하는지 파악합니다.

Cloud Sessions란?

Cloud Sessions는 Kiro 에이전트 세션을 Kiro가 관리하는 클라우드 샌드박스에서 실행하는 기능입니다. 에이전트가 코드를 읽고, 명령을 실행하고, 파일을 수정하는 작업이 로컬 개발 환경 대신 격리된 클라우드 환경에서 진행됩니다.

• 로컬 머신의 자원·환경에 의존하지 않고 에이전트를 실행
• 세션이 클라우드에서 유지되므로 연결을 끊었다가 다시 이어받을 수 있음
• 관리형 환경이므로 일관된 실행 조건을 보장

시작 방법

Cloud Sessions는 app에 따라 진입 지점이 다릅니다.

app	시작 방법
Kiro IDE	Agent Focus Mode에서 클라우드 세션으로 시작
Kiro CLI	V3 세션에서 클라우드 세션을 시작하고, 준비되면 /repo로 저장소를 연결
Kiro Web	기본 실행 환경 (별도 설정 없이 클라우드에서 동작)
Kiro Mobile	기본 실행 환경 (별도 설정 없이 클라우드에서 동작)

IDE와 CLI는 로컬 실행이 기본이며 위 방법으로 클라우드 세션을 명시적으로 시작합니다. 반면 Web·Mobile은 클라우드 샌드박스가 기본 환경입니다. Kiro Web은 어디에서 시작했든 모든 클라우드 세션을 한곳에서 보고 조종하는 컨트롤 플레인 역할을 합니다.

Disconnect와 Resume

Cloud Sessions는 클라우드에서 세션 상태를 유지하므로 연결을 유연하게 관리할 수 있습니다.

• Disconnect — 세션을 종료하지 않고 연결만 끊습니다. 에이전트 작업은 클라우드에서 계속 유지됩니다.
• Resume — 같은 세션에 다시 연결해 이어서 작업합니다. IDE에서 시작한 세션을 Web이나 Mobile에서 이어받는 흐름도 가능합니다.

사전 준비: 관리자 활성화

Cloud Sessions는 조직 단위로 관리되는 기능입니다.

🚨 관리자 설정 필요

Cloud Sessions를 사용하려면 관리자가 콘솔에서 기능을 토글해야 합니다. 활성화되어 있지 않으면 IDE·CLI·Web·Mobile 어디에서도 클라우드 세션을 시작할 수 없습니다.

기대 결과

• 로컬 환경에 의존하지 않고 관리형 클라우드에서 에이전트 세션을 실행
• 연결을 끊었다가 다른 표면에서 세션을 재개
• 조직 정책에 맞춰 관리자가 활성화 범위를 제어

💡 통합 관점

Kiro의 app(IDE·CLI·Web·Mobile)과 Crew, 그리고 이들을 떠받치는 unified agent harness의 관계는 Kiro란·왜 스펙 기반과 Context Engineering에서 함께 확인하세요.