Kiro CLI

어떤 사용자에게 맞는가

Kiro CLI는 터미널과 기존 편집기를 중심으로 개발하는 사람을 위한 AI 코딩 도구입니다. 저장소 구조 파악, 오류 원인 조사, 테스트 작성, 반복적인 개발 절차에 활용할 수 있습니다. 답변을 보여주는 데 그치지 않고 파일과 명령을 다루므로, 요청 범위와 실행 권한을 정하고 결과를 검토하는 방식으로 사용해야 합니다.

공식 제품 안내에 따르면 Kiro IDE와 같은 구독 요금 체계를 사용하며, 독점 소프트웨어 라이선스로 배포됩니다.

지원 OS와 버전 검토

2026년 10월 7일 확인한 설치 문서는 CLI 지원 환경을 macOS, Windows 11의 PowerShell, Linux로 명시합니다. Linux는 glibc 2.34 이상 또는 musl용 배포가 기준입니다. 기존 제품 데이터의 macOS 단독 표기는 보강이 필요합니다.

현재 공식 문서에는 CLI V3와 2.x 참고 문서가 함께 있습니다. 입력된 2.27.1을 최신 버전으로 확정할 근거는 확보하지 못했습니다. 확인한 페이지에서 제품 전체의 지원 종료 공지는 발견되지 않았으나, 2.27.1의 개별 지원 기간은 확인되지 않았습니다.

설치와 첫 작업 순서

공식 다운로드 페이지에서 CLI 항목과 운영체제별 안내를 먼저 확인합니다. macOS·Linux용 안내 명령은 curl -fsSL https://cli.kiro.dev/install | bash입니다. Windows에서는 공식 페이지의 Windows 안내를 따릅니다. 설치 후 브라우저 인증을 완료하고, 프로젝트 폴더로 이동해 kiro-cli를 실행합니다.

처음에는 프로젝트 구조 설명처럼 범위가 작은 요청으로 시작합니다. /guide로 설치된 버전에 맞는 사용법을 확인하고, @로 대상 파일을 지정하면 요청을 구체화할 수 있습니다. 변경 작업은 Plan 모드에서 계획을 검토한 뒤 진행하는 것이 좋습니다.

주요 기능과 실무 활용

Steering은 팀의 코딩 규칙과 프로젝트 정보를 전달하고, 맞춤 에이전트는 코드 리뷰나 테스트 작성처럼 반복되는 역할을 구성합니다. MCP는 외부 서비스와 데이터를 연결하며, Hooks와 Headless 모드는 반복 절차와 CI/CD 작업에 활용할 수 있습니다.

예를 들어 인증 API의 회귀 오류를 조사할 때 대상 라우트와 테스트 파일을 지정해 “실패 원인과 재현 조건을 분석하고 수정 계획을 제시해 달라”고 요청할 수 있습니다. 계획 검토 후 테스트 추가와 최소 수정으로 범위를 좁히고, 실제 테스트 결과와 변경 내역을 확인하는 흐름입니다. 이는 활용 예시이며 직접 실행한 결과는 아닙니다.

무료·유료 요금과 사용량 제약

공식 가격표의 Free는 월 0달러에 50크레딧입니다. 유료 개인 요금은 사용자당 월 Pro 20달러·1,000크레딧, Pro+ 40달러·2,000크레딧, Pro Max 100달러·5,000크레딧, Power 200달러·10,000크레딧이며 세금은 별도입니다.

크레딧 소모는 작업 복잡도와 모델에 따라 달라지므로 50크레딧을 질문 50회로 해석하면 안 됩니다. 무료 모델 접근에는 요청률 제한이 있고, Free는 추가 크레딧 구매를 지원하지 않습니다. 한도 도달 시 요청이 일시 중단됩니다. 유료 플랜의 추가 크레딧은 개당 0.04달러이며, 월 기본 크레딧의 잔여분은 다음 달로 이월되지 않습니다.

문제 발생 시 확인 순서

기동이나 자동완성이 원활하지 않으면 공식 문서의 kiro-cli doctor로 진단하고, 인터넷 연결과 지원 OS·셸을 확인합니다. 인증 오류는 kiro-cli login으로 재인증하며, 회사망에서는 HTTP_PROXY·HTTPS_PROXY·NO_PROXY 설정을 점검합니다. 계속 실패하면 로그를 확인한 뒤 재설치나 공식 이슈 보고를 검토합니다.

업데이트 후 기존 설정이 작동하지 않는다면 V3 이전 안내를 확인해야 합니다. V3는 권한과 Hooks 형식이 바뀌었고, V3 세션을 V2에서 재개할 수 없습니다. 구버전 명령 예제를 그대로 적용하지 않도록 주의합니다.

다른 도구와 선택 기준

Kiro IDE와 비교할 때, 기존 편집기와 터미널을 유지하면서 명령 중심으로 작업하려면 CLI가 적합합니다. 다른 AI 코딩 도구와 비교할 때는 같은 저장소의 작은 과제로 코드 이해도, 수정 범위, 권한 통제, 테스트 결과, 크레딧 소모를 살펴보는 것이 현실적입니다.

단순히 정해진 명령을 반복하는 작업은 기존 셸 스크립트도 선택지입니다. 자연어로 원인을 조사하거나 여러 파일의 문맥을 연결해야 하는 작업이 얼마나 자주 발생하는지에 따라 도입 여부를 판단할 수 있습니다.

공식 안내

• CLI - Kiro · 확인 2026-10-07
• CLI - Docs - Kiro · 확인 2026-10-07
• Installation - Get Started - Docs - Kiro · 확인 2026-10-07
• Downloads - Kiro · 확인 2026-10-07
• Setup & First Run - CLI - Docs - Kiro · 확인 2026-10-07
• Pricing - Kiro · 확인 2026-10-07
• Related questions - Billing - Docs - Kiro · 확인 2026-10-07
• What's new in CLI V3 · 확인 2026-10-07