설치 및 사용 방법 (두 가지 방식)
Gemini CLI를 사용하려면 Node.js 20 이상 버전이 필요합니다.
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 API 키: Google AI Studio에서 생성합니다.
- Vertex AI API 키: Google Cloud에서 생성합니다.
이러한 키를 환경 변수로 설정하여 토큰을 구성할 수 있습니다. 터미널에 다음을 입력하세요:
- 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
윈도우의 경우는 환경변수에 등록해서 사용하면 편리하다.




프롬프트 활용 방법
Gemini CLI를 사용하면 다양한 작업을 위해 셸에서 Gemini와 상호 작용할 수 있습니다:
- 새 프로젝트 시작:
- 비어 있는 새 디렉터리로 이동합니다.
- gemini > 뒤에 프롬프트를 입력합니다.
예시
gemini > Write me a Gemini Discord bot that answers questions using a FAQ.md file I will provide
- 기존 프로젝트 작업:
- 기존 저장소를 복제하거나 해당 저장소로 이동합니다.
- 프로젝트 컨텍스트 내에서 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 |
