Gemini CLI 설치

Gemini CLI 설치 및 Cursor 연동 

커서(Cursor) IDE 내에서 Gemini CLI(Command Line Interface)를 설치하고 사용하는 방법을 단계별로 정리했습니다

Windows 환경에서 가장 일반적인 설치 방법은 Node.js를 이용한 npm 설치입니다.

1단계: Node.js 및 npm 설치 확인

Gemini CLI는 Node.js 패키지 매니저인 npm을 통해 설치됩니다. 이미 설치되어 있을 수 있지만, 터미널에서 버전을 확인하여 준비합니다.

1. Windows 명령 프롬프트 (cmd) 또는 PowerShell을 실행합니다.
2. 다음 명령어를 입력하여 설치 여부를 확인합니다.

   node -v
   npm -v

3. 만약 설치되어 있지 않다면, Node.js 공식 웹사이트에서 Windows용 설치 파일(LTS 버전 권장)을 다운로드하여 설치해야 합니다. Node.js 설치 시 npm도 자동으로 설치됩니다.

2단계: Google AI SDK 및 Gemini CLI 설치

npm을 사용하여 @google/genai 패키지를 전역(-g)으로 설치합니다. 이 패키지 안에 Gemini CLI 도구가 포함되어 있습니다.

1. Cursor IDE 내의 터미널을 엽니다 (Ctrl + ` 또는 View > Terminal).
2. 다음 명령어를 입력하여 Gemini CLI를 설치합니다.

   npm install -g @google/genai

   (관리자 권한이 필요할 수 있습니다. 권한 문제 발생 시, PowerShell을 **"관리자 권한으로 실행"**하여 위 명령을 재실행합니다.)

3단계: API 키 설정

Gemini CLI를 사용하려면 Google AI Studio에서 발급받은 API 키를 환경 변수에 설정해야 합니다.

1. API 키 발급: Google AI Studio에서 API 키를 발급받습니다. (예: AIzaSy...your_key_here)
2. Windows 환경 변수 설정:
   • Cursor IDE 터미널에서 다음 명령어를 실행하여 현재 세션의 환경 변수로 키를 설정합니다. (키는 실제 발급받은 키로 대체해야 합니다.)

     $env:GEMINI_API_KEY="YOUR_API_KEY_HERE"

   • 영구적으로 설정하려면, Windows 검색창에 "환경 변수 편집"을 검색하여 시스템 환경 변수를 편집합니다.
     • '시스템 환경 변수 편집' → '환경 변수' 버튼 클릭
     • '시스템 변수' 또는 '사용자 변수' 영역에서 '새로 만들기' 클릭
     • 변수 이름: GEMINI_API_KEY
     • 변수 값: YOUR_API_KEY_HERE (발급받은 실제 키)

4단계: Gemini CLI 명령어 사용

이제 Cursor 터미널에서 gemini 명령어를 사용하여 모델을 호출하고 코드를 생성하거나 질문할 수 있습니다.

명령어	설명	예시
gemini chat	실시간 대화를 시작합니다.	gemini chat
gemini generate	명령어 또는 텍스트 프롬프트를 실행하여 응답을 생성합니다.	gemini generate "Windows에서 파일 경로를 다루는 Python 함수를 작성해줘"
gemini models	사용 가능한 모델 목록을 확인합니다.	gemini models

팁: Cursor는 자체적으로 Ctrl + L (Generate Code)와 같은 AI 기능을 제공하지만, gemini generate 명령을 통해 특정 모델 파라미터나 긴 프롬프트를 활용하는 등 보다 정교한 CLI 기반 작업을 수행할 수 있습니다.