2. VSCode Server에 Q CLI 구성하기
update : 2025.05.07
Amazon Q CLI 설치 가이드
Amazon Q Developer CLI는 Builder ID 또는 IAM Identity Center 계정으로 로그인하여 AI 기반 개발 도구를 사용할 수 있는 CLI 도구입니다. 이 가이드는 Linux 환경 (Amazon Linux 2023)에서 Q CLI를 설치하고 인증하는 방법을 단계별로 안내합니다.
1. glibc 버전 확인
ldd --version버전
설치 대상
glibc 2.34 이상
표준(Standard) 버전 사용 가능
glibc 2.34 미만
musl 버전 사용 필요 (별도 문서 참고)
💡 Amazon Linux 2023 + 최신 AWS CLI 설치 환경은 기본적으로 glibc 2.34 이상입니다.
2. Q CLI 다운로드 (glibc 2.34 이상 기준)
curl --proto '=https' --tlsv1.2 -sSf \
"https://desktop-release.q.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip" \
-o "q.zip"3. 압축 해제 및 설치
unzip q.zip
./q/install.sh설치가 완료되면 Q CLI는 /usr/local/bin/q 경로에 등록됩니다.
최초 설치 시 로그인 방식 선택 및 인증 절차가 진행됩니다.
4. 로그인 방식 선택 및 인증
Builder ID 로그인 (무료 사용)
✔ Do you want q to modify your shell config? → Yes
✔ Select login method → Use for Free with Builder ID
Confirm the following code in the browser:
Code: xxxx-xxxx
Open this URL: https://view.awsapps.com/start/#/device?user_code=xxxx-xxxxIAM Identity Center (Pro 라이선스)
✔ Do you want q to modify your shell config? → Yes
✔ Select login method → Use with Pro license
✔ Enter Start URL → https://amzn.awsapps.com/start
✔ Enter Region → us-east-1
Confirm the following code in the browser:
Code: xxxx-xxxx
Open this URL: https://amzn.awsapps.com/start/#/device?user_code=xxxx-xxxx인증 요청 예시 화면
인증 완료 후 예시 화면
5. 로그인 재인증 또는 수동 로그인
q login --region us-east-1Builder ID 또는 SSO 로그인 방식 선택 가능
6. 설치 확인
q --version정상적으로 설치되면 Q CLI의 버전 정보가 출력됩니다.
7. Q CLI 실행
q chat실행 후 다음과 같이 AI 기반 대화형 개발 환경이 시작됩니다:
To learn more about MCP safety, see https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-mcp-security.html
Welcome to
█████╗ ███╗ ███╗ █████╗ ███████╗ ██████╗ ███╗ ██╗ ██████╗
██╔══██╗████╗ ████║██╔══██╗╚══███╔╝██╔═══██╗████╗ ██║ ██╔═══██╗
███████║██╔████╔██║███████║ ███╔╝ ██║ ██║██╔██╗ ██║ ██║ ██║
██╔══██║██║╚██╔╝██║██╔══██║ ███╔╝ ██║ ██║██║╚██╗██║ ██║▄▄ ██║
██║ ██║██║ ╚═╝ ██║██║ ██║███████╗╚██████╔╝██║ ╚████║ ╚██████╔╝
╚═╝ ╚═╝╚═╝ ╚═╝╚═╝ ╚═╝╚══════╝ ╚═════╝ ╚═╝ ╚═══╝ ╚══▀▀═╝
╭───────────────────────── Did you know? ─────────────────────────╮
│ │
│ You can use /editor to edit your prompt with a │
│ vim-like experience │
│ │
╰─────────────────────────────────────────────────────────────────╯
/help all commands • ctrl + j new lines • ctrl + k fuzzy search
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━💡 참고 사항
Q CLI는 ~/.q 디렉토리에 사용자 설정을 저장합니다.
Builder ID 계정은 https://builder.aws 에서 무료 생성 가능합니다.
프로파일, 컨텍스트, 도구(MCP) 연동은 이후 문서에서 다룹니다.
🎉 이제 Amazon Q CLI가 설치되었습니다!
Last updated