Kiro IDE 사용법: 설치·로그인부터 첫 프로젝트 실행까지

핵심 요약: Kiro IDE는 설치하고 로그인한 뒤 프로젝트 폴더를 열어 사용합니다. 간단한 질문과 수정은 일반 채팅으로 시작하고, 요구사항·설계·작업 목록을 먼저 검토하려면 Spec을 선택하세요.

설치까지 마쳤는데 빈 화면 앞에서 다음에 무엇을 눌러야 할지 막힐 수 있습니다. 처음에는 작은 프로그램 하나를 만들고 직접 실행해보는 편이 좋습니다. 아래에서는 폴더를 여는 단계부터 Python 가계부 예제를 실행하는 과정까지 안내합니다.

2026년 11월 4일 Kiro 공식 문서를 확인해 정리했습니다. 대상은 데스크톱 Kiro IDE이며, 버전에 따라 메뉴 위치와 화면 문구가 달라질 수 있습니다.

Kiro IDE를 처음 쓸 때 따라갈 순서

  1. 운영체제와 CPU에 맞는 Kiro IDE 설치 파일을 받습니다.
  2. 로그인한 뒤 작업할 폴더를 엽니다.
  3. 채팅에서 기존 코드를 질문하거나, 만들 기능에 맞는 작업 방식을 선택합니다.
  4. 반복해서 지킬 규칙이 있으면 Steering 파일에 적습니다.
  5. 생성된 코드를 검토하고 터미널에서 실행해 결과를 확인합니다.

Kiro는 대화로 코드 설명과 수정을 요청할 수 있는 AI 개발 도구입니다. 사용법을 익히는 단계에서는 모든 기능을 한꺼번에 설정하기보다 위 흐름을 한 번 끝내보세요.

Kiro 설치와 로그인

Kiro 다운로드 페이지에서 IDE 설치 파일을 선택합니다. macOS·Windows·Linux용이 있으므로 운영체제와 CPU 종류를 확인하세요. 지원 버전과 Linux 배포판 조건은 공식 설치 안내에서 확인할 수 있습니다.

설치 파일을 실행하고 Kiro를 열면 로그인 절차가 이어집니다. 개인 사용자는 Google·GitHub·AWS Builder ID 중 사용하는 계정을 고르면 됩니다. 조직 계정은 AWS IAM Identity Center나 외부 인증 제공자를 이용할 수 있으며, 필요한 시작 URL·리전 등의 정보는 관리자에게 확인합니다. 인증은 브라우저에서 완료한 뒤 IDE로 돌아오는 방식입니다. 공식 로그인 안내

처음부터 AWS Builder ID를 새로 만들어야 하는 것은 아닙니다. 로그인 후 VS Code 설정과 확장을 가져오는 단계도 선택 사항이므로 필요할 때 진행하세요.

첫 프로젝트는 폴더를 열어 시작합니다

새 프로젝트라면 컴퓨터에 kiro-expense-demo 같은 빈 폴더를 먼저 만듭니다. Kiro에서 File > Open Folder로 그 폴더를 열면 됩니다. 기존 프로젝트도 같은 메뉴로 저장소 폴더를 선택합니다. 이 글의 실습에는 언어별 프로젝트 템플릿이 필요하지 않습니다. 공식 첫 프로젝트 안내

폴더를 열었는데 채팅이 보이지 않으면 macOS에서는 Cmd+L, Windows·Linux에서는 Ctrl+L을 누릅니다. 명령 팔레트에서 Kiro: Open Chat을 찾아도 됩니다. 채팅 열기 공식 안내

기존 코드가 있는 폴더에서는 곧바로 대규모 수정을 맡기기보다 다음처럼 시작할 수 있습니다.

이 프로젝트의 진입 파일과 실행 방법, 테스트 명령을 찾아서 설명해줘. 아직 파일은 수정하지 마.

답변에 나온 파일이 실제로 있는지 확인하면, 이후 요청할 작업의 범위를 정하기 쉬워집니다.

일반 채팅과 Spec은 언제 선택할까

채팅에 요청한다고 항상 스펙 문서가 생기는 것은 아닙니다. 일반 코딩 지원은 Default로 시작할 수 있습니다. 구현 전에 요구사항과 설계를 정리하고 싶다면 Spec을 선택합니다. Plan은 코드를 바꾸기 전에 구현 계획부터 살펴보고 싶을 때 쓰는 방식입니다. 작업 방식 선택 공식 안내

하고 싶은 작업시작하기 좋은 방식
코드 설명 듣기, 작은 함수 수정Default 채팅
새 기능의 요구사항·설계·작업을 나눠 검토Spec
변경 전에 구현 계획 검토Plan

새 기능의 Spec에서는 보통 .kiro/specs/ 아래에서 다음 문서를 확인하게 됩니다. 버그 수정용 Spec은 요구사항 문서 대신 bugfix.md를 사용하므로, 아래는 새 기능을 만드는 경우의 설명입니다. 스펙 구조 공식 안내

  • requirements.md: 어떤 기능과 완료 조건이 필요한지 정리합니다.
  • design.md: 파일 구성과 데이터 처리 방식을 살펴봅니다.
  • tasks.md: 구현할 작업을 나눕니다.

문서가 생성됐다는 것과 코드 구현이 끝났다는 것은 다릅니다. 요구사항과 설계를 검토한 뒤 작업 목록에서 실행할 항목을 선택하고, 완료된 코드가 조건을 충족하는지 확인하세요.

Steering으로 반복할 규칙을 남깁니다

Steering은 프로젝트의 규칙을 Markdown 파일로 전달하는 기능입니다. Kiro 패널에서 기초 문서를 생성하거나 직접 .kiro/steering/에 파일을 만들 수 있습니다. 아래는 Python 실습에 사용할 직접 작성한 규칙 예제입니다. Steering 공식 안내

.kiro/steering/python-style.md:

---
inclusion: always
---

- 함수와 변수 이름은 snake_case로 작성한다.
- 이 실습은 Python 표준 라이브러리만 사용한다.
- 금액 입력 검증과 CSV 저장 동작을 테스트한다.
- 작업을 마치면 수정한 파일과 실행할 테스트 명령을 설명한다.

기본 포함 방식은 always입니다. 파일 패턴에 맞을 때만 읽는 fileMatch, 수동으로 불러오는 manual 등도 있어 모든 Steering 파일이 매번 같은 방식으로 적용되는 것은 아닙니다. 커스텀 에이전트를 사용한다면 해당 에이전트의 resources 설정도 확인해야 합니다. 포함 조건과 커스텀 에이전트 안내

규칙을 적었다고 결과가 자동으로 정확해지는 것은 아닙니다. 생성된 파일과 테스트 결과를 함께 확인하세요.

Python 가계부로 첫 실행까지 해보기

아래 가계부는 기능을 익히기 위한 학습용 예제입니다. Python 실행 환경은 별도로 준비해야 합니다. Kiro에서 kiro-expense-demo 폴더를 열고, 통합 터미널의 현재 위치가 그 폴더인지 먼저 확인합니다.

1. Python과 가상환경 준비

macOS·Linux:

python3 --version
python3 -m venv .venv

Windows PowerShell:

python --version
python -m venv .venv

버전 명령이 실패하면 Python 설치와 명령 경로부터 확인합니다. 이후에는 가상환경 안의 Python을 직접 실행할 것이므로 별도로 활성화할 필요는 없습니다. 이 방식과 운영체제별 실행 파일 위치는 Python 가상환경 공식 문서에 설명돼 있습니다.

2. Spec을 선택하고 작은 기능 요청

새 채팅에서 Spec을 선택하고 다음 요청을 입력합니다.

Python 표준 라이브러리만 사용해 터미널 가계부를 만들고 싶어. main.py에서 지출의 날짜·금액·분류·메모를 입력받고 expenses.csv에 저장해줘. 월을 선택하면 합계를 보여줘. 금액은 정수로 처리하고 0 이하 금액과 잘못된 날짜는 거부해줘. 데이터 처리는 expense.py로 분리하고 tests/test_expense.py에 unittest 테스트를 작성해줘. 먼저 요구사항과 설계를 보여줘.

파일명과 동작을 구체적으로 적으면 결과를 확인할 기준도 생깁니다. 예제의 입력 제한은 학습을 위한 선택이므로, 환불이나 소수 금액이 필요하다면 요구사항부터 바꾸세요.

3. 문서 검토 후 구현 작업 실행

요구사항에서 입력 항목과 거부할 값이 맞는지, 설계에서 CSV 파일의 저장 위치와 월별 합산 방식이 명확한지 확인합니다. 빠진 내용은 구현 전에 수정 요청을 합니다.

작업 목록이 준비되면 tasks.md에서 해당 작업을 실행합니다. 완료 후 main.py, expense.py, tests/test_expense.py가 요청에 맞게 만들어졌는지 살펴봅니다. 다른 구조가 제안됐다면 실행 명령도 그 구조에 맞게 확인하세요.

4. 프로그램과 테스트 실행

요청한 파일 구성이 만들어졌다면 프로젝트 폴더에서 실행합니다.

macOS·Linux:

.venv/bin/python main.py
.venv/bin/python -m unittest discover -s tests

Windows PowerShell:

.\.venv\Scripts\python.exe main.py
.\.venv\Scripts\python.exe -m unittest discover -s tests

정상 입력을 저장한 뒤 프로그램을 다시 열어 데이터가 남아 있는지 확인합니다. 월별 합계가 입력한 금액과 맞는지, 잘못된 날짜와 0 이하 금액을 거부하는지도 직접 확인하세요. 테스트 명령이 끝났다는 사실만 보지 말고, 실제 테스트가 발견돼 실행됐는지와 실패 항목이 없는지까지 살펴봅니다.

실행이 막힐 때 확인할 것

  • 스펙 문서가 보이지 않을 때: 현재 선택한 에이전트가 Default인지 Spec인지 확인합니다. 일반 채팅에서도 문서가 자동 생성된다고 기대할 필요는 없습니다.
  • 파일을 찾을 수 없다고 나올 때: 터미널 위치와 실제 파일명을 확인합니다. 요청한 파일이 아직 생성되지 않았을 수도 있습니다.
  • Python 명령이 동작하지 않을 때: 위 버전 명령부터 확인합니다. Kiro에 폴더를 여는 것만으로 Python이 설치되지는 않습니다.
  • 결과가 요구사항과 다를 때: 에러 전문, 실행 명령, 기대한 결과와 실제 결과를 함께 전달합니다.

예를 들어 “고쳐줘”만 쓰기보다 “2026-11-04, 1200, 식비를 입력했는데 CSV에 저장되지 않는다”처럼 재현 조건을 적는 편이 문제를 좁히기 쉽습니다. 개인 가계부나 업무 저장소에서는 요청에 계정 정보와 실제 개인정보가 들어가지 않도록 예제 데이터로 재현하세요.

MCP 연결과 팀 작업은 첫 실행 다음에

외부 도구가 필요해지면 MCP를 연결할 수 있습니다. 프로젝트 설정은 .kiro/settings/mcp.json, 사용자 공통 설정은 ~/.kiro/settings/mcp.json입니다. 필요한 서버의 실행 환경과 설정을 확인한 뒤 연결하며, 이 Python 실습에는 MCP가 필요하지 않습니다. MCP 설정 공식 안내

팀에서는 공유할 스펙과 Steering 문서를 골라 Git으로 관리하고, 생성된 코드의 diff와 테스트를 검토합니다. .kiro/ 전체를 무조건 커밋하기보다 비밀 값이 들어간 설정이 없는지 먼저 확인하세요.

도구 선택이 아직 고민된다면

관련 글