🚀 Kiro CLI 가이드

📚 가이드 목차

🎯 왜 Kiro CLI인가?

Q CLI의 가장 큰 문제점과 혁신적 해결

🔥 WSL 문제 해결

Windows 설치 복잡성 완전 해소

💻 설치 방법

3분 만에 끝나는 간단 설치

⚙️ 초기 설정

3가지 인증 방식 선택

🎯 주요 기능

Q CLI vs Kiro CLI 비교

📊 상세 비교표

모든 차이점 한눈에 보기

🎯 왜 Kiro CLI인가?

Q CLI의 가장 큰 문제점

Windows 사용자의 악몽: WSL 필수 설치

Q CLI 설치하려면...
1. Windows에서 WSL2 활성화
2. Ubuntu 설치
3. Linux 환경에서 Q CLI 설치
4. 터미널 2개 관리 (Windows + Linux)

이게 얼마나 번거로운지 아시죠? 😫

Kiro CLI의 혁신적 개선

✨ Windows 네이티브 지원!

Kiro CLI 설치는...
1. kiro.dev에서 .exe 다운로드
2. 더블클릭으로 설치
3. 끝!

이제 Windows에서도 Mac/Linux처럼 바로 사용 가능합니다!

🔥 Q CLI의 가장 큰 문제점과 해결

문제 1: Windows 설치의 복잡성

WSL이란?

WSL (Windows Subsystem for Linux): Windows에서 Linux를 실행하는 기능

Q CLI의 문제: Linux 전용 설계

Q CLI는 Linux 환경에서만 작동 → Windows 사용자는 WSL 필수

Windows 사용자가 겪는 실제 고통

Q CLI 설치 과정 (기존):

Windows 기능 켜기/끄기 → WSL 활성화
Microsoft Store → Ubuntu 다운로드 (수 GB)
Ubuntu 설치 및 초기 설정 (사용자명, 비밀번호 생성)
Ubuntu 터미널 열기
Linux 명령어로 Q CLI 설치
```
sudo apt update
sudo apt install q-cli
```
매번 Ubuntu 터미널에서만 실행 가능

실제 불편함:

❌ 이중 환경: Windows 파일을 Linux에서 접근하려면 /mnt/c/Users/... 복잡한 경로
❌ 터미널 2개: Windows PowerShell ↔ Ubuntu 터미널 왔다갔다
❌ 설치 시간: 30분~1시간 소요
❌ 용량: Ubuntu만 수 GB
❌ 복잡도: Linux 명령어 모르면 설치도 어려움
❌ 권한 문제: sudo 비밀번호 관리

Kiro CLI의 혁신적 해결

Kiro CLI 설치 과정 (개선):

kiro.dev에서 .exe 다운로드
더블클릭으로 설치
Windows PowerShell에서 바로 실행
```
kiro-cli chat
```

개선 효과:

✅ 단일 환경: Windows 네이티브 앱
✅ 터미널 1개: PowerShell 또는 CMD에서 바로 실행
✅ 설치 시간: 3분
✅ 용량: 수백 MB
✅ 복잡도: 일반 프로그램 설치와 동일 (Chrome, VSCode 설치하듯이)
✅ 권한 문제: 없음

비교 요약

항목	Q CLI (WSL 필요)	Kiro CLI (네이티브)
설치 단계	6단계	3단계
설치 시간	30분~1시간	3분
필요 용량	수 GB	수백 MB
Linux 지식	필수	불필요
터미널	Ubuntu 전용	Windows 기본 터미널
파일 접근	복잡 (`/mnt/c/...`)	간단 (`C:\...`)

문제 2: 인증 방식의 제한

Q CLI (기존)	Kiro CLI (개선)
❌ AWS Builder ID만 지원 ❌ 별도 계정 생성 필요 ❌ 이메일 인증 필수	✅ AWS Builder ID ✅ Google 계정 ✅ GitHub 계정 → 이미 가지고 있는 계정으로 바로 시작!

문제 3: 명령어 체계

Q CLI (기존)	Kiro CLI (개선)
`q login` `q chat` `q`	`kiro-cli login` `kiro-cli chat` 명령어가 더 명확해졌습니다!

💻 설치 방법 (정말 간단해졌습니다)

🪟 Windows 설치 (드디어 간단해졌습니다!)

이제 WSL 필요 없습니다!

1단계: 다운로드

https://kiro.dev/downloads/ 접속
Windows 버튼 클릭
Kiro-CLI-Setup.exe 다운로드

2단계: 설치

다운로드한 .exe 파일 더블클릭
설치 마법사 따라하기 (Next → Next → Install)
완료!

3단계: 실행

# Windows PowerShell 또는 CMD에서
kiro-cli chat

설치 시간: 3분 이내!

🍎 macOS 설치

1단계: 다운로드

https://kiro.dev/downloads/ 접속
macOS 버튼 클릭
Kiro-CLI.dmg 다운로드

2단계: 설치

.dmg 파일 열기
Kiro CLI.app을 Applications 폴더로 드래그
완료!

3단계: 실행

# 터미널에서
kiro-cli chat

🐧 Linux 설치

1단계: 다운로드

https://kiro.dev/downloads/ 접속
Linux 버튼 클릭
인스톨러 스크립트 다운로드

2단계: 설치

chmod +x kiro-cli-installer.sh
./kiro-cli-installer.sh

3단계: 실행

kiro-cli chat

⚙️ 초기 설정

1️⃣ 로그인

kiro-cli login

2️⃣ 인증 방식 선택

Q CLI와 달리 3가지 선택지!

✅ AWS Builder ID (기존 Q CLI 사용자)
✅ Google 계정 (새로운!)
✅ GitHub 계정 (새로운!)

3️⃣ 웹 브라우저 인증

자동으로 브라우저가 열리며 인증 진행 (Q CLI와 동일)

4️⃣ 시작!

kiro-cli chat

🎯 주요 기능

Q CLI에서 할 수 있던 것들

✅ AWS 리소스 조회
✅ 코드 작성 도움
✅ 디버깅 지원
✅ AWS 서비스 질문

Kiro CLI에서 추가된 것들

🆕 AI 에이전트: 복잡한 작업을 단계별로 자동 수행
🆕 MCP 서버 연동: Terraform, kubectl 등 외부 도구 연결
🆕 Spec 기반 개발: 요구사항 → 설계 → 구현 자동화
🆕 향상된 파일 접근: 프로젝트 전체 분석 및 수정

실제 사용 예시

Q CLI에서도 가능

"EC2 인스턴스 목록을 보여줘"

"Python으로 S3 파일 업로드 코드 작성해줘"

Kiro CLI에서만 가능

"Terraform으로 3-tier 아키텍처를 구성하고 배포해줘"

"현재 프로젝트의 보안 취약점을 찾아서 자동으로 수정해줘"

"CI/CD 파이프라인을 GitHub Actions로 구성해줘"

📊 Q CLI vs Kiro CLI 비교표

항목	Amazon Q CLI	Kiro CLI
Windows 설치	❌ WSL2 필수 (복잡)	✅ 네이티브 앱 (간단)
설치 시간	30분~1시간	3분
인증	AWS Builder ID만	Builder ID + Google + GitHub
명령어	`q`, `q chat`	`kiro-cli chat`
AI 기능	질의응답 중심	에이전트 기반 자동화
외부 도구 연동	❌ 없음	✅ MCP 서버 지원
파일 시스템	제한적 접근	전체 프로젝트 접근
복잡한 작업	단계별 안내	자동 실행

⚠️ 주의사항

권한 확인 메시지 (Q CLI와 동일)

Allow this action? Use 't' to trust (always allow) this tool for the session. [y/n/t]:

선택 옵션:

[y]: 한 번만 허용 (권장)
[t]: 세션 동안 항상 허용 (⚠️ 주의)
[n]: 거부

AWS 자격 증명 (Q CLI와 동일)

AWS 리소스 접근 시 AWS CLI 설정 필요:

aws configure

🔗 참고 자료

공식 문서

AWS 블로그

Transform DevOps with Kiro AI-powered agents

🎓 Q CLI 사용자를 위한 마이그레이션 가이드

기존 계정 그대로 사용 가능

kiro-cli login
# "AWS Builder ID" 선택하면 기존 Q CLI 계정 사용

명령어만 바꾸면 됩니다

Q CLI	Kiro CLI
`q login`	`kiro-cli login`
`q chat`	`kiro-cli chat`
`q`	`kiro-cli chat`

병행 사용 가능

Q CLI와 Kiro CLI는 동시에 설치 가능합니다.