※ 본 기사는 필자 개인의 검증 및 견해를 정리한 것이며, 소속 조직의 공식 견해나 발표와는 관계가 없습니다.

1. 서론

2026년 8월 5일, Kiro Crew가 공개되었습니다.

Kiro Crew는 Kiro CLI를 실행 기반으로 하여, 자신의 PC나 서버 위에서 구동할 수 있는 오픈소스(Open Source) 개발 워크스페이스입니다.

공식 페이지에서는 세션을 넘나드는 Memory, 정기 실행, 장시간 태스크, 복수 에이전트의 병렬 실행, Web 대시보드 등이 소개되고 있습니다. Kiro IDE나 Kiro CLI를 대체한다기보다, Kiro CLI와 기존의 .kiro 설정을 사용하면서 작업을 세션 외부까지 확장하는 프로덕트라는 위치를 점하고 있습니다.

이번에는 EC2 상의 Ubuntu에 도입하여 다음 범위까지 확인했습니다.

• Kiro CLI 설치 및 Builder ID 인증
• Kiro Crew Gateway의 systemd 기동
• CLI에서 기존 프로젝트 읽기
• 복수 파일 변경
• 변경 후 단체 테스트(Unit Test) 실행

한편, Web 대시보드, Memory, Schedules, 병렬 서브 에이전트 등은 미검증 상태입니다. 추후 시간이 되면 추가할 예정입니다.

2. Kiro Crew란

Kiro Crew의 특징을 간단히 정리하면 다음과 같습니다.

Kiro IDE나 Kiro CLI를 대체하는 것이 아니라, 기존의 .kiro 설정과 Kiro CLI를 이용하면서 작업을 세션 외부까지 지속시키는 계층을 추가하는 위치에 있습니다.

또한, Kiro Web에도 클라우드 상에서 자율 실행하는 기능이 있지만, Kiro Crew는 자신이 관리하는 환경에서 Gateway를 상시 구동하며 로컬 도구, 메모리, 정기 처리, 복수의 조작 화면을 공유할 수 있다는 점이 특징입니다.

3. 검증 환경

Kiro Crew 0.1.2는 검증 시점에 GitHub Releases의 stable 버전으로 공개되어 있었습니다.

4. EC2 상에서 Kiro Crew를 도입하고, CLI를 통한 코드 변경까지 시도하기

4.1 전제 패키지와 tmux를 준비하기

먼저, 전제 패키지를 도입했습니다.

sudo apt-get update
sudo DEBIAN_FRONTEND=noninteractive apt-get install -y \
ca-certificates \
...

EC2 Instance Connect 등의 브라우저 접속은 끊길 수 있으므로, 이후 작업은 tmux 내에서 진행했습니다.

tmux new -s kiro-setup

4.2 Kiro CLI를 설치하기

Kiro CLI를 설치합니다.

curl -fsSL https://cli.kiro.dev/install | bash
export PATH="$HOME/.local/bin:$PATH"
hash -r
...

이번에 도입된 버전은 kiro-cli 2.16.1이었습니다.

4.3 Builder ID로 인증하기

EC2와 같은 원격 환경에서는 디바이스 플로우(Device Flow)로 인증할 수 있습니다.

kiro-cli login --use-device-flow

터미널에 표시된 URL과 원타임 코드(One-time code)를 가지고 있는 브라우저에서 열고, Builder ID로 승인했습니다. 원격 머신에서의 인증에는 포트 포워딩(Port Forwarding)이 필요하지 않습니다.

인증 상태를 확인합니다.

kiro-cli whoami

Logged in with Builder ID

4.4 검증용 프로젝트 준비하기

최소한의 Python 프로젝트를 만들었습니다.

def add(a: float, b: float) -> float:
    """Return the sum of two numbers."""
    return a + b

import unittest
from calculator import add
class CalculatorTest(unittest.TestCase):
...

초기 상태의 테스트가 통과하는 것을 확인하고, Git에 커밋하고 있습니다.

python3 -m unittest -v
git add calculator.py test_calculator.py README.md .gitignore
git commit -m "Create initial calculator demo"

4.5 Kiro Crew 설치하기

공식 원라인 인스톨러 (one-line installer)를 사용했습니다.

curl -fsSL https://download.crew.kiro.dev/cli.sh | sh
export PATH="$HOME/.local/bin:$PATH"
hash -r
...

kirocrew 0.1.2

이 방법으로는 리포지토리 (repository)를 클론 (clone)하거나 로컬에서 프론트엔드 빌드 (frontend build)를 수행하지 않고, 릴리스 CDN (release CDN)으로부터 검증된 휠 (wheel)을 도입합니다.

초기 설정을 실행합니다.

kirocrew setup

이번 설정은 다음과 같이 했습니다.

• Workspace: 기본값인
  ~/workplace/kirocrew-workspace

• Slack 연동: 비활성화

• 타임존 (Timezone):
  Asia/Tokyo

• AWS로의 추가 배포: 실시하지 않음

4.6 Ubuntu에서 Gateway를 systemd 서비스로 실행하기

kirocrew doctor를 실행하자, Ubuntu의 사용자 네임스페이스 (user namespace) 제한으로 인해 다음과 같은 경고가 나타났습니다.

unshare(CLONE_NEWNS) failed with errno 1 (EPERM)

Kiro Crew는 Linux 상에서 에이전트 (agent)를 샌드박스 (sandbox)로 격리합니다. Ubuntu 23.10 이후 버전에서는 AppArmor의 제한으로 인해 일반 프로세스에서 네임스페이스를 생성할 수 없는 경우가 있습니다.

공식 가이드에서는 service install을 통해 Kiro Crew 전용 AppArmor 프로파일 (profile)과 systemd 서비스를 생성하는 방법을 안내하고 있습니다.

kirocrew service install
kirocrew service status

Active: active (running)

Gateway는 127.0.0.1:5476에서 대기했습니다.

ss -ltn | grep ':5476'

LISTEN 0 128 127.0.0.1:5476 0.0.0.0:*

4.7 사용 가능한 모델을 지정한 커스텀 에이전트 준비하기

Kiro Crew에서 채팅을 실행하기 전에, 이번 Builder ID에서 사용할 수 있는 모델 (model)과 에이전트 설정을 확인했습니다. 첫 실행 시에는 다음과 같은 에러가 표시되었습니다.

The model 'claude-opus-4.8' is not available.
Please use '/model' to select a different model and try again.

사용 가능한 모델을 확인합니다.

kiro-cli chat --list-models

이번 Builder ID에서는 auto, claude-sonnet-4.5, claude-sonnet-4 등을 사용할 수 있었지만, claude-opus-4.8은 목록에 없었습니다.

이 환경에서는 Kiro Crew가 생성한 에이전트 설정에 claude-opus-4.8이 지정되어 있었습니다. 이미 생성된 ~/.kiro/agents/kirocrew.json을 직접 변경해도 셋업이나 재시작 시 원래대로 돌아갔기 때문에, 이번에는 다른 이름의 커스텀 에이전트를 생성하여 회피했습니다.

from pathlib import Path
import json
source = Path.home() / ".kiro" / "agents" / "kirocrew.json"
...

이후에는 다음과 같이 에이전트 이름을 명시하여 실행했습니다.

kirocrew chat --agent kirocrew-sonnet

4.8 CLI에서 프로젝트 읽히기

이번 kirocrew chat

쉘의 현재 디렉토리가 아니라, Kiro Crew의 Workspace 하위에 있는 cli_chat이 작업 영역으로 사용되었습니다.

따라서 검증용 리포지토리를 다음 위치로 clone했습니다.

cd ~/workplace/kirocrew-workspace/cli_chat
git clone ~/work/kirocrew-demo demo

다음 요청을 보냅니다.

현재 작업 영역에 있는 demo 디렉토리를 확인하고,
demo/calculator.py와 demo/test_calculator.py의 역할을 설명해 주세요.
파일 변경이나 명령 실행은 하지 마세요.

Kiro Crew는 calculator.py의 add 함수와 test_calculator.py의 unittest를 정확하게 설명했습니다.

4.9 CLI에서 코드 변경 요청하기

마지막으로 코드 변경까지 시도했습니다.

요청 내용은 다음과 같습니다.

demo 프로젝트를 변경해 주세요.
demo/calculator.py에 두 수의 차를 반환하는
subtract(a: float, b: float) -> float 함수를 추가해 주세요.
...

비대화형 실행(non-interactive execution)에서는 쓰기 권한 확인 단계에서 멈췄기 때문에, 검증용 편집 에이전트(editing agent)에서는 쓰기 대상을 demo/**로, 쉘 실행을 단체 테스트(unit test) 명령으로 한정했습니다.

Kiro Crew에 의해 calculator.py에 다음 함수가 추가되었습니다.

+def subtract(a: float, b: float) -> float:
+    """Return the difference of two numbers."""
+    return a - b

테스트에는 양수와 음수가 되는 두 가지 케이스가 추가되었습니다.

def test_subtract_positive(self) -> None:
    self.assertEqual(subtract(5, 3), 2)
def test_subtract_negative(self) -> None:
    ...

README에도 함수의 설명이 추가되었습니다.

## Functions
- `add(a, b)` - 두 수의 합을 반환합니다
+- `subtract(a, b)` - 두 수의 차를 반환합니다

Kiro Crew는 변경 후 테스트를 실행하여 3건 모두 성공했다고 보고했습니다.

만약을 위해 사람 측에서도 차이점(diff)을 확인한 후 테스트를 재실행했습니다.

cd ~/workplace/kirocrew-workspace/cli_chat/demo
git status --short
git diff -- calculator.py test_calculator.py README.md
...

test_add (test_calculator.CalculatorTest.test_add) ... ok
test_subtract_negative (test_calculator.CalculatorTest.test_subtract_negative) ... ok
test_subtract_positive (test_calculator.CalculatorTest.test_subtract_positive) ... ok
...

이를 통해 Kiro Crew가 기존 코드를 읽고, 여러 파일을 변경하며, 테스트까지 실행할 수 있음을 확인할 수 있었습니다.

5. 검증 중 어려웠던 점

발표일 기준 초기 버전이었기 때문에 몇 가지 원인 파악이 필요했습니다.

5.1 Ubuntu 샌드박스 (Sandbox)

Ubuntu 24.04에서는 터미널에서 Gateway를 직접 실행하면 AppArmor에 의한 사용자 네임스페이스(user namespace) 제한에 걸렸습니다.

kirocrew service install을 통해 systemd 서비스와 전용 AppArmor 프로필을 생성함으로써 Gateway를 실행할 수 있었습니다.

5.2 모델 설정

이번 환경에서는 생성된 에이전트에 사용할 수 없는 claude-opus-4.8이 지정되어 있었습니다.

claude-sonnet-4.5

를 지정한 별칭의 커스텀 에이전트(Custom Agent)를 만듦으로써, 채팅과 코드 변경을 실행할 수 있었습니다.

5.3 Workspace와 현재 디렉터리(Current Directory)의 차이

cd로 이동한 디렉터리가 그대로 Kiro Crew의 CLI 세션으로 이어지는 것은 아니었습니다.

이번 CLI 세션에서는 ~/workplace/kirocrew-workspace/cli_chat 하위에 대상 리포지토리(Repository)를 배치해야 했습니다.

5.4 Semantic Memory의 런타임 에러(Runtime Error)

kirocrew doctor를 통해 임베딩(Embedding) 모델 자체는 다운로드되었지만, 다음 에러가 남았습니다.

Shared library with base name 'llama' not found

따라서 이번 글에서는 Semantic Memory나 벡터 검색(Vector Search)이 정상적으로 동작했다고 간주하지 않습니다.

6. Web 대시보드는 추후 확인 예정

Gateway는 127.0.0.1:5476에서 실행되고 있으므로, 원격 EC2에서 이용할 경우에는 포트를 직접 공개하지 않고, SSH 터널(SSH Tunnel) 또는 Session Manager의 포트 포워딩(Port Forwarding)을 사용하는 구성이 됩니다.

Windows에서 Session Manager로 전송하는 경우의 예시입니다.

aws ssm start-session `
--target <EC2_INSTANCE_ID> `
--document-name AWS-StartPortForwardingSession `
...

그 후, 로컬 브라우저에서 http://localhost:5476을 엽니다.

추후 다음과 같은 기능을 추가하고 싶습니다.

• Web 대시보드의 조작감
• Activity와 도구 승인(Tool Approval)
• 세션을 넘나드는 Memory와 Lessons
• Schedules
• 병렬 서브 에이전트(Parallel Sub-agent)

7. 직접 사용해 본 소감

Kiro Crew의 핵심은 단순히 Kiro CLI에 다른 UI를 붙이는 것이 아니라, 개발 작업을 세션 외부로 끌어내기 위한 상주 워크스페이스(Workspace)에 있다고 느꼈습니다.

이번에는 CLI를 통한 코드 변경까지만 확인할 수 있었지만, 기존 프로젝트를 읽어 들이고, 여러 파일을 변경하며, 테스트를 실행하는 단계까지는 작동했습니다.

한편, Kiro Crew 0.1.2에서는 모델 설정, Workspace, 권한 설정, Ubuntu 샌드박스(Sandbox) 등 초기 도입 시 이해해 두어야 할 포인트도 많았습니다.

초기 버전인 만큼 도입 시 몇 가지 시행착오가 필요했지만, Memory, Schedules, 장시간 태스크(Long-running Task), 병렬 에이전트까지 작동한다면 일반적인 대화형 코딩 에이전트와는 다른 방식으로 사용할 수 있을 것 같습니다.

8. 요약

이번에 확인한 내용은 다음과 같습니다.

• EC2 상의 Ubuntu 24.04에 Kiro Crew 0.1.2를 도입할 수 있었다
• Builder ID의 디바이스 플로우(Device Flow)로 Kiro CLI를 인증할 수 있었다
• systemd 서비스로서 Gateway를 실행할 수 있었다
• CLI에서 Python 프로젝트를 읽어 들일 수 있었다
• subtract 함수, 테스트, README를 변경할 수 있었다 - 변경 후 단위 테스트(Unit Test) 3건이 성공했다

Web 대시보드나 Memory 등 Kiro Crew다운 기능의 본격적인 검증은 이제부터 시작입니다.

우선 "EC2에 설치하여 CLI에서 코드 변경과 테스트까지 작동시킨다"는 단계까지는 확인했으므로, 일단 글을 마무리합니다.

9. 참고 자료

• Kiro Crew
• Kiro Crew GitHub
• Kiro CLI installation
• Kiro CLI authentication

Discussion