Download & Install
macOS, Windows, Linux에서 Kiro를 내려받아 설치하고 첫 실행까지 마치는 방법을 정리합니다.
지원 환경
Kiro는 주요 데스크톱 OS 세 가지에서 동작합니다. 설치 전 사용 중인 시스템이 아래 조건을 충족하는지 확인하세요.
- macOS: Intel 및 Apple silicon. 최신 보안 업데이트가 적용된 상태를 권장합니다.
- Windows: Windows 10 또는 Windows 11의 64-bit 버전. ARM 아키텍처는 아직 지원하지 않습니다.
- Linux: glibc 2.39 이상. 예를 들어 Ubuntu 24+, Debian 13+, Fedora 40+, Arch Linux, Linux Mint 22+ 가 해당됩니다.
Tip. Linux에서 glibc 버전이 모호하다면
ldd --version 명령으로 확인할 수 있습니다.
다운로드 절차
- kiro.dev 에 접속해 사용 중인 OS에 맞는 설치 파일을 내려받습니다.
- 다운로드한 인스톨러를 실행하고, 각 OS의 안내에 따라 Kiro를 설치합니다. macOS에서는
.dmg를 열어 Applications 폴더로 드래그하고, Windows에서는.exe를 실행해 마법사를 진행하며, Linux에서는 배포판에 맞는 패키지를 사용해 설치하면 됩니다. - 설치가 끝나면 Kiro IDE를 실행합니다.
첫 실행 시 설정 흐름
Kiro를 처음 켜면 짧은 온보딩이 진행됩니다. 다음 세 단계를 따라가면 곧바로 작업을 시작할 수 있습니다.
- Sign in — 인증 공급자를 선택해 로그인합니다. 사용 가능한 옵션은 Google, GitHub, AWS Builder ID, 그리고 조직(IdP) 로그인입니다. 자세한 내용은 다음 페이지의 Authentication 가이드를 참고하세요.
- Import configuration — VS Code의 설정과 확장 프로그램을 가져올 수 있습니다. Import from VS Code를 선택하면 기존 환경이 그대로 옮겨지고, 다른 에디터를 쓰던 사용자라면 Skip으로 건너뛰면 됩니다. 이어서 Kiro Dark 또는 Kiro Light 테마를 고르고, 에이전트가 터미널에서 명령을 실행할 수 있도록 셸 통합(shell integration)도 함께 허용해 두는 것이 좋습니다.
- Welcome 화면 — 프로젝트 폴더를 열어 첫 작업을 시작합니다. 이 시점부터 Spec mode, Autopilot, Agent 같은 핵심 기능을 바로 사용할 수 있습니다.
Tip. shell integration을 활성화하면 Agent가 빌드, 테스트, 패키지 설치 같은 명령을 직접 수행하면서 결과를 읽어올 수 있어 작업 흐름이 훨씬 매끄러워집니다.
주의. 회사·학교 계정으로 로그인한다면 조직의 IdP 정책에 따라 로그인 방식이 제한될 수 있습니다. 사내 정책을 먼저 확인한 뒤 적절한 옵션을 선택하세요.
지원 언어
Kiro는 널리 쓰이는 대부분의 프로그래밍 언어를 지원하며, 다음 언어에 대해서는 별도의 시작 가이드를 제공합니다.
- TypeScript / JavaScript
- Java
- Python
다음 단계
설치와 초기 설정이 끝났다면 Authentication 페이지로 이동해 사용 환경에 맞는 로그인 방식을 자세히 살펴보세요.