테마
인터페이스 둘러보기
목표
Kiro IDE의 주요 패널과 기능 영역을 파악하고, 기본 단축키를 익힙니다.
사전 준비
- Kiro IDE 설치 및 로그인 완료
해볼 것
1단계: 전체 레이아웃 확인
Kiro를 실행하면 아래와 같은 인터페이스가 나타납니다:
2단계: 주요 패널 파악
| 영역 | 위치 | 역할 |
|---|---|---|
| 채팅 패널 | 우측 | AI와 대화하는 메인 영역 |
| 탐색기(Explorer) | 좌측 | 파일·폴더 탐색 |
| 편집기 | 중앙 | 코드 편집 |
| Kiro 패널 | 좌측 사이드바 | Specs·Steering·Hooks·MCP 관리 |
| 터미널 | 하단 | 명령줄 실행 |
3단계: Kiro 패널 구성
좌측 사이드바의 Kiro 아이콘을 클릭하면:
- Specs — 프로젝트 명세서 (Requirements·Design·Tasks)
- Steering — 개발 가이드라인 파일
- Hooks — 자동화 설정 (Agent Hooks)
- MCP Servers — 외부 도구 연동 상태
4단계: 실행 모드 확인
채팅 패널 상단에서 두 가지 모드를 선택할 수 있습니다:
| 모드 | 설명 | 권장 |
|---|---|---|
| Autopilot | AI가 자동으로 파일 생성·수정 실행 | 숙련자 |
| Supervised | 각 단계를 사용자가 승인 후 실행 | 초보자 ✅ |
💡 처음에는 Supervised 모드를 권장합니다. AI가 어떤 동작을 하는지 하나씩 확인할 수 있습니다.
5단계: 파일 기초 조작
탐색기와 편집기에서 자주 쓰는 파일 조작을 한 번씩 연습합니다:
| 조작 | 방법 | 단축키 |
|---|---|---|
| 새 파일 만들기 | 탐색기 빈 공간이나 폴더를 우클릭해 New File 선택, 또는 명령 팔레트에서 검색 | - |
| 저장 | 편집 중인 파일 저장 | Cmd+S / Ctrl+S |
| 이름 변경 | 탐색기에서 파일을 우클릭해 Rename 선택 | - |
| 파일 다시 열기 | 빠른 열기에서 파일 이름 검색. 최근 파일도 목록에서 선택 가능 | Cmd+P / Ctrl+P |
| 변경 되돌리기 | 편집 내용을 한 단계 취소. 작업 단위 복원은 Checkpoints 사용 | Cmd+Z / Ctrl+Z |
5·6단계의 조작과 단축키는 Kiro/Code OSS 공통 기준입니다. 실제 바인딩이 다를 경우 명령 팔레트에서 해당 기능을 검색하세요.
6단계: 기본 단축키
| 단축키 | 기능 |
|---|---|
Cmd+Shift+P (macOS) / Ctrl+Shift+P (Win/Linux) | 명령 팔레트 |
Cmd+L / Ctrl+L | 채팅 패널 열기/닫기 |
Cmd+I / Ctrl+I | 인라인 채팅 |
Cmd+B / Ctrl+B | 사이드바 토글 |
Ctrl+` | 터미널 토글 |
Cmd+P / Ctrl+P | 파일 빠른 열기 |
Cmd+Shift+F / Ctrl+Shift+F | 전체 검색 |
Cmd+, / Ctrl+, | 설정 열기 |
7단계: 컨텍스트 프로바이더
채팅 입력창에서 #를 입력하면 대화에 참조할 컨텍스트를 지정할 수 있습니다. Kiro는 지정된 범위만 읽어 더 정확한 답을 만듭니다. 범위는 #file(파일 하나) → #folder(폴더 전체) → #codebase(프로젝트 전체) 순으로 넓어지며, 좁게 시작할수록 응답이 빠르고 정확합니다.
각 프로바이더의 사용 예와 상세는 첫 대화·컨텍스트에서 정리합니다. 먼저
#file·#folder로 좁게 시작하는 것을 권장합니다.
8단계: 첫 대화 테스트
컨텍스트 없이 간단한 프롬프트로 채팅이 동작하는지 확인해봅니다:
안녕하세요! 지금 열려 있는 프로젝트의 구조를 간단히 설명해주세요.프로젝트가 없다면 아래처럼 일반 질문으로 테스트할 수 있습니다:
Kiro의 Spec 세션과 Vibe 세션의 차이를 한 문장으로 설명해주세요.9단계: 세션과 컨텍스트 관리
Kiro에서 "새 대화"를 시작하면 이전 대화의 맥락이 초기화됩니다. 반면 기존 세션을 이어가면 이전 질문·답변을 기억한 상태로 대화가 계속됩니다.
컨텍스트가 길어지면 응답 정확도와 속도가 떨어질 수 있으므로, 주제가 바뀔 때는 새 세션을 시작하는 것을 권장합니다.
💡 Steering 파일과 Spec 문서는 세션과 무관하게 프로젝트에 영속됩니다. 새 세션을 시작해도 이 설정들은 그대로 적용됩니다.
10단계: 유용한 팁
💡 시작할 때 기억하면 좋은 것들
- 좁은 컨텍스트로 시작하세요 —
#file→#folder→#codebase순서로 필요한 만큼만 넓힙니다 (7단계 참조). - 처음엔 Supervised 모드로 관찰하세요 — AI가 어떤 단계를 거치는지 하나씩 확인할 수 있습니다 (4단계 참조).
- 막히면 명령 팔레트(
Cmd/Ctrl+Shift+P)에서 검색하세요 — Kiro의 모든 기능은 명령 팔레트에서 접근할 수 있습니다.
기대 결과
- Kiro IDE의 레이아웃과 각 패널의 역할을 이해
- Supervised/Autopilot 모드의 차이를 알고 선택 가능
- 기본 단축키로 빠르게 패널 전환 가능
- 채팅 패널 위치 확인필수
- Kiro 패널 (Specs·Steering·Hooks·MCP) 확인필수
- Supervised 모드 선택 확인필수
- 새 파일 만들기·저장·이름 변경 해보기필수
- 컨텍스트 프로바이더 (#file·#folder·#codebase) 확인필수
- 첫 대화 테스트 프롬프트 실행 성공필수
- 명령 팔레트 (Cmd/Ctrl+Shift+P) 열기 성공선택
- 새 세션 시작과 기존 세션 이어가기의 차이 이해선택
- 파일 빠른 열기(Cmd/Ctrl+P) 사용 성공선택
🚨 문제 해결
- 채팅 패널이 안 보임:
Cmd+L(또는Ctrl+L)로 토글. 또는 명령 팔레트에서 "Chat" 검색. - Kiro 패널이 없음: 좌측 사이드바의 Kiro 로고 아이콘 클릭. 보이지 않으면 Kiro 재시작.
- 단축키가 다름: 명령 팔레트에서 원하는 명령을 검색하면 현재 단축키를 확인할 수 있습니다.