KIRO IDE 처음 사용하기 - 바이브 코딩의 새로운 패러다임

이 글은 KIRO IDE를 처음 사용하는 일반인 및 개발자를 위해 작성되었습니다. 설치 방법부터 기본 사용법, 그리고 KIRO IDE가 제안하는 개발의 흐름을 소개합니다.

KIRO IDE란?

KIRO는 2025년 7월 15일 AWS에서 공개한 AI 기반 통합개발환경(IDE)입니다. "키로(きろ)" 는 일본어로 "회로", "경로", "길"을 의미하며, 인간의 창의성과 AI 자동화가 만나는 개발의 교차점을 상징적으로 표현합니다.

KIRO는 단순히 코드를 완성해주는 것이 아니라 Spec-Driven Development(스펙 중심 개발) 방식을 통해 프로젝트를 체계적으로 진행합니다.

바이브 코딩을 직접 해본 사람이라면 이런 경험을 해봤을 것입니다

AI에게 한번에 너무 많은 일을 시키면 겉핧기식 코드만 생성되고 코드 품질이 떨어집니다.
작은 단위로 나누어 시키면 일관성이 떨어지는 코드 생성되고 코드 품질이 떨어집니다.
시간이 갈수록 디버깅과 유지보수가 어려운 뒤죽박죽 코드가 됩니다.

KIRO는 이런 문제 해결을 위해 계획 → 설계 → 구현의 구조화된 접근 방식인 Spec-Driven Development 방식을 이용합니다.

이 글에서는 간단한 사용법을 알아보면서 KIRO가 제안하는 개발의 흐름을 알아보겠습니다.

다운로드 및 설치

1. 다운로드

kiro.dev에 접속하여 운영체제에 맞는 설치 파일을 다운로드합니다. KIRO는 Windows, macOS, Linux를 모두 지원합니다. 다운로드를 제공하는 대신 Waitlist 등록이 필요할 수 있습니다. 이 경우 이메일을 등록하고 기다리면 다운로드 링크를 받을 수 있습니다.

2. 설치 및 실행

다운로드한 파일을 실행하고 설치 마법사의 안내를 따라 설치를 완료합니다. KIRO는 Code OSS(VS Code의 오픈소스 버전) 기반으로 제작되어 기존 VS Code 사용자에게 친숙한 환경을 제공합니다.

3. 로그인

최초 실행 시 다음 중 하나의 방법으로 로그인할 수 있습니다:

Google 계정
GitHub 계정
AWS Builder ID
AWS SSO

중요: AWS 계정이나 Amazon 계정이 반드시 필요한 것은 아닙니다. KIRO는 클라우드에 구애받지 않는 범용 도구입니다.

첫 프로젝트 시작하기

1. VS Code 설정 가져오기 (선택사항)

기존에 VS Code를 사용하고 있었다면 설정과 확장 프로그램을 가져올 수 있습니다. 이는 필수가 아니므로 건너뛰어도 됩니다.

2. 새 프로젝트 생성

KIRO IDE를 실행한 후, 새 프로젝트를 생성합니다. 프로젝트 이름과 저장 위치를 지정하면 됩니다.

주요 기능 사용법

AI 채팅 시작하기

KIRO의 핵심 기능인 AI 채팅을 시작하는 방법은 여러 가지가 있습니다:

키보드 단축키:

macOS: Cmd + L
Windows/Linux: Ctrl + L

명령 팔레트:

macOS: Cmd + Shift + P
Windows/Linux: Ctrl + Shift + P
"Kiro: Open Chat" 검색 후 실행

사이드바:

오른쪽 상단의 채팅 아이콘 클릭

컨텍스트 제공하기

채팅에서 # 기호를 사용하여 다양한 정보를 AI에게 제공할 수 있습니다:

#codebase #auth.ts 인증이 데이터베이스와 함께 어떻게 작동하는지 설명해줘

#terminal 마지막 build에서 발생한 에러를 분석해줘

사용 가능한 컨텍스트:

#codebase - 전체 프로젝트 코드
#file - 현재 파일
#folder - 현재 폴더
#git diff - Git 변경사항
#terminal - 터미널 출력

Autopilot 모드

Autopilot 스위치를 켜면 KIRO가 완전 자율적으로 작업을 수행합니다. 하지만 처음 사용할 때는 수동 모드로 시작하는 것을 권장합니다.

Autopilot 모드:

화면 우측 하단의 스위치로 활성화
AI가 완전 자율적으로 작업 수행
빠른 프로토타이핑에 적합

Supervised 모드:

Autopilot을 끈 상태
AI가 변경 전 승인을 요청
중요한 코드 작업 시 권장

Spec-Driven Development 이해하기

KIRO의 가장 큰 특징인 Spec-Driven Development는 다음 3개의 파일을 통해 작동합니다.

계획 → 설계 → 구현

1. 계획 (requirements.md)

사용자 스토리와 수용 기준을 EARS 형식(Easy Approach to Requirements Syntax)으로 정리
"무엇을" 만들어야 하는지 명확히 정의
예시: "사용자로서 로그인을 할 수 있어야 한다"

2. 설계 (design.md)

기술 아키텍처와 구현 방법 문서화
데이터베이스 구조, API 설계 등 포함
"어떻게" 만들 것인지 설계

3. 구현 (tasks.md)

실제 구현 작업을 단계별로 나누어 정리
각 작업이 요구사항과 연결되어 추적 가능
개발자가 실제로 해야 할 일들의 체크리스트

실제 사용 예시

간단한 할 일 관리 앱 만들기

KIRO 채팅에서 요청:

할 일을 추가하고 완료 표시할 수 있는 간단한 웹 앱을 만들어줘

단순히 이렇게 요청을 하겠지만 Kiro가 프로젝트를 제대로 이해하고 진행하는지 확인해야 합니다.

KIRO의 동작:

Kiro가 무엇을, 어떤 기술로, 어떤 구조에서 구현 중인지 를 다음과 같은 문서에 정리해줍니다.

requirements.md 생성 (사용자 스토리 작성)
design.md 생성 (컴포넌트 구조 설계)
tasks.md 생성 (구현 단계 계획)

이후에 이 문서들을 지도 삼아서, 실제 코드 생성을 단계적으로 진행하게 됩니다.

결과: 체계적으로 문서화되고 테스트까지 포함된 완성된 앱이 완성됩니다.

Agent Hooks와 Steering

KIRO에서 이야기하는 주요 컨셉인 Agent Hooks와 Steering에 대해 알아보겠습니다.

Agent Hooks

반복적인 작업을 자동화하는 기능입니다:

Git 자동 커밋: 작업 완료 시 자동으로 변경사항 커밋
문서 자동 업데이트: 코드 변경 시 문서 자동 갱신
코드 품질 검사: 파일 저장 시 자동으로 코드 품질 분석

Steering

AI가 프로젝트에 맞게 작동하도록 가이드하는 파일들:

product.md: 제품 비전과 목표 사용자 정의
structure.md: 프로젝트 폴더 구조 설명
tech.md: 사용하는 기술 스택과 개발 도구 명시

MCP (Model Context Protocol)

MCP는 KIRO가 외부 도구와 연결되는 방식입니다.

예를 들면 다음과 같은 기능을 제공합니다.

AWS 문서 서버에 연결하여 최신 정보 확인
데이터베이스 스키마 실시간 조회
API 문서 자동 참조

초보자는 처음에는 이 기능을 사용하지 않아도 되지만, 연동을 원하는 사람을 위해 간략히 연동방법을 소개합니다.

IDE의 Kiro “유령(ghost)” 탭을 클릭하고, 목록에서 “MCP Servers” 항목을 찾은 뒤, “+” 버튼을 눌러 MCP 서버를 추가합니다.

{
 "mcpServers": {
   "server-name": {
     "command": "command-to-run-server",
     "args": ["arg1", "arg2"],
     "env": {
       "ENV_VAR1": "value1",
       "ENV_VAR2": "value2"
     },
     "disabled": false,
     "autoApprove": ["tool_name1", "tool_name2"]
   }
 }
}

위와 같이 mcp.json 파일이 열리는데요. 이 내용을 수정하여 MCP 서버를 추가할 수 있습니다. 자세한 방법은 각 MCP의 공식 문서를 참고하세요.

Tip & 주의사항

초보자를 위한 팁

1. 명확한 요청하기

AI에게 요청할 때는 구체적이고 명확하게 표현하는 것이 좋습니다. "좋은 코드 만들어줘"보다는 "사용자 인증 기능을 구현해줘"처럼 구체적으로 요청하세요.

❌ "좋은 코드 만들어줘"
✅ "사용자 로그인 기능을 구현해줘"

2. 단계별 접근

복잡한 프로젝트는 작은 단위로 나누어 진행하는 것이 좋습니다. 각 단계가 완료되면 다음 단계로 진행하세요.

복잡한 프로젝트는 작은 기능부터 시작
각 단계가 완료되면 다음 단계로 진행

3. Spec 파일 활용

requirements.md, design.md, tasks.md를 정기적으로 확인하세요.
아 파일들을 잘 활용하면 AI가 더 정확한 코드를 생성합니다.
Kiro가 이 문서들을 자동으로 관리하지만 변경사항이 있으면 AI에게 문서 업데이트 요청할 수도 있습니다.

주의사항

코드 검토: AI가 생성한 코드는 항상 검토하고 테스트하세요
보안: 민감한 정보(비밀번호, API 키 등)는 코드에 직접 포함하지 마세요
인터넷 연결: KIRO는 Claude 4.0과 Claude 3.7 모델을 사용하므로 인터넷 연결이 필요합니다

가격 정보(Pricing)

현재 public preview 기간 중이므로 무료로 사용할 수 있습니다. 정식 출시 후 예상 가격:

Free Plan: $0 (월 50회 AI 상호작용)
Pro: $19/월 (월 1,000회 AI 상호작용)
Pro+: $39/월 (월 3,000회 AI 상호작용)

AI 상호작용 1회 = 기능 + 테스트 + 문서를 포함한 완전한 작업

더 나아가기

KIRO IDE는 계속 발전하고 있으며, 새로운 기능들이 추가되고 있습니다. 더 자세한 내용은 공식 문서를 참고하세요.

특히 다음 문서들을 추천합니다:

KIRO IDE는 AI와 함께 코딩하는 새로운 방식을 제시합니다. 체계적인 접근으로 고품질 코드를 생성할 수 있는 이 도구를 활용하여 더 효율적인 개발을 경험해보세요.

목차