나 보려고 만든 Kiro IDE 세팅 및 시작방법 정리
3줄 요약:
- Kiro IDE는 AWS에서 출시한 AI 기반 통합개발환경으로, 스펙 기반 개발과 자동화 훅으로 프로토타입부터 프로덕션까지 체계적 개발 지원
- 기존 VS Code 설정을 그대로 사용하면서 Steering Docs 자동 생성, Agent Hooks 자동화, 자연어 기반 AI 개발 기능 활용 가능
- 개발자가 요구사항을 명확히 정의하고 AI와 대화형으로 개발하는 새로운 패러다임 제공
대부분의 개발자들이 AI 코딩 도구를 사용하다 보면 이런 경험을 해봤을 것입니다. AI가 열심히 코드를 작성했는데, 막상 보니 내가 원하던 기능과는 완전히 다른 결과물이 나온 경험 말이죠. AWS에서 출시한 Kiro IDE는 이런 '바이브 코딩'의 한계를 넘어서는 새로운 접근 방식을 제시합니다. 2025년 7월 공개된 이 혁신적인 도구는 스펙 기반 개발과 자동화 기능으로 개발 프로세스를 근본적으로 바꾸고 있습니다.
Kiro IDE에 대해서 알아보자
Kiro는 개념에서 프로덕션까지 AI 에이전트와 함께 작업할 수 있는 새로운 에이전틱 IDE입니다. 기존의 AI 코딩 도구들이 단순히 코드 생성에 집중했다면, Kiro는 계획과 구조를 중시하는 개발 방식을 채택했습니다.
Kiro는 '바이브 코딩'에 뛰어나지만 그 이상을 제공합니다. Kiro의 진정한 강점은 스펙과 훅 같은 기능을 통해 프로토타입을 프로덕션 시스템으로 발전시키는 것입니다.
주요 특징은 다음과 같습니다:
- VS Code 기반: 기존 설정과 확장 프로그램을 그대로 사용 가능
- Claude AI 탑재: Anthropic의 고성능 언어 모델 활용
- 스펙 드리븐 개발: 요구사항을 명확히 정의한 후 개발 진행
- 에이전트 훅: 파일 변경 시 자동화 작업 실행
(1) 설치 및 초기 설정
1. 설치 과정
Kiro IDE 설치는 간단합니다. 공식 웹사이트(kiro.dev)에서 운영체제에 맞는 버전을 다운로드하세요. Mac, Windows, Linux 모두 지원합니다.
2. 첫 로그인 설정
설치 후 처음 실행하면 로그인 화면이 나타납니다. GitHub, Google, AWS Builder ID 등 다양한 방식으로 가입할 수 있습니다. 개발자라면 GitHub 연동을 추천합니다.
3. 환경 설정 최적화
- VS Code 설정 가져오기: 기존 VS Code 환경이 있다면 설정과 확장 프로그램을 가져올 수 있습니다
- 테마 선택: 다크 또는 라이트 테마 설정
- Shell 통합: 터미널에서
kiro .명령어로 프로젝트를 바로 열 수 있도록 설정
(2) 프로젝트 시작하기
프로젝트 폴더 연결 방법
기존 프로젝트 열기:
- Kiro 실행 후 "Open Project" 선택
- 또는 터미널에서 프로젝트 폴더로 이동 후
kiro .명령 실행 - 또는 Github 레포지트리 새로 가져와도 됨
신규 프로젝트 생성도 물론 가능하며, 로컬과 원격 프로젝트 모두 지원합니다.
(3) Steering Docs 작성하기
스펙 기반 개발의 핵심임
자동 생성 기능
프로젝트를 연 후 가장 먼저 해야 할 일은 Steering Docs 생성입니다:
- 좌측 사이드바의 Ghost 아이콘(Kiro Panel) 클릭
- "Generate Steering Docs" 선택
- 자동으로
product.md,structure.md,tech.md등이.kiro/steering/폴더에 생성
스펙 문서 커스터마이징
생성된 문서들을 열어서 프로젝트 목적, 아키텍처, 개발 규칙 등을 구체적으로 작성하거나 수정하세요. 예를 들어:
- product.md: 프로젝트의 비즈니스 목표와 요구사항
- structure.md: 코드 구조와 아키텍처 패턴
- tech.md: 사용할 기술 스택과 라이브러리
필요하다면 테스트 전략, 코드 스타일 가이드 등 추가 스펙 파일도 생성할 수 있습니다.
(4) AI와의 대화형 개발
Agentic Chat 활용
Kiro의 핵심은 계획을 개발 과정의 중심에 놓는 'Vibe Planning' 접근 방식입니다. 기본 챗 인터페이스에서 자연어로 개발 요청을 할 수 있습니다:
예시 대화:
- "React 기반 대시보드 앱의 기본 구조와 API 설계 예시 만들어줘"
- "사용자 인증 시스템을 추가하고 싶어, JWT 토큰 방식으로"
- "데이터베이스 스키마를 최적화해줘"
3단계 개발 프로세스
Kiro는 모든 개발 작업을 3단계로 구조화합니다:
- Requirements 단계: 초기 요구사항을 구체적으로 정리
- Design 단계: TypeScript 인터페이스, API 엔드포인트, 데이터베이스 스키마 등 기술 설계 문서 자동 생성
- Implementation 단계: 태스크별로 순차적 개발 진행
각 단계에서 개발자가 검토하고 피드백을 제공할 수 있어, AI가 잘못된 방향으로 가는 것을 방지할 수 있습니다.
(참고) Agent Hooks: 반복 작업 자동화
자동화 기능 이해
Kiro Hooks는 파일 변경 시 코드 스캔이나 문서 업데이트 같은 작업을 자동으로 실행하는 이벤트 기반 자동화 기능입니다.
실용적인 Hook 예시
- 테스트 자동 업데이트: React 컴포넌트 수정 시 해당 테스트 파일 자동 갱신
- 문서 동기화: API 엔드포인트 변경 시 README 파일과 API 문서 자동 업데이트
- 보안 검사: 커밋 전 자격 증명 누출이나 보안 취약점 자동 스캔
- 코드 리뷰: 파일 저장 시 코드 품질 검사 및 최적화 제안
Hook 설정 커스터마이징
필요에 따라 Hook 설정을 수정할 수 있으며, 팀 전체의 개발 일관성을 유지하는 데 매우 유용합니다.
고급 기능 활용
Model Context Protocol (MCP) 지원
Kiro는 특수한 도구들을 연결하기 위한 Model Context Protocol (MCP) 지원을 포함합니다. 이를 통해 외부 데이터베이스, API, 모니터링 도구 등과 연동할 수 있습니다.
다중 언어 및 프레임워크 지원
Kiro는 JavaScript, TypeScript, Python, Java 등 주요 프로그래밍 언어를 모두 지원하며, React, Next.js, Django 등 인기 프레임워크와도 잘 작동합니다.
팀 협업 기능
Kiro는 서로 다른 팀이 작성한 다중 스펙을 처리할 수 있어, 프로젝트의 다양한 측면에서 협업이 가능합니다.
실전 활용 팁
효과적인 스펙 작성법
- 구체적인 요구사항 명시: 모호한 표현보다는 명확한 기능 정의
- 기술적 제약사항 포함: 성능 요구사항, 보안 정책 등
- 우선순위 설정: 핵심 기능과 부가 기능 구분
AI와의 효율적인 소통 방법
- 단계별 접근: 한 번에 모든 것을 요청하지 말고 단계별로 진행
- 피드백 제공: AI의 제안을 검토하고 개선사항 제시
- 컨텍스트 유지: 프로젝트 전체 맥락을 고려한 요청
가격 정책 (2025년 8월 기준)
현재 Kiro는 공개 프리뷰 단계로 무료로 사용할 수 있습니다:
- 무료 티어: 월 50회 AI 상호작용 제한
- Pro 플랜: 월 $19, 1,000회 상호작용 (계획 중)
- Team 플랜: 월 $39, 3,000회 상호작용 (계획 중)
프리뷰 기간 동안은 제한 없이 무료로 사용할 수 있어, 지금이 체험해볼 최적의 시기입니다.
다른 AI 개발 도구와의 차이점
Cursor, GitHub Copilot과의 비교
Cursor, GitHub Copilot, WindSurf 같은 도구들이 주로 채팅 인터페이스를 통한 AI 지원 코딩에 집중하는 반면, Kiro는 근본적으로 다른 접근 방식을 취합니다.
Kiro의 독특한 장점:
- 스펙 우선 개발 방식
- 체계적인 3단계 개발 프로세스
- 자동화 훅을 통한 반복 작업 제거
- 프로덕션 준비 코드 생성
Kiro IDE는 단순한 AI 코딩 도구를 넘어서, 개발 프로세스 자체를 혁신하는 도구입니다. 스펙 기반 접근 방식과 자동화 기능을 통해 개발자는 더 체계적이고 효율적으로 소프트웨어를 구축할 수 있습니다.
Kiro의 비전은 팀 간 설계 정렬 보장부터 상충하는 요구사항 해결, 기술 부채 제거, 코드 리뷰 엄격성 강화, 그리고 시니어 엔지니어가 떠날 때 기관 지식 보존까지, 소프트웨어 제품 구축을 어렵게 만드는 근본적인 문제들을 해결하는 것입니다.
지금 공개 프리뷰를 통해 무료로 체험할 수 있으니, 새로운 개발 방식을 경험해보시기 바랍니다. 앞으로 AI와 함께하는 개발의 미래가 바로 여기에 있습니다.
