이 가이드는 Windows 11 Gemini CLI 설치 및 API 키 등록 후 사용하는 방법에 대해 설명합니다.
Gemini CLI는 Google Gemini AI를 Windows 터미널에서 바로 사용할 수 있도록 해주는 도구입니다.
Gemini에게 질문할 때마다 브라우저에 연결할 필요 없이 PowerShell에서 Gemini에서 실행하여 파일 작업이나 코드 작성 및 설명, 오류 해결 등 명령줄 작업을 수행할 수 있습니다.
Windows 11에서 Gemini CLI 설치 및 사용하는 방법
Windows 11에서 Gemini CLI 도구를 설치하는 과정은 비교적 간단하지만, 설치 전 다음과 같이 몇 가지 사항을 확인해야 합니다.
- Windows 11 24H2 버전 이상
- Node.js 20 이상
- 인터넷 연결
- 로그인에 필요한 Google 계정 (API 키)
Gemini CLI 설치를 위해서는 Node.js가 필요하며, API 키를 사용할 경우 사전에 Google AI Studio에서 API 키를 발급해야 합니다.
01 Windows 버전 확인
Windows 11에서 Gemini CLI를 설치하기 위해서는 Windows 11 24H2 버전 이상이 설치되어야 합니다.
키보드 단축키 Win + R 키를 눌러 실행 대화 상자를 열고 winver 입력 후 Enter 키를 눌러 Windows 정보 창에서 현재 설치된 버전을 확인합니다.
Windows 업데이트에서 최신 기능 업데이트가 제공되는 경우 계속 진행하기 전에 업데이트를 설치합니다.
02 Gemini CLI 설치 전 Node.js 설치
Gemini CLI 도구는 npm 패키지로 배포되므로 먼저 Node.js 설치가 반드시 필요합니다.
Node.js 공식 웹 사이트에 접속하여 최신 버전의 LTS를 다운로드합니다.
최신 LTS 버전을 설치하고 하단에서 [Windows Installer (.msi)] 버튼을 클릭합니다.
다운로드한 설치 파일을 두 번 클릭하고 화면 안내에 따라 설치를 진행합니다.
설치 과정에서 특별한 이유가 없는 한 기본 옵션을 그대로 사용하는 것이 좋습니다.
설치가 완료되면 [Finish] 버튼을 클릭하여 설치 마법사 창을 닫습니다.
키보드 단축키 Win + R 키를 눌러 실행 대화 상자를 열고 wt 입력 후 Ctrl + Shift + Enter 키를 눌러 관리자 권한으로 터미널을 실행합니다.
관리자 권한으로 실행한 터미널에서 다음과 같이 Node.js 설치가 정상적으로 완료되었는지 확인합니다.
다음 명령을 입력하고 Enter 키를 눌러 터미널에서 실행 규칙을 임시로 적용 받지 않도록 설정합니다.
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass다음 명령을 입력하고 Enter 키를 눌러 Node.js 및 npm 버전을 확인합니다.
node --version
npm --version두 명령 모두 버전이 표시된다면 Node.js 설치는 정상적으로 완료된 것입니다.
(선택 사항) 필요한 경우 다음 명령을 입력하고 Enter 키를 눌러 npm을 최신 버전으로 업데이트합니다.
npm install -g npm@latest03 Gemini CLI 설치
Windows 11에서 Gemini CLI 도구를 설치하려면 다음 단계를 수행합니다.
키보드 단축키 Win + R 키를 눌러 실행 대화 상자를 열고 wt 입력 후 Ctrl + Shift + Enter 키를 눌러 관리자 권한으로 터미널을 실행합니다.
다음 명령을 입력하고 Enter 키를 눌러 Gemini CLI를 설치합니다.
npm install -g @google/gemini-cli- ‘-g’ 옵션을 사용하면 Gemini CLI 실행 경로가 변수에 등록되므로, PowerShell에서 직접 설치 경로로 이동하지 않고도 실행할 수 있습니다.
Gemini CLI 설치가 완료될 때까지 잠시 기다린 후 설치가 정상적으로 완료되었는지 확인합니다.
다음 명령을 입력하고 Enter 키를 눌러 Gemini CLI 버전을 확인합니다.
gemini -vGemini CLI 버전 번호가 표시되면 성공적으로 설치가 완료된 것입니다.
04 Gemini CLI 실행 및 구성
Windows 11에서 Gemini CLI 도구 설치가 완료되면 실행 후 다음과 같이 구성을 완료합니다.
다음 명령을 입력하고 Enter 키를 눌러 Gemini CLI를 시작합니다.
geminiGemini CLI를 처음 실행하면 현재 폴더에 대한 신뢰 여부를 묻는 메시지가 나타납니다.
- Trust folder (사용자 이름): 현재 폴더의 로컬 설정과 실행 권한을 신뢰하고 허용합니다.
- Trust parent parent (Users): 상위 폴더인 Users 전체를 신뢰합니다.
- Don’t trust: 신뢰하지 않고 실행을 중단하거나 제한합니다.
현재 폴더 또는 상위 폴더에 대한 권한을 허용합니다.
Gemini CLI 인증 방법을 선택하라는 메시지가 나타납니다.
이 문서에서는 Gemini API 키를 사용하여 Gemini CLI를 인증하도록 설정합니다.
CLI를 통해 Google 계정으로 로그인하고 싶지 않다면 API 키 인증 방식을 선택하도록 합니다.
🔦 참고 : Gemini CLI는 GEMINI_API_KEY 환경 변수를 사용하여 API 키 인증을 지원합니다.
Google AI Studio에서 발급한 API 키를 복사하여 붙여 넣습니다.
⚠️ 주의 : API 키를 공개적으로 공유하거나 공개 GitHub 저장소 등에 추가하지 않도록 주의합니다. 키에 접근 권한이 있는 경우 누구나 관련 API 리소스를 사용할 수 있게 됩니다.
Gemini CLI를 설치하고 API 키를 이용해 인증을 완료하면 사용 준비가 완료됩니다.
마치며
Gemini API 키 발급 방법에 대해 설명한 글에서 언급한 것처럼 Gemini CLI는 무료로 사용할 수 있지만, 사용 가능한 범위는 인증 방식과 적용되는 제한 사항에 따라 다릅니다.
예를 들어 Gemini API를 사용하는 경우, Google에서는 특정 모델에 대한 접근 권한과 무료 입력 및 출력 토큰을 제공하는 무료 등급을 제공하게 되며, 이는 사용량 제한이 적용됩니다.
더 높은 사용량 제한이나 추가 기능이 필요한 경우 유료 등급으로 전환할 수 있습니다.
물론 개인 Google 계정으로 로그인하지 않고도 Gemini API 키 또는 Vertex AI를 사용하여 인증하는 것으로도 Gemini CLI 도구를 사용할 수 있습니다.
API 키 인증의 경우 Google AI Studio에서 키를 생성하고 이를 등록하면 되지만, Vertex AI는 Google Cloud 프로젝트와 추가 구성이 필요합니다.
