구글 제미니 CLI 설치 및 활용법
구글 제미니(Gemini) CLI는 개발자가 터미널 환경에서 제미니 모델과 직접 소통하며 다양한 작업을 수행하도록 돕는 강력한 도구입니다. 이 CLI는 특히 Node.js 20 이상 환경에서 구동되므로, 사용 전 Node.js 버전을 확인해야 합니다.
설치 및 사용 방식
제미니 CLI는 두 가지 주요 방식으로 설치하고 활용할 수 있습니다.
1. NPX를 이용한 즉시 실행
이 방식은 CLI를 별도로 설치하지 않고 필요한 시점에만 실행하는 데 적합합니다. 패키지를 전역에 설치하지 않아 시스템 자원을 절약할 수 있습니다.
- 설치 방법: 별도 설치 과정 없이 아래 명령어를 실행하면, GitHub 저장소에서 패키지를 내려받아 바로 실행됩니다.
npx https://github.com/google-gemini/gemini-cli- 사용법: CLI를 사용할 때마다 위에 명시된
npx명령어를 입력합니다. 실행 후gemini >프롬프트가 나타나면, 바로 제미니와 대화형으로 소통할 수 있습니다.
2. 글로벌 설치 (-g 옵션 활용)
이 방법은 CLI를 시스템에 전역으로 설치하여 어느 디렉토리에서든 gemini 명령을 바로 사용할 수 있게 합니다.
- 설치 방법: 다음 명령어를 사용하여
@google/gemini-cli패키지를 전역node_modules폴더에 설치합니다.
npm install -g @google/gemini-cli- 사용법: 설치가 완료되면, 터미널 어디에서든
gemini라고 입력하여 CLI를 시작할 수 있습니다. 입력 후gemini >프롬프트가 나타나면 바로 상호작용이 가능합니다.
인증 및 토큰 설정
제미니 CLI를 사용하기 위해선 인증 과정이 필수적입니다. 아래 세 가지 인증 방식을 통해 제미니 API에 접근할 수 있습니다.
1. 구글 계정 로그인
가장 간편한 방법으로, CLI 실행 후 나타나는 안내에 따라 개인 구글 계정에 로그인하는 것입니다. 이 경우 분당 최대 60회, 하루 최대 1,000회의 모델 요청 한도가 제공됩니다.
2. API 키 (토큰) 설정
더 높은 요청 한도와 세밀한 제어가 필요하다면, API 키를 활용하는 것이 좋습니다.
- Gemini API 키: 구글 AI 스튜디오에서 생성할 수 있습니다.
- Vertex AI API 키: 구글 클라우드에서 생성합니다.
이러한 키는 환경 변수로 설정하여 구성할 수 있습니다. 아래 예시를 참고하여 사용 중인 운영체제에 맞게 설정하세요.
- Gemini API 키 설정 (리눅스/macOS):
export GEMINI_API_KEY="YOUR_GEMINI_API_KEY_HERE"- Gemini API 키 설정 (윈도우):
set GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE윈도우의 경우는 환경변수에 등록해서 사용하면 편리하다.
제미니와 버텍스 AI의 차이
환경 변수 설정 시 혼동을 줄이기 위해 제미니와 버텍스 AI의 개념을 명확히 이해하는 것이 중요합니다.
– 제미니(Gemini): 구글이 개발한 멀티모달 AI 모델 제품군의 이름입니다. 텍스트, 이미지, 코드 등 다양한 데이터를 이해하고 생성하는 AI의 “두뇌” 역할을 합니다. 일반 사용자용 AI 챗봇부터 개발자용 API까지 다양한 형태로 활용됩니다.
– 버텍스 AI(Vertex AI): 구글 클라우드에서 제공하는 통합 MLOps 플랫폼입니다. 개발자가 AI 모델을 구축, 훈련, 배포, 관리하는 데 필요한 모든 도구를 제공합니다. 주로 기업이나 전문 개발자가 복잡한 AI 솔루션을 구축하는 데 사용됩니다.
CLI 프롬프트 활용 예시
제미니 CLI는 다양한 프로젝트 작업에 활용될 수 있습니다.
1. 새로운 프로젝트 시작
빈 디렉토리에서 gemini > 프롬프트에 원하는 내용을 입력하여 프로젝트 초기 단계부터 도움을 받을 수 있습니다.
- 예시:
gemini > Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide2. 기존 프로젝트 작업
기존 코드베이스가 있는 디렉토리에서 CLI를 실행하면 프로젝트의 컨텍스트를 이해하고 상호작용합니다.
- 예시:
gemini > Give me a summary of all of the changes that went in yesterdayCLI는 대규모 코드베이스를 분석, 새 애플리케이션 생성, 운영 작업 자동화 등 다양한 용도로 활용될 수 있습니다. 이미지 인식이나 파일 입출력 같은 기능은 특히 흥미로운 가능성을 제시하며, 앞으로 더 많은 활용 방안이 탐색될 것입니다.