Kiro

샌드박스에서 Kiro의 인증, 설정, 사용법을 설명해 드릴게요.

출처: 문서

본문

이 페이지는 로컬 샌드박스를 설명해요. 클라우드 동작과 제한 사항은 로컬과 클라우드 샌드박스 비교 문서를 보세요.

이 가이드는 샌드박스 환경에서 Kiro의 인증, 설정, 사용법을 다뤄요.

공식 문서: Kiro CLI

빠른 시작 (Quick start)

프로젝트 디렉터리용 샌드박스를 만들고 Kiro를 실행해요:

$ sbx run kiro ~/my-project

워크스페이스 파라미터는 선택 사항이고, 기본값은 현재 디렉터리예요:

$ cd ~/my-project
$ sbx run kiro

첫 실행 시 Kiro가 디바이스 흐름(device flow)으로 인증하라고 요청해요.

인증 (Authentication)

Kiro는 디바이스 흐름(device flow) 인증을 사용해요. 웹 브라우저를 통한 대화형 로그인이 필요하고, API 키를 직접 저장하지 않으면서 안전하게 인증하는 방식이에요.

디바이스 흐름 로그인 (Device flow login)

Kiro를 처음 실행하면 인증을 요청해요:

Kiro가 URL과 검증 코드(verification code)를 표시해요
웹 브라우저에서 그 URL을 열어요
검증 코드를 입력해요
브라우저에서 인증 흐름을 완료해요
터미널로 돌아오면 Kiro가 자동으로 진행해요

인증 세션은 샌드박스에 유지되므로, 샌드박스를 지우고 다시 만들지 않는 한 반복 로그인할 필요가 없어요.

수동 로그인 (Manual login)

로그인 흐름을 수동으로도 시작할 수 있어요:

$ sbx run kiro --name <sandbox-name> -- login --use-device-flow

이 명령은 코딩 세션을 시작하지 않고 디바이스 흐름 인증만 시작해요.

인증 유지 (Authentication persistence)

Kiro는 인증 상태를 샌드박스 안의 ~/.local/share/kiro-cli/data.sqlite3에 저장해요. 이 데이터베이스는 샌드박스가 존재하는 동안 유지돼요. 샌드박스를 지우면 다시 만들 때 다시 인증해야 해요.

설정 (Configuration)

샌드박스는 호스트의 사용자 수준 설정을 가져오지 않아요. 샌드박스 안에서는 작업 디렉터리의 프로젝트 수준 설정만 쓸 수 있어요. 해결 방법은 "샌드박스가 내 사용자 수준 에이전트 설정을 안 쓰는 이유는?" 문서를 참고하세요.

Kiro는 최소한의 설정만 필요해요. 에이전트는 기본적으로 trust-all-tools 모드로 실행되어, 반복적인 승인 프롬프트 없이 명령을 실행할 수 있어요.

기본 시작 명령 (Default startup command)

추가 인자 없이 샌드박스는 다음을 실행해요:

kiro chat --trust-all-tools

-- 뒤의 첫 인자가 플래그(-로 시작)면 기본 값 뒤에 추가돼요 — 예를 들어 sbx run kiro -- --resume은 kiro chat --trust-all-tools --resume을 실행해요. 첫 인자가 일반 단어면 기본 값을 대체하므로, sbx run kiro -- login --use-device-flow는 login 서브커맨드를 단독 실행하게 돼요. chat을 여러분의 인자와 함께 실행하려면 서브커맨드를 포함해 주세요:

$ sbx run kiro -- chat --trust-all-tools --resume

기본 이미지 (Base image)

템플릿: docker/sandbox-templates:kiro

인증 상태는 샌드박스 재시작 후에도 유지돼요.

도구를 미리 설치하거나 이 환경을 커스터마이즈하려면 Customize 문서를 보세요.

더 알아보기 (Learn more)

관련 문서와 심화 내용은 원문을 참고해 주세요.