3. Q CLI 소개 및 구성

Update : 2025.06.03

---

1. Amazon Q Developer CLI Overview

Amazon Q Developer CLI는 터미널 환경에서 실행되는 생성형 AI 기반의 AI 개발 파트너입니다.

개발자가 직접 터미널에서 명령어 기반으로 코드 생성, 디버깅, AWS 연동, 파일 분석 등을 수행할 수 있도록 설계되었습니다.

“Q CLI는 단순한 도구가 아니라, 터미널 안의 스마트한 Pair Programmer입니다.”

---

2. 핵심 기능 (Key Features)

2.1 Agentic Capabilities

Amazon Q CLI는 단순한 명령어 처리기가 아닌 에이전트 기반 상호작용을 제공합니다:

• 사용자의 터미널 컨텍스트를 이해하고 적응

• 사용자 승인 후 명령어 자동 실행

• 반복 사용을 통해 사용자에 맞는 응답을 학습

2.2 File System Integration

Q CLI는 로컬 파일 시스템과의 긴밀한 연동을 통해 다음을 지원합니다:

• 코드 파일 읽기 및 이해

• 새로운 파일 생성 및 기존 코드 수정

• 디렉토리 탐색 및 프로젝트 구조 이해

2.3 AWS 서비스 통합

Q CLI는 AWS CLI를 넘어서는 지능형 AWS 연동 기능을 제공합니다:

• 현재 계정의 리소스 조회

• 로그 스트리밍 및 분석 (예: CloudWatch)

• AWS 구성 문제 디버깅

• 명령어 추천 및 모범 사례 안내

2.4 코드 생성 및 이해 지원

Amazon Q는 개발자의 코딩 생산성 향상을 위해 다음을 수행합니다:

• 요구사항 기반 코드 생성

• 복잡한 코드 설명 및 요약

• 리팩토링 및 최적화 제안

• 디버깅 지원 및 코드 개선 가이드

2.5 명령어 라인 향상

Q CLI는 터미널 명령어 사용 경험도 개선합니다:

• Git, NPM, Docker, AWS 등 주요 CLI 자동완성 지원

• 명령어 옵션 및 인자에 대한 실시간 설명

• 복잡한 명령어 구성 지원

3. MCP (Model Context Protocol) 통합 (Q CLI 1.9.1 이상)

Q CLI는 Model Context Protocol(MCP)을 통해 외부 도구와 연결됩니다:

기능	설명
MCP 서버 연결	Kubernetes, GitHub, Redshift 등 외부 도구 연동
서드파티 시스템 접근	컨텍스트 기반 의사결정 및 데이터 조회
도메인 특화 지식 적용	목적별 MCP 서버 연결로 지능 향상
설치 없이 확장 가능	외부 CLI 없이 기능 확장 가능

예시: EKS 클러스터에 연결하여 현재 Pod 상태를 자연어로 질의 가능

“kube-system 네임스페이스에서 어떤 파드들이 실행 중인가요?”

---

4. 활용 사례 (Use Cases)

상황	활용 예시
개발	빠른 코드 생성, 규칙 기반 템플릿 생성
AWS 운영	서비스 상태 조회, 로그 확인, CLI 명령어 추천
디버깅	에러 추적 및 개선 제안
학습	새로운 기술 개념 설명, 문법 이해
자동화	반복 작업 스크립트화
확장성	MCP 기반으로 외부 시스템과 통합

---

5. 요약

항목	설명
설치 명령어	./q/install.sh
실행 명령어	q chat
로그인 방식	Builder ID 또는 IAM Identity Center
고급 기능	MCP 기반 외부 도구 연동 (K8s, logs, code)
권장 환경	glibc 2.34+ (Amazon Linux 2023 포함)