제미나이 CLI는 윈도우에서 Node.js를 먼저 깔고 PowerShell에서 npm install -g @google/gemini-cli를 실행하면 설치됩니다. 다만 2026년 11월 5일 공식 문서 기준으로, 개인 무료 이용과 Google AI Pro·Ultra 이용은 안티그래비티 CLI로 옮겨졌습니다.
CLI는 터미널, 곧 명령을 글자로 입력하는 창에서 쓰는 AI 도구입니다. 제미나이 CLI 문서와 README, 마이크로소프트·Node.js 공식 페이지를 읽고 윈도우 기준 순서로 정리했습니다. 영어 원문은 그대로 두고 우리말로 풀었습니다.
1. 제미나이 CLI, 윈도우에서 설치할 수 있나요?
네, 설치할 수 있습니다. 공식 설치 문서의 권장 사양에 Windows 11 24H2 이상이 올라 있고, 셸(명령을 받는 프로그램)로 PowerShell도 적혀 있습니다.
설치는 되지만 쓸 수 있는 사람이 정해져 있습니다. 무료 개인 이용과 Google AI Pro·Ultra 이용은 2026년 6월 18일 안티그래비티 CLI로 옮겨졌습니다.
README 맨 위 경고 상자는 제미나이 CLI의 대상을 Gemini Code Assist Standard·Enterprise 라이선스나 Code Assist for GitHub를 쓰는 조직으로 적었습니다. 이 사정은 제미나이 CLI 서비스 종료, 사실일까?에 정리했습니다.
2. 설치 전에 확인할 것
문서는 「Recommended system specifications」, 곧 권장 사양을 이렇게 적었습니다. 운영체제는 Windows 11 24H2+, 실행 환경은 Node.js 20.0.0+, 셸은 Bash, Zsh 또는 PowerShell입니다.
메모리는 짧은 작업이면 4GB+ RAM, 큰 프로젝트를 길게 다루면 16GB+ RAM을 권합니다. 운영체제·메모리·Node.js는 필수 조건이 아니라 권장 사양이고, 인터넷 연결은 문서가 「required」로 적었습니다.
3. PowerShell 열고 Node.js 확인하기
PowerShell은 윈도우에 들어 있는 명령 입력 창입니다. 마이크로소프트 문서는 시작 메뉴를 열고 Windows PowerShell을 입력한 뒤, 목록에서 Windows PowerShell을 골라 Open을 누르라고 안내합니다.
Node.js는 제미나이 CLI가 돌아가는 바탕 프로그램이고, npm은 그 위에서 도구를 내려받아 설치하는 명령입니다. Node.js 공식 다운로드 페이지에서 Windows를 고르면 Windows Installer (.msi)를 받을 수 있습니다.
설치가 끝나면 PowerShell을 새로 열고 node -v를 입력합니다. Node.js 페이지가 확인용으로 보여 주는 명령이고, 버전이 20.0.0 이상으로 나오면 권장 사양을 채운 것입니다. npm 버전은 npm -v로 봅니다.
4. 제미나이 CLI 설치 명령 한 줄
설치 문서가 npm 방식으로 안내하는 명령은 다음과 같습니다. PowerShell에 그대로 입력합니다.
npm install -g @google/gemini-cli
설치 명령은 한 줄이고, 설치가 끝나면 gemini를 입력해 실행합니다. 문서는 대부분의 사용자에게 gemini 명령으로 실행하기를 권하고, 설치 없이 한 번만 써 보는 방법으로 npx @google/gemini-cli도 적었습니다.
태그를 붙이지 않으면 안정판(stable)의 최신 버전이 설치됩니다. 미리보기는 @preview, 매일 나오는 버전은 @nightly를 붙이는데, 문서는 대부분의 사용자에게 안정판을 권합니다.
5. 처음 실행하면 로그인부터 합니다
인증 문서는 gemini를 실행한 뒤 인증 방식을 고르라고 안내합니다. 회사·학교·Google Workspace 계정이면 Sign in with Google을 고르고 Google Cloud 프로젝트를 설정해야 한다고 적었습니다.
API 키로 쓰려면 PowerShell에서 $env:GEMINI_API_KEY="YOUR_GEMINI_API_KEY"를 입력하고 gemini를 실행한 뒤 Use Gemini API key를 고릅니다.
키는 Google AI Studio에서 받습니다. 구글 공지는 2026년 6월 18일 뒤에도 유료 Gemini API 키로는 계속 쓸 수 있다고 적었습니다.
Treat API keys, especially for services like Gemini, as sensitive credentials.
위 문장은 같은 문서의 주의 글입니다. API 키는 중요한 인증 정보로 다루라는 뜻이니 채팅이나 공개 저장소에 붙여 넣지 않습니다.
인증 문서(2026년 9월 18일 갱신 표기)에는 개인 구글 계정 로그인을 권하는 문장이 남아 있습니다. README 경고 상자와 문서 배너의 6월 18일 안내와 어긋나므로, 개인 계정 로그인이 되는지는 확인이 필요합니다.
6. 개인으로 쓰려면 안티그래비티 CLI로
무료나 Google AI Pro·Ultra로 쓰려는 개인은 README가 안내하는 안티그래비티 CLI(agy)로 가야 합니다. 설치 방법은 AI 코딩 툴 설치 총정리에서 도구별로 짚었습니다.
제미나이 CLI의 요금은 제미나이 CLI 요금 글에 있습니다. 이 글에서는 금액을 다루지 않았습니다.
- 윈도우 11 24H2 이상과 Node.js 20.0.0 이상인지 확인합니다
- PowerShell에서
npm install -g @google/gemini-cli를 입력합니다 gemini를 실행하고 인증 방식을 고릅니다- 개인 무료·Google AI Pro·Ultra 이용이라면 안티그래비티 CLI로 옮깁니다
설치 뒤 쓰는 말은 제미나이 CLI 명령어, 자주 쓰는 것만에 정리했습니다. 도구 전체 지도는 AI 코딩 툴 설치 총정리에서 볼 수 있습니다.
참고자료 (모두 2026년 11월 5일 확인)
- Gemini CLI 문서 「Installation」 — geminicli.com/docs/get-started/installation
- Gemini CLI 문서 「Authentication」 — geminicli.com/docs/get-started/authentication
- Gemini CLI GitHub README — github.com/google-gemini/gemini-cli
- Microsoft Learn 「Starting Windows PowerShell」 — learn.microsoft.com
- Node.js 다운로드 페이지 — nodejs.org/en/download
#제미나이CLI설치 #제미나이CLI #윈도우PowerShell #Nodejs #AI코딩도구
