Download & Install

macOS, Windows, Linux에서 Kiro를 내려받아 설치하고 첫 실행까지 마치는 방법을 정리합니다.

지원 환경

Kiro는 주요 데스크톱 OS 세 가지에서 동작합니다. 설치 전 사용 중인 시스템이 아래 조건을 충족하는지 확인하세요.

Tip. Linux에서 glibc 버전이 모호하다면 ldd --version 명령으로 확인할 수 있습니다.

다운로드 절차

  1. kiro.dev 에 접속해 사용 중인 OS에 맞는 설치 파일을 내려받습니다.
  2. 다운로드한 인스톨러를 실행하고, 각 OS의 안내에 따라 Kiro를 설치합니다. macOS에서는 .dmg를 열어 Applications 폴더로 드래그하고, Windows에서는 .exe를 실행해 마법사를 진행하며, Linux에서는 배포판에 맞는 패키지를 사용해 설치하면 됩니다.
  3. 설치가 끝나면 Kiro IDE를 실행합니다.
Kiro wordmark logo
Kiro 워드마크 로고. 다운로드 페이지와 첫 실행 화면에서 동일하게 등장합니다.

첫 실행 시 설정 흐름

Kiro를 처음 켜면 짧은 온보딩이 진행됩니다. 다음 세 단계를 따라가면 곧바로 작업을 시작할 수 있습니다.

  1. Sign in — 인증 공급자를 선택해 로그인합니다. 사용 가능한 옵션은 Google, GitHub, AWS Builder ID, 그리고 조직(IdP) 로그인입니다. 자세한 내용은 다음 페이지의 Authentication 가이드를 참고하세요.
  2. Import configuration — VS Code의 설정과 확장 프로그램을 가져올 수 있습니다. Import from VS Code를 선택하면 기존 환경이 그대로 옮겨지고, 다른 에디터를 쓰던 사용자라면 Skip으로 건너뛰면 됩니다. 이어서 Kiro Dark 또는 Kiro Light 테마를 고르고, 에이전트가 터미널에서 명령을 실행할 수 있도록 셸 통합(shell integration)도 함께 허용해 두는 것이 좋습니다.
  3. Welcome 화면 — 프로젝트 폴더를 열어 첫 작업을 시작합니다. 이 시점부터 Spec mode, Autopilot, Agent 같은 핵심 기능을 바로 사용할 수 있습니다.
Tip. shell integration을 활성화하면 Agent가 빌드, 테스트, 패키지 설치 같은 명령을 직접 수행하면서 결과를 읽어올 수 있어 작업 흐름이 훨씬 매끄러워집니다.
주의. 회사·학교 계정으로 로그인한다면 조직의 IdP 정책에 따라 로그인 방식이 제한될 수 있습니다. 사내 정책을 먼저 확인한 뒤 적절한 옵션을 선택하세요.

이전 버전으로 다운그레이드

업데이트로 인해 기존 작업 흐름에 문제가 생겼다면 이전 버전의 Kiro로 되돌릴 수 있습니다.

  1. 다운로드 페이지로 이동합니다.
  2. 상단의 기본 다운로드 카드를 지나 아래쪽 버전 목록까지 스크롤합니다.
  3. 설치하려는 버전을 펼칩니다(예: "IDE 0.12.x").
  4. 사용 중인 플랫폼에 맞는 설치 파일을 내려받습니다.
  5. 현재 설치된 Kiro를 먼저 제거합니다.
    • macOS: Applications에서 Kiro를 휴지통으로 드래그합니다.
    • Windows: 설정 > 앱 > 설치된 앱에서 제거합니다.
    • Linux: 사용하는 패키지 관리자에 따라 sudo apt remove kiro 또는 sudo dnf remove kiro를 실행합니다.
  6. 내려받은 설치 파일을 실행합니다.

재설치해도 설정, 확장 프로그램, 로그인 상태는 그대로 유지됩니다. 다시 최신 버전으로 돌아갈 준비가 되면 다운로드 페이지에서 최신 버전을 내려받거나 애플리케이션이 자동으로 업데이트하도록 두면 됩니다.

지원 언어

Kiro는 널리 쓰이는 대부분의 프로그래밍 언어를 지원하며, 다음 언어에 대해서는 별도의 시작 가이드를 제공합니다.

다음 단계

설치와 초기 설정이 끝났다면 Authentication 페이지로 이동해 사용 환경에 맞는 로그인 방식을 자세히 살펴보세요.