Gemini cli
기술노트
🌟 Gemini CLI란?
Gemini CLI는 구글의 차세대 AI 모델인 Gemini(제미니)를 터미널에서 간편하게 사용할 수 있는 명령줄 도구입니다. 개발자는 별도의 웹 인터페이스 없이 CLI 환경에서 코드 생성, 분석, 명령 실행 등을 빠르게 수행할 수 있습니다.
🔑 Gemini CLI의 특징
- 즉시 실행 가능 – Node.js 환경만 있으면 설치 후 바로 사용 가능
- Google 계정 인증 또는 API Key 기반 사용 – 로그인만으로 무료 요청 가능
- 코드 생성·분석 및 셸 명령 지원 – 자연어로 명령을 입력해 다양한 작업 수행
- 내장 툴/확장 기능 지원 –
/tools명령으로 파일, 셸, 검색 등의 기능 호출 가능 - 무료 플랜 지원 – Gemini 2.5 Pro 모델 기반, 최대 1M 토큰 컨텍스트, 분당 60 요청, 하루 1,000 요청 무료
---
🛠 설치 가이드
1. Node.js 설치 확인
node -v
- Node.js 18 이상이 필요합니다.
- Node.js 공식 사이트에서 최신 버전을 다운로드 및 설치하세요.
2. Gemini CLI 설치
- 전역 설치 (추천)
npm install -g @google/gemini-cli
- npx 실행 (비설치)
npx @google/gemini-cli
---
🔐 인증 및 실행
1. CLI 실행
gemini
- 최초 실행 시 브라우저가 열리고 Google 계정 인증을 진행합니다.
2. API Key로 인증 (선택)
Google AI Studio에서 발급받은 API Key를 사용하려면 환경변수 설정 후 실행하세요.
- Linux/Mac
export GEMINI_API_KEY="내_API_KEY"
gemini
- Windows PowerShell
$env:GEMINI_API_KEY="내_API_KEY"
gemini
---
💻 기본 사용 예시
gemini "Write a Python function that reads a CSV file"
- 자연어로 코드 생성, 분석, 버그 수정 요청 가능
!명령으로 셸 명령 실행 (예:!ls -al)/tools명령으로 내장 기능 확인
---
📋 주요 명령 및 기능
| 명령 | 설명 | 예시 |
|---|---|---|
| 자연어 입력 | 코드 생성/분석 | gemini "Explain binary search in Python"
|
| !명령 | 셸 명령 실행 | !pwd
|
| /tools | 내장 도구 확인 | /tools
|
| /mcp | MCP 확장 관리 | /mcp
|
---
✅ 장점
- 빠른 실행과 간편한 설정
- 코드 작성·분석, CLI 환경에서 AI 활용
- 무료 플랜 지원으로 부담 없이 사용 가능
⚠️ 주의사항
- Node.js 18 이상이 반드시 필요
- 초기 실행 시 Google 계정 인증 또는 API Key 필요
- 요청량 제한(무료 플랜)을 초과할 경우 에러가 발생할 수 있음
```
