AI-DLC · Kiro Workshop

Kiro 시작 가이드

Kiro를 처음 시작하기 위한 구독 · 설치 · 환경 준비를 한 곳에 모았습니다.

아래 탭을 순서대로 따라가면 워크샵을 바로 시작할 수 있습니다.

구독(IAM Identity Center) → 설치(Windows · macOS/Linux) → AI-DLC 하네스 환경 준비

원본 소스

1 사전 요구 사항 필수

  • Kiro IDE 클라이언트 다운로드 — https://kiro.dev/downloads/ 에서 OS에 맞는 설치 프로그램을 받습니다.
  • AWS 계정 — 없다면 AWS Account Management에서 새 AWS 계정을 생성합니다.
이 가이드는 AWS IAM Identity Center를 통해 Kiro 구독을 설정하는 신규 유저용 절차입니다. 조직(관리자)이 Kiro 구독을 한 번 구성한 뒤, 사용자를 할당하는 흐름입니다.

2 IAM Identity Center 활성화 & 사용자 생성

  1. IAM Identity Center 활성화 — AWS 콘솔에서 IAM Identity Center로 이동해 "Enable"을 클릭합니다. 버지니아 북부(us-east-1) 리전에서 활성화할 수 있습니다.
  2. 첫 사용자 생성 — "Add user"를 클릭해 사용자를 추가합니다. 잠시 후 해당 사용자의 이메일로 초대 메일이 발송됩니다.
  3. 초대 수락 & MFA 설정 — 사용자 이메일에서 "Accept the invitation"을 클릭하고 MFA를 설정합니다. 반드시 새 사용자와 연결된 이메일에서 초대를 수락해야 합니다.

3 Kiro 구독(프로필) 생성

  1. Kiro 검색 — AWS Management Console 홈에서 Kiro를 검색해 Kiro 페이지로 진입합니다.
  2. Setting 진입 — 왼쪽 상단 메뉴를 클릭해 Setting 페이지로 이동합니다.
  3. Sign up for Kiro — Setting 화면에서 "Sign up for Kiro"를 선택합니다.
  4. ID 공급자 연결 — "Connect your Identity Provider"를 선택합니다. IAM Identity Center 설정이 완료된 경우 "Set up application as admin"을 선택합니다.
  5. Enable — Enable을 선택하면 Kiro Profile이 생성됩니다.
여기까지 진행하면 Kiro 프로필 생성 완료입니다. 이제 IAM Identity Center 사용자를 구독에 할당합니다.

4 사용자에게 구독 할당

  1. Users & Groups — Kiro 메뉴에서 Users & Groups를 선택합니다.
  2. Add user — "Add user"를 선택합니다.
  3. 플랜 선택 — 사용자가 구독할 플랜을 선택합니다.
  4. 사용자 할당 — 처음에 만든 사용자가 보입니다. 구독할 사용자를 선택하고 Assign 합니다.

로그인 Kiro 클라이언트에서 로그인

Kiro 클라이언트로 이동하여 "Sign in with your organization identity"를 선택하고, 앞 단계에서 획득한 Start URL로 로그인합니다.

완료! 이제 Kiro로 바이브 코딩(Vibe coding) 또는 스펙 코딩(Spec coding)을 시작할 수 있습니다.

원본 소스

운영체제에 맞는 섹션을 따라가세요. Windows는 PowerShell 기반, macOS / Linux는 네이티브 터미널 기반입니다. 각 OS마다 CLI와 IDE 설치를 안내합니다.

W Windows — Kiro CLI Windows

Step 1 · 설치

PowerShell을 실행한 후 설치 스크립트를 입력합니다.

irm 'https://cli.kiro.dev/install.ps1' | iex
  • 최신 버전이 자동 다운로드됩니다.
  • 설치 위치: C:\Program Files\Kiro-Cli\
  • "Installed successfully" 메시지 확인 후 새 터미널 창을 열어 다음 단계로 진행합니다.
Step 2 · 로그인

새 PowerShell 창에서 로그인 명령을 실행합니다.

kiro-cli login --use-device-flow
  • 로그인 방법 선택: Use for Free with Builder ID(무료) 또는 Use with Pro license(Pro)
  • 터미널에 표시되는 디바이스 코드를 확인하면 브라우저가 자동으로 열립니다.
Step 3 · AWS 계정 인증

브라우저에서 다음 중 하나로 로그인한 뒤, 액세스 허용 버튼을 클릭합니다.

  • 이메일 주소 · Google · Apple · GitHub · Amazon 계정
Step 4 · 사용 시작

PowerShell로 돌아와 "Logged In" 메시지를 확인하면 완료입니다. kiro-cli를 실행하면 KIRO 로고와 환영 메시지가 표시됩니다.

/tui 새로운 UX · /feedback 피드백 · 자연어→셸 변환은 kiro-cli translate

W Windows — Kiro IDE Windows

항목요구사항
OSWindows 10 이상
메모리최소 4GB RAM (8GB 권장)
디스크최소 2GB 여유 공간
인터넷설치 및 업데이트 시 필요
  1. 다운로드 — Kiro 공식 사이트(https://kiro.dev) 방문 → Download 클릭 → Kiro-IDE-Setup.exe 선택
  2. 설치 — Kiro-IDE-Setup.exe 실행 → 마법사 진행 → 설치 경로 선택(기본 C:\Program Files\Kiro) → Install → 완료 후 자동 실행
  3. 로그인 — Kiro IDE 실행 후 "Sign in" 클릭 → 원하는 방식으로 로그인

M macOS / Linux — Kiro CLI macOS · Linux

macOS와 Linux는 네이티브 Unix 터미널 환경이라 설치가 간단합니다. 추가 하위 시스템 설정이 필요 없습니다.
사전 준비
  • Kiro IDE 설치 프로그램 다운로드: https://kiro.dev/downloads/ (받아만 두고 아직 설치하지 않아도 됩니다)
  • CLI 설치 참조 북마크: https://kiro.dev/cli/
Part 1 · CLI 설치 
curl -fsSL https://cli.kiro.dev/install | bash

설치 후 터미널을 재시작하거나 셸 설정을 다시 로드합니다.

source ~/.zshrc    # 또는 ~/.bashrc
Part 2 · 인증 
kiro-cli login

① 조직 계정(IAM Identity Center) 사용 시 — 관리자에게서 받은 정보를 입력합니다.

  • 시작 URL: 조직의 IAM Identity Center Start URL (형식: https://xxx.awsapps.com/start)
  • 리전: IAM Identity Center가 배포된 리전 (예: us-east-1, eu-central-1)
  • 브라우저에서 URL을 열어 인증하고, 메시지가 표시되면 액세스를 허용합니다.

② 개인 실습자(Builder ID 무료) 사용 시 — 로그인 방법에서 AWS Builder ID(또는 Google · GitHub)를 선택하면 브라우저가 자동으로 열려 로그인이 완료됩니다.

Part 3 · 사용 시작 
kiro-cli chat

대화 세션에서 모델을 선택합니다.

/model
  • Claude Sonnet 4.5 — 안정적인 고급 코딩 및 추론
  • Auto — 품질 · 지연 시간 · 비용의 균형을 맞춘 혼합 모델
kiro-cli chat "S3 버킷을 어떻게 생성하나요?"

M macOS / Linux — Kiro IDE macOS · Linux

  1. 설치 파일 실행 — 사전 준비에서 받은 Kiro IDE 설치 파일을 실행합니다.
  2. 실행 — 설치가 완료되면 Kiro IDE를 엽니다.
  3. 로그인 — Sign in 화면에서 Google · GitHub · AWS Builder ID · 조직 ID 중 원하는 방식으로 로그인합니다.
제공된 .kiro 폴더(= 하네스 + MCP 설정 포함)를 프로젝트에 넣은 상태에서, 아래 런타임·도구만 설치하면 바로 시작할 수 있습니다. MCP(.kiro/settings/mcp.json)는 사전 세팅되어 제공되므로 따로 설정할 것이 없습니다.

0 필수 설치 (런타임 · 도구) 필수

설치 항목왜 필요한가
Git워크플로우의 브랜치·커밋·PR (특히 parallel 확장)
Node.js (LTS 18+)제공된 MCP 6종이 npx로 자동 구동 / codegraph 설치도 npm
Python (3.10+)Python으로 빌드할 경우의 런타임·테스트(pytest 등)
AWS CLIAWS 작업 필수 — 자격증명 구성·확인
Google Chromeplaywright MCP(E2E 브라우저 테스트)용
macOS — Homebrew 
# 한 줄로 설치
brew install git node python awscli
brew install --cask google-chrome
Windows — winget (PowerShell) 
winget install Git.Git
winget install OpenJS.NodeJS.LTS
winget install Python.Python.3.12
winget install Amazon.AWSCLI
winget install Google.Chrome
설치 확인 
git --version
node -v
npx -v
python --version      # macOS는 python3 --version
aws --version

위 명령이 모두 버전을 출력하면 런타임 준비 완료입니다.

1 AWS 자격증명 구성 필수

행사는 AWS 작업을 포함하므로 자격증명이 구성되어 있어야 합니다.

# 액세스 키 방식
aws configure
# 또는 IAM Identity Center(SSO)
aws configure sso

# 확인 — 계정/사용자 정보가 나오면 OK
aws sts get-caller-identity
  • 작업 리전 합의 (예: ap-northeast-2)
  • 필요한 서비스에 대한 IAM 권한 (행사 시나리오에 맞게 사전 부여)

2 제공된 MCP가 바로 동작하려면 대부분 자동

.kiro/settings/mcp.json은 이미 세팅되어 제공되며 모든 서버를 사용합니다. 0번에서 Node.js를 설치했다면 npx 기반 6종(aws-docs · aws-cdk · context7 · token-optimizer · github · playwright)은 첫 실행 시 자동으로 받아 구동됩니다. 아래 2가지는 반드시 설정합니다.

① github MCP — 토큰 환경변수 (필수)

# macOS / Linux
export GITHUB_PAT=ghp_발급받은토큰

# Windows (PowerShell)
$env:GITHUB_PAT="ghp_발급받은토큰"

② playwright MCP — Chrome (필수)

0번에서 Google Chrome을 설치했다면 추가 작업 없음.

동작 확인: Kiro 채팅에서 /mcp 입력 → 각 서버가 Initialized로 보이면 정상입니다.

Brownfield 전용 CodeGraph 설치 · 인덱싱

기존 코드베이스를 가지고 오는 참여자만 해당. 새로 만드는(greenfield) 참여자는 건너뛰세요.

기존 코드를 사전 인덱싱하면 분석·영향 추적 단계가 빨라지고 토큰이 절감됩니다. (없어도 자동으로 파일 스캔으로 동작)

# Node.js 설치되어 있으면 (0번 완료):
npm i -g @colbymchenry/codegraph

# 대상 프로젝트 루트에서 인덱싱 (대규모는 시간 소요 — 행사 전 권장)
cd <project-root>
codegraph init
codegraph index

코드가 크게 바뀌면 codegraph index 재실행. 미설치여도 워크플로우는 정상 동작합니다.

체크 설치 점검

  • git --version · node -v · npx -v 출력
  • (Python 빌드 시) python --version · pip --version
  • aws sts get-caller-identity 성공
  • GITHUB_PAT 환경변수 설정
  • (brownfield) codegraph index 완료
  • Kiro /mcp → 서버 Initialized 확인