AWS가 지난해 7월 공개한 AI IDE 키로(Kiro)는 ‘스펙 중심 개발(Spec-Driven Development)’이라는 철학을 앞세워 주목받고 있습니다. 기존 IDE에 AI를 붙인 수준을 넘어, 자연어 요구사항을 설계 문서와 코드로 자동 변환해 주는 것이 핵심입니다. 이 글에서는 키로 설치부터 실무에 바로 적용할 수 있는 핵심 기능 3가지를 정리해 보겠습니다.
키로 설치는 맥·윈도우·리눅스 모두 1분이면 끝난다
키로는 VS Code의 오픈소스 버전(Code OSS)을 기반으로 하기 때문에, 기존 VS Code 사용자라면 더욱 익숙하게 느껴질 것입니다. 설치는 운영체제별로 간단하게 진행할 수 있습니다.
- macOS, Linux: 터미널에서 Homebrew 한 줄이면 설치가 완료됩니다.
- Windows: kiro.dev에서 설치 파일을 내려받아 라이선스 동의, 경로 지정, PATH 추가 순서로 진행하면 됩니다.
첫 실행 시 GitHub, AWS Builder ID, Google 계정 등으로 로그인할 수 있으며, VS Code의 설정·확장 프로그램·테마를 그대로 가져오는 옵션도 제공됩니다. 이 덕분에 초기 세팅에 드는 시간이 확연히 줄어듭니다. 눈의 피로를 줄여주는 키로 전용 테마(Kiro Dark / Kiro Light)도 기본 내장되어 있습니다.
한 가지 알아둘 점은, AWS 계정이 반드시 필요한 것은 아니라는 사실입니다. 키로는 클라우드에 구애받지 않는 범용 도구로 설계되었습니다.
자연어 요청이 곧바로 설계 문서와 코드가 된다 Spec-Driven Development
키로의 가장 큰 특징은 스펙 중심 개발 방식입니다. 개발자가 “제품에 리뷰 시스템을 추가해 줘” 같은 자연어를 입력하면, 키로가 이를 요구사항·설계·DB 스키마·API 명세로 자동 변환합니다. 이 과정은 Spec Coding 모드를 켜면 활성화됩니다.
이 구조는 프로젝트 초기 단계에서 세 가지 핵심 파일을 생성합니다.
requirements.md: 프로젝트의 전반적인 요구사항을 정리design.md: 데이터 흐름과 아키텍처 설계를 기술.kiro/디렉터리: 에이전트 백엔드 연결과 스티어링(Steering) 문서를 저장
Forbes는 키로를 “프로토타입을 넘어 프로덕션급 코드를 뽑아내는 스펙 지향 IDE”라고 평가했습니다. GeekWire 역시 “AI가 스펙부터 코드·문서 유지보수까지 책임지는 구조적 IDE”라며 기업형 사용처를 강조했습니다.
자동 문서화와 프로젝트 이해 Steering 기능으로 코드베이스 파악이 쉬워진다
새로운 프로젝트나 팀에 합류했을 때, 코드 구조와 기술 스택을 빠르게 파악하는 것은 결코 쉬운 일이 아닙니다. 키로의 Steering 기능은 이 문제를 해결해 줍니다.
Generate Steering Docs 버튼을 누르면 두 가지 문서가 자동 생성됩니다.
- Structure 문서: 파일 디렉토리 구조, 네이밍 컨벤션, API 구조, 데이터베이스 관련 내용
- Tech 문서: 기술 스택, 주요 의존성, 빌드 명령어, 개발 환경 설정
이 문서들은 모두 한국어로 작성할 수 있으며, .kiro/steering 디렉터리에 마크다운 파일로 저장됩니다. 초기 프로젝트 이해도가 크게 올라가고, 팀 간 지식 전달 비용도 줄어듭니다.
또한 코드 블록을 선택한 후 마우스 오른쪽 버튼을 누르면 Write Docstring이나 Write Comments 같은 문서 관련 기능이 바로 보입니다. 키로는 일반적인 코드 완성보다 문서를 기반으로 답변을 생성하는 데 강점이 있습니다.
반복 작업 자동화와 MCP 서버 연동 실전에서 바로 써먹는 꿀팁
키로에는 소스 코드 수정이 끝날 때마다 자동으로 실행되는 Agent Hook 기능이 있습니다. 예를 들어 린트 검사, 테스트 실행, 문서 갱신 같은 반복 작업을 훅에 등록해 두면, 매번 수동으로 실행할 필요가 없습니다.
MCP(Model Context Protocol) 서버 연동도 가능합니다. IDE의 "유령(ghost)" 탭에서 MCP Servers 항목을 찾아 + 버튼을 누르면 mcp.json 파일이 열리는데, 여기에 원하는 MCP 서버 정보를 추가하면 됩니다. 구체적인 설정 방법은 각 MCP 공식 문서를 참고하는 것이 좋습니다.
실전에서 주의할 점도 있습니다. 키로는 설계 문서를 바탕으로 답변하기 때문에, 문서화가 미흡한 프로젝트에서는 오히려 일반 AI 어시스턴트보다 적응 속도가 느릴 수 있습니다. 현업에서 “일단 개발하고 보는” 문화가 강한 팀이라면, 키로의 장점을 온전히 살리기 어려울 수도 있다는 점을 염두에 두어야 합니다.
Cursor vs 키로, 어떤 선택이 맞을까?
The New Stack은 “키로는 Cursor·Windsurf에 맞선 AWS의 스펙 중심 해답”이라고 분석했습니다. 두 도구는 접근 방식에서 분명한 차이가 있습니다.
| 구분 | 키로 (Kiro) | Cursor |
|---|---|---|
| 핵심 철학 | 스펙 중심 개발 (계획 → 설계 → 구현) | 즉흥적 코드 생성 및 수정 |
| 강점 | 고품질 설계 문서, 프로젝트 이해도, 인프라 연동 | 다양한 AI 모델 자유 선택, 빠른 코드 변경 |
| 추천 대상 | 체계적인 문서화가 필요한 팀, 대규모 프로젝트 | 개인 개발자, 빠른 프로토타이핑이 필요한 경우 |
공개 미디어에 따르면 프리뷰 기간에는 무료 플랜이 제공되며, 이후 단계적 과금이 적용될 예정입니다. 정식 출시 후 예상 가격은 월 20달러 안팎으로 전해지지만, 확정된 정책은 아니므로 공식 발표를 지켜봐야 합니다.
Q. 키로는 한국어를 완전히 지원하나요?
처음 실행 시 기본 언어가 영어로 설정되어 있어, 하단 채팅창에 “한국어로 답변해 줘”라고 입력해야 이후 대화가 한국어로 유지됩니다. 생성된 문서와 코드 주석도 한국어로 작성할 수 있습니다.
Q. 기존 VS Code 확장 프로그램을 모두 사용할 수 있나요?
키로는 Code OSS 기반이므로 대부분의 VS Code 확장 프로그램이 호환됩니다. 첫 실행 시 설정과 확장을 그대로 가져오는 옵션이 제공됩니다.
Q. AWS 계정이 없어도 키로를 사용할 수 있나요?
네, 가능합니다. 키로는 AWS 계정이 반드시 필요하지 않으며, GitHub나 Google 계정으로도 로그인할 수 있습니다. 다만 AWS CDK·SAM 연동을 사용하려면 AWS 자격 증명이 필요합니다.
Q. 키로의 Autopilot 모드는 무엇인가요?
Autopilot 스위치를 켜면 키로가 완전 자율적으로 작업을 수행합니다. 처음 사용할 때는 수동 모드로 시작해서 기능을 익힌 후 활성화하는 것을 권장합니다.