NxtCloud NxtCloud Workshop / 키로 AI 중급: 구조적 AI개발
로그인

사전 준비: Kiro·도구 설치

목표

오늘 쓸 도구를 한 번에 설치합니다. 아래 과정을 순서대로 따라오면 되는 사전 준비 단계입니다.

설치할 도구는 세 가지입니다.

도구역할
KiroAI 코딩 도구(에이전트 IDE). 오늘 앱을 만드는 무대입니다.
GStackKiro에 /review(코드 검토)·/cso(보안 점검) 같은 역할별 전문가 명령을 붙여 줍니다.
uv / uvx파이썬 CLI 도구를 즉석 실행하는 런처. 뒤에서 MCP 서버를 띄울 때 씁니다.
💡 알아두면 좋은 것 — GStack과 uv

실습에 꼭 필요한 내용은 아니지만, 오늘 쓰는 두 도구를 알아두면 뒤 단계가 한결 잘 보입니다.

GStack — 에이전트에 ‘전문가’를 붙이는 스킬 모음

GStack은 AI 코딩 에이전트(Kiro, Claude Code 등)에 재사용 가능한 전문가 역할을 얹어 주는 오픈소스 스킬 모음입니다. 설치하면 채팅에서 /review, /cso 같은 슬래시 명령을 쓸 수 있습니다.

각 명령 뒤에는 사람이 매번 쓰기 번거로운 긴 지시(프롬프트·점검 체크리스트)가 미리 짜여 있습니다. 그래서 한 줄만 입력해도 그 역할이 체계적으로 일합니다. 프롬프트 실력에 따라 결과가 들쭉날쭉해지는 문제를 줄이고, 검증된 지시를 재사용해 일관된 결과를 얻는 것이 핵심입니다.

  • /review — 코드 품질 검토. 버그·엣지케이스·가독성·유지보수 관점의 지적을 정리합니다.
  • /cso — 보안 책임자(Chief Security Officer) 관점의 보안 점검.

설치할 때 ./setup --host kiro처럼 대상 에이전트(host)를 지정합니다. 그래서 Kiro 외의 도구에도 같은 스킬을 붙일 수 있습니다. 오늘은 이 중 /review와 /cso만 씁니다. (저장소: github.com/garrytan/gstack)

uv / uvx — 빠른 파이썬 도구 실행기

uv는 Astral이 Rust로 만든 파이썬 패키지·환경 관리 도구입니다. 기존의 pip·venv·pipx가 나눠 하던 일을 하나로 묶었고, 속도가 수십 배 빠른 것으로 알려져 있습니다.

그중 uvx는 파이썬 CLI 도구를 전역 설치 없이 격리된 임시 환경에서 즉시 실행해 줍니다. JavaScript의 npx와 같은 역할입니다.

오늘 이게 필요한 이유는 MCP 서버가 파이썬 패키지로 배포되기 때문입니다. Lab 03에서 AWS 공식 문서 MCP 서버를 쓸 때, 설정 파일에 "command": "uvx"로만 지정하면 Kiro가 필요한 순간 uvx로 서버를 자동으로 내려받아 띄웁니다. 별도 설치 단계가 사라지고, @latest를 붙이면 늘 최신 버전으로 실행됩니다.

Step 1: Kiro IDE 설치 및 로그인

넥스트클라우드에서 받은 계정(비밀번호 설정·Access Portal 로그인)은 이미 마쳤다고 가정합니다. 여기서는 Kiro IDE를 설치하고 조직 계정으로 로그인합니다.

📄 KIRO 등록·이용 가이드 (PDF) 다운로드

계정 발급·비밀번호 설정부터 CLI 로그인까지 전체 과정은 위 가이드에 있습니다. 아래는 IDE 로그인 핵심 요약입니다.

1-1. Kiro 다운로드·설치

https://kiro.dev/ 에서 본인 OS용 Kiro를 내려받아 설치합니다.

1-2. 조직 계정으로 로그인 시작

Kiro를 실행하고 Sign in → Your organization을 선택합니다. 이어지는 화면에서 ⭐ 반드시 “Sign in via IAM Identity Center instead” 를 선택합니다. (일반 로그인으로 진행하면 안 됩니다.)

1-3. Start URL · Region 입력

항목값
Start URL넥스트클라우드가 안내한 Start URL (오타 없이 복사·붙여넣기)
Regionus-east-1

입력 후 Continue를 누릅니다.

1-4. 액세스 허용

브라우저에서 “Kiro IDE가 데이터에 액세스하도록 허용하시겠습니까?”가 뜨면 액세스 허용을 누릅니다. Kiro가 열리고 로그인된 상태면 성공입니다.

잠깐, 왜 IAM Identity Center인가요? — 넥스트클라우드가 발급한 조직 계정으로 로그인하려면 개인 Builder ID가 아니라 조직(IAM Identity Center) 경로를 써야 합니다. 그래서 Start URL과 Region(us-east-1)을 직접 입력합니다.

Step 2: GStack 설치·등록

2-1. GStack 내려받기

터미널을 열고 아래 명령을 실행합니다. --depth 1 --single-branch는 최신 1개 커밋만 얕게 받아 빠르게 내려받는다는 뜻입니다.

git clone --single-branch --depth 1 https://github.com/garrytan/gstack.git ~/.claude/skills/gstack

2-2. Kiro용으로 설치

--host kiro는 “Kiro용으로 설치하라”는 뜻입니다. 스킬이 Kiro로 복사되고 /review·/cso 명령이 켜집니다.

cd ~/.claude/skills/gstack && ./setup --host kiro

Step 3: uv 설치

뒤에서 MCP 서버를 실행할 때 쓰는 파이썬 도구 실행기입니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

Step 4: 3가지 설치 확인

확인 항목확인 방법통과 기준
① Kiro 응답Kiro 채팅에 안녕, 잘 들려? 입력한국어로 답이 옴
② GStack 인식Kiro 채팅에 / 한 글자 입력자동완성 목록에 /review·/cso가 보임
③ uv 설치터미널에 uvx --version 입력버전 숫자가 출력됨

잠깐, 왜? — Kiro는 AI 코딩 도구이고, GStack은 거기에 “코드 검토 전문가”, “보안 점검 전문가” 같은 역할별 명령을 붙여 줍니다. 명령 하나만 입력하면 그 역할이 대신 일해 줍니다. 오늘은 /review(코드 검토)와 /cso(보안 점검) 두 개만 씁니다.

🎯 체크포인트
  • Kiro에 로그인했다
  • GStack 명령(/review·/cso)이 자동완성 목록에 보인다
  • uvx --version이 버전을 출력한다
트러블슈팅

② 명령이 자동완성에 안 보임

→ Kiro를 완전히 껐다 다시 켠 뒤(세션 새로 시작) 다시 /를 입력합니다.

③ command not found

→ 새 터미널 창을 열거나 source ~/.zshrc를 실행한 뒤 다시 시도합니다.

Kiro 로그인이 계속 안 됨

→ 옆 사람 화면을 함께 보며 이후 단계를 따라와도 됩니다. 나중에 로그인되면 본인 화면으로 이어갑니다.

어느 단계에서 막혀 못 넘어감

→ 강사가 미리 만들어 둔 정답 예시 저장소로 이어갈 수 있습니다: github.com/nxtcloud-edu/nxt-kiro-agent-lv1

참고 자료