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 포함)
Last updated