AWS CLI 는 명령줄에서 AWS 서비스를 다루는 도구다. 현행은 v2 이며 최신 버전은 2.36.49 다[1]. v1 과 같은 aws 명령 이름을 쓰므로 v1 이 깔려 있으면 먼저 지운다. Amazon Linux 는 yum 으로 깔린 v1 을 지운 뒤 설치한다.
sudo yum remove awscli
| 플랫폼 | 조건 |
|---|---|
| Linux | 64비트. unzip · glibc · groff · less |
| macOS | 11 이상 |
| Windows | 64비트. 전체 사용자 설치는 관리자 권한 |
설치 스크립트가 권장 방법이다. 기본은 현재 사용자($HOME/.local/share/aws-cli)에 설치한다.
curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash
전체 사용자(/usr/local/aws-cli)에 설치하려면 --system 을 준다.
curl -fsSL https://awscli.amazonaws.com/v2/install.sh | sudo bash -s -- --system
버전을 고정하고 싶으면 zip 설치기를 쓴다. /usr/local/aws-cli 에 설치되고 /usr/local/bin/aws 링크가 생긴다. ARM 은 awscli-exe-linux-aarch64.zip 이다.
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
snap 으로도 설치할 수 있다. 자동 갱신되므로 버전 고정이 필요하면 쓰지 않는다.
sudo snap install aws-cli --classic
curl -fsSL https://awscli.amazonaws.com/v2/install.sh | bash
pkg 설치기로 전체 사용자에 설치하려면 다음과 같이 한다.
curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
sudo installer -pkg AWSCLIV2.pkg -target /
PowerShell 에서 설치 스크립트를 실행한다. 기본은 현재 사용자(%LOCALAPPDATA%\Programs\Amazon\AWSCLIV2)에 설치한다.
irm https://awscli.amazonaws.com/v2/install.ps1 | iex
MSI 설치기는 https://awscli.amazonaws.com/AWSCLIV2.msi (전체 사용자) 또는 https://awscli.amazonaws.com/AWSCLIV2-User.msi (현재 사용자)를 받아 실행한다. 명령줄에서는 다음과 같다.
msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
설치 스크립트나 공식 설치기로 설치했다면 CLI 자체 명령으로 갱신한다. 전체 사용자 설치는 sudo 또는 관리자 PowerShell 에서 실행한다.
aws update
zip 설치기로 다시 설치할 때는 --update 를 준다.
sudo ./aws/install --update
aws --version
aws-cli/2.36.49 Python/3.13.7 Linux/6.8.0-79-generic exe/x86_64.ubuntu.24
aws 를 찾지 못하면 터미널을 다시 열거나 $PATH 에 설치 경로가 있는지 본다. 설치 후에는 Cli 설정으로 넘어간다.
MinIO · Ceph RGW · Ozone S3 Gateway 처럼 S3 API 를 따르는 스토리지에도 같은 CLI 를 쓴다. --endpoint 로 주소를 지정한다.
aws s3 ls --endpoint http://ozone-s3g.example.net:9878
aws s3 ls s3://mybucket/ --endpoint http://ozone-s3g.example.net:9878
자격 증명은 셸 히스토리나 스크립트에 평문으로 두지 않는다. aws configure 프롬프트 · IAM 역할 · SSO 로 관리한다.
AWS CLI v2 최신 버전 2.36.49 — 2026-09-20 확인. https://raw.githubusercontent.com/aws/aws-cli/v2/awscli/init.py · https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html ↩︎