Etc/AI

Gemini CLI

코드바람 2025. 7. 12. 14:44

설치 및 사용 방법 (두 가지 방식)

Gemini CLI를 사용하려면 Node.js 20 이상 버전이 필요합니다.

 

 

구글 Gemini CLI Github

 

 

1. npx를 사용한 직접 실행

이 방법은 CLI를 전역으로 설치하지 않고 필요할 때마다 실행하는 데 유용합니다.

  • 설치 방법: 별도의 설치 과정 없이 다음 명령어를 실행합니다.이 명령은 GitHub에서 패키지를 다운로드하여 즉시 실행합니다. 
    npx https://github.com/google-gemini/gemini-cli
    

     

  • 사용 방법: 매번 CLI를 사용할 때마다 위의 npx 명령어를 입력합니다.명령어 실행 후 gemini > 프롬프트가 나타나면 상호 작용할 수 있습니다.
    npx https://github.com/google-gemini/gemini-cli
    

 

2. -g (글로벌) 옵션을 사용한 설치

이 방법은 CLI를 시스템에 전역으로 설치하여 어떤 디렉토리에서든 gemini 명령어를 바로 사용할 수 있게 합니다.

  • 설치 방법: 다음 명령어를 사용하여 CLI를 전역으로 설치합니다.이 명령어는 @google/gemini-cli 패키지를 시스템의 전역 node_modules 폴더에 설치합니다.
    npm install -g @google/gemini-cli gemini
    
  • 사용 방법: 설치가 완료되면, 터미널의 어떤 디렉토리에서든 단순히 gemini라고 입력하여 CLI를 시작할 수 있습니다.명령어 실행 후 gemini > 프롬프트가 나타나면 상호 작용할 수 있습니다.
    gemini
    

 

 

사용법 및 인증 (토큰 설정 포함)

실행하면 상기 화면 처럼 나오는데 어떤 인증을 쓸지 선택하면 됩니다.

 

설치 후 Gemini CLI를 사용하려면 인증이 필요합니다. API 키를 사용하여 토큰을 설정하는 방법은 다음과 같습니다:

  • Google 계정 로그인: 가장 간단한 방법은 프롬프트가 나타날 때 개인 Google 계정으로 로그인하는 것입니다. 이렇게 하면 분당 최대 60개의 모델 요청하루 최대 1,000개의 모델 요청이 허용됩니다.

API 키 (토큰 설정): 더 높은 호출 한도와 더 많은 제어를 위해 API 키를 사용할 수 있습니다.

이러한 키를 환경 변수로 설정하여 토큰을 구성할 수 있습니다. 터미널에 다음을 입력하세요:

 

 

  • Gemini (모델):
    • 무엇인가: Gemini는 Google이 개발한 멀티모달 AI 모델 제품군의 이름입니다. 텍스트, 코드, 이미지, 오디오, 비디오 등 다양한 유형의 정보를 이해하고 생성할 수 있는 강력한 기반 모델입니다.
    • 목적: AI 기반 애플리케이션의 핵심 "두뇌" 역할을 하며, 다양한 제품과 서비스에 AI 기능을 제공하는 데 사용됩니다. 일반 사용자용 AI 어시스턴트(예: Gemini 챗봇)부터 개발자가 애플리케이션에 통합하는 데 사용되는 기반 모델까지 다양하게 활용됩니다.
    • 대상: 일반 사용자, 개발자, 연구자 등 광범위한 사용자를 대상으로 합니다.
  • Vertex AI (플랫폼):
    • 무엇인가: Vertex AI는 Google Cloud에서 제공하는 종합적인 MLOps(Machine Learning Operations) 플랫폼입니다. 머신러닝 모델의 개발, 배포, 관리 및 모니터링을 위한 통합된 환경과 도구를 제공합니다.
    • 목적: 데이터 과학자와 머신러닝 엔지니어가 AI 모델을 구축, 훈련, 튜닝, 배포 및 확장하는 데 필요한 모든 것을 제공합니다. 특히 엔터프라이즈 수준의 복잡한 AI 솔루션을 구축하는 데 적합합니다.
    • 대상: 데이터 과학자, 머신러닝 엔지니어, 개발자 등 기술적인 전문 지식을 가진 사용자를 대상으로 합니다.

 

Gemini API 키 설정 (예시):

export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"

#윈도우의 경우는

set GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE

 

Vertex AI API 키 설정 (예시):

export VERTEX_AI_API_KEY="YOUR_VERTEX_AI_API_KEY_HERE"

# 윈도우의 경우는 

set VERTEX_AI_API_KEY=YOUR_VERTEX_AI_API_KEY_HERE

 

윈도우의 경우는 환경변수에 등록해서 사용하면 편리하다.

 

 

환경 변수 선택
현재 사용자에 대한 설정을 하려면 USER에 추가하고 전역으로 모든 사용자에 대해서 설정하려면 시스템 변수에 새로 들기 버튼을 누르면 된다.

 

위에 설명한 이름으로 실제 발급받은 값을 넣어주면 된다.

 

 

프롬프트 활용 방법

Gemini CLI를 사용하면 다양한 작업을 위해 셸에서 Gemini와 상호 작용할 수 있습니다:

  • 새 프로젝트 시작:
    1. 비어 있는 새 디렉터리로 이동합니다.
    2. gemini > 뒤에 프롬프트를 입력합니다. 

예시

gemini > Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide
  • 기존 프로젝트 작업:
    1. 기존 저장소를 복제하거나 해당 저장소로 이동합니다.
    2. 프로젝트 컨텍스트 내에서 gemini >를 사용하여 상호 작용합니다.

       

      예시

      gemini > Give me a summary of all of the changes that went in yesterday
      

       

CLI는 대규모 코드베이스를 쿼리하고 편집하고, 새 애플리케이션을 생성하며, 운영 작업을 자동화하는 등 다양한 작업을 명령줄에서 직접 수행할 수 있도록 지원합니다.

 

이미지 인식 및 파일 입출력 기능을 몇 가지 테스트해보니, 예상보다 흥미로운 점들이 많았습니다. 앞으로 좀 더 사용해보고 다양한 활용 방안에 대해 깊이 고민해 볼 계획입니다.

'Etc > AI' 카테고리의 다른 글

Ollama - REST API  (3) 2025.08.03
RAG(Retrieval-Augmented Generation)  (1) 2025.07.26
MCP (Model Context Protocol) 이란?  (0) 2025.07.13