AWS AI IDE Kiro(키로) 사용방법과 사용후기 (문서화, 프로젝트 이해)

세상이 너무 빠르게 돌아간다. 생산성에 환장하는 개발자(는 바로 나)에겐 정말 좋은 소식이 아닐수가 없다.

이제 앞으로 개발자 뿐만 아니라 누구나 'AI와 같이 코딩하는 시대'가 되고 있음을 체감하고 있다. 

 

vsCode의 코파일럿(Copilt)과

2021.07.02-🌱깃허브 코파일럿(Github Copilot), AI가 코드 대신 짜준다!?@

 

JetBrain의 AI Assistant에 이어서 

2025.04.01-JetBrains AI Assistant 사용방법과 사용후기 (코드설명,리팩토링 제안)

 

 

이번엔 AWS의 AI Kiro(키로)이다. 

https://kiro.dev/blog/introducing-kiro/

Introducing Kiro

 

 

 

1. Kiro (키로)란? 

2025년 7월 16일, AWS에서 출시한 AI기반 IDE(통합 개발 환경).

전통적인 IDE인 vsCode와 JetBrain에 AI를 얹었다기 보다는, CursorAI 처럼 처음부터 AI를 달고 나온 IDE이다. 

단순히 코딩을 도와주는 AI 기능을 넘어서, 프로포타입의 아이디어를 구체화 해서 프로덕션 단계까지 연결해줌으로써 개발 프로세스를 비롯한 전반적인 업무 생산성을 극대화 시키는게 목표이다. 

개인적으로 요 유령같은 캐릭터가 귀엽다.

 

키로의 핵심철학은 '사양 기반 개발' (Spec-driven development)이다.

명확한 사양(Spec)이 정의가 되었다면, 키로 덕분에 이 스펙을 바탕으로 코드를 쉽게 생성해 줄 수 있는 것이다.

 

2. Kiro (키로) 설치 방법

궁금한거 못 참는 개발자는 일단 냅다 설치부터 한다. (다운로드)

현재 MacOs, 윈도우, 리눅스 모두 지원한다. 

 

로그인하고 kiro를 실행하면, 개발환경 세팅을 시작 할 수 있다.

VS Code 기반이라 그런지 전체적으로 익숙했고 역시 라이트한 느낌이 있었다.

 

왼쪽에는 specs, hook, agents Steering, mcp server 등 키로와 관련된 설정들을 볼수 있는 창들이고,

가운데에는 아직 나타나진 않았지만 자기가 개발할 코드가 나올 창이다.

그리고 오른쪽에는 AI 코딩 메이트, 키로와 대화를 할수 있는 대화 세션창이다. 

3. Kiro (키로) 기능 

키로는 Vibe(바이브)와 Spec(스펙)이라는 두가지 모드가 있다. 

바이브 모드는 아예 새로운 아이디어부터 처음 구현하는 프로젝트에 사용하는 모드이고

스펙 모드는 이미 구현이 되거나 상세한 스펙들이 이미 정해진 프로젝트 사용하는 모드이다. 

 

하단의 대화창을 보면 이렇게 AutoPilot이 활성화 되어 있다. AI가 주도적으로 제안을 해주겠다는 것이다. (든든할지도?)

그리고 모델을 선택할수도 있는데, Claude Sonnet 4.0이나 3.7 모델을 선택할수 있다.  (기본은 4.0 버전)

 

아무래도 AWS에서 만든거다보니 키로는 기본적으로 영어로 답변한다. 

그래서 " 한국어로  답변해줘 " 라고 채팅창에 입력을 해야, 한국어로 계속 대화가 가능하다.

벌써 내 프로젝트를 파악했나본걸?

 

4. Kiro (키로) 살펴보기 -  코드 리팩토링, 코드설명은 기본! 

자세하게 세부 기능들을 알아보기 전에, 우선 기본적으로 JetBrains AI 에서도 가능했던 기능을 바탕으로  '키로'를 살펴보았다.

이렇게 원하는 코드블록을 한 뒤 키로 기능에서 Chat, Fix the code 를 비롯한 기본 기능을 사용할수 있다.

 

키로는 아무래도 설계 기반이라 그런지 "Write Docstring"이랑 "Write Comments" 처럼 문서관련 기능이 눈에 보였다.

기본적으로 코드에 오류가 있어서 이 부분을 블록하고 고쳐달라고 요청해봤다.

 

그런데 Jetbrains의 AI와는 약간 다르게 설계문서를 먼저 확인한다. 

일반적인 코딩의 문법을 우선시 한다기보다 '문서'를 계속 읽고 확인해서 답변을 작성하는 특징이 보였다. 

아니 그냥 고쳐달라구용ㅜㅜ

 

그리고 스펙모드로 시작해서 현재 개발 프로젝트의 전체적인 코드를 설명해달라고 물어봤다.

 

전반적으로 이런 구성으로 답변을 제공해주었는데, 프로젝트 구조를 이해하기에 도움이 되었다.

답변 그대로 아예 프로젝트 설명서 문서를 작성해도 될 정도였다.

 

📋 프로젝트 개요

🎯 핵심 기능별 코드 구조 - API endpoint기준

🔧 핵심 서비스 로직 - @Service 기준 (로직특징)

⚙️ 설정 및 인프라 - 클라이언트 및 데이터베이스 설정

🔄 서비스 공통 아키텍처
📊 모니터링 및 운영 - 로깅,매트릭, 캐싱전략

 

그래서 이번엔 아예 README.md를 작성해달라고도 요청해봤다.

 

그랬더니 이렇게 전체적인 파일구조를 알아서 읽어서 

프로젝트의 구조와 기능을 바탕으로 기술 스택이랑 아키텍처 설계 설명을 추가하고, 

리소스 파일에서 매핑정보를 가지고 와서 API 엔드포인트들도 정리해서 추가해줬다.

개발환경 구축시 단계별 가이드까지 포함해서 README.md를 수정해주었다.

 

5. Kiro (키로) 살펴보기 -  'Steering' 으로 프로젝트 이해하면 좋을듯?

키로는 이렇게 프로젝트에 대한 이해도를 높이기 위한 'Steering' 기능이 별도로 있다.

"Generate Steering Docs" 버튼을 누르면, 이렇게 구조와 기술적인 부분의 .md 문서가 작성이 된다. 

 

'Structure(구조)'와 관련된 문서에는 이렇게 파일 디렉토리를 포함해서 네이밍컨벤션, API구조,데이터베이스 관련 내용이 있고, 

 

'Tech(기술)'과 관련된 문서에는 기술스택과 주요 의존성,  빌드 명령어와 개발환경 설저엥 대한 내용이 있다.

그런데 이렇게 전부 다 영어로 나온다. 별도로 한국어로 바꿔달라고 다시 요청해야한다. 

 

또는 아래와 같은 한국어 프롬프트를 사용해서 다시 명령을 내려도 된다.

출처 : https://channy.creation.net/blog/1941 

# 한국어 응답 규칙
## 언어 설정 - 모든 응답은 한국어로 작성해야 합니다
- 코드 주석도 가능한 한 한국어로 작성합니다
- 기술 용어는 필요시 영어와 한국어를 병행 표기합니다 (예: "컨테이너(container)")
- 에러 메시지나 로그는 원본 언어를 유지하되, 설명은 한국어로 제공합니다
## 예외 상황
- 코드 자체는 영어로 작성 (변수명, 함수명 등)
- 공식 문서나 명령어는 원본 언어 유지
- 사용자가 명시적으로 다른 언어를 요청하는 경우에만 예외 적용

 

키로의 steering 기능으로 다시 한국어로 작성한 기술과 구조 관련 문서들은 초기 프로젝트를 이해하는게 큰 도움이 되었다.

혹시 만약에 새로운 회사에 입사해서 전반적인 코드를 빠르게 습득해야하는 상황에 도움이 될 것 같다.

 

참고로 이렇게 생성된 문서들은 (.kiro/steering)에 별도의 md 문서로 생성된다.

 

6. Kiro (키로)  사용 후기 느낀점 

이 외에도 키로의 다양한 기능을 통해 개발 프로세스의 생산성을 높여준다.

 

프로젝트로 구현하기 위한 구체적인 상세계획을 만들어주는 'Specs' 와

소스 코드 수정을 끝 마쳤을때마다 수행하는 반복기능을 자동화 해주는 'Agent Hook', 

그리고 외부API나 외부정보를 활용할수 있는 MCP 기능까지 있다. 

 

아무래도 AWS에서 만든 IDE툴이기 때문에 AWS와 연동성이 좋은건 분명하다.

심지어 AWS 아키텍쳐 다이어그램을 만드는것도 가능하다고 한다...ㄷㄷ 

 

키로의 모든 기능을 직접 사용해보진 못했지만

키로를 잠깐 사용해보고 느낀 점은 개발을 '문서화'를 하기 위한 AI 도구라고 느껴졌다.

'설계 기반의 개발'이라는 키로의 철학답게 모두 하나의 문서로 만들어도 손색없는 답변들이였다.  

그러나 단지 일반적인 코드의 오류나 리팩토링까지 모두 설계 문서를 바탕으로 답변한 부분이 개인적으로는 아쉬웠다.

물론 개발원칙이라던지 네이밍이라던지 그런 모든 부분까지 완벽한 설계 문서가 있다면 만족스러웠겠지만

현업에서는 아무래도 일단 개발을 하고 보기 때문에 설계는 뒷전이 되는 경우가 많지 않을까싶다. 

 

그래도 개인적으로 '키로'를 사용해서는 그 어떤 문서도 작성되지 않은 업무나 신규 프로젝트를 이해하는데에는 꽤 큰 도움이 될것 같다.

아무래도 신규로 회사에 입사했을때 새로운 코드를 빠르게 익혀야할때? 유용하지 않을까 싶다.

정말 AI 도움을 얻을 통해 코드를 빠르게 개발하는 목적이라면 차라리 JetBrains의 AI 어시스턴트를 사용하는게 더 좋을것 같단 생각이다.