Google Gemini CLI 설치를 검색하신 분들 중 90%가 한글 설정에서 막힙니다. 영어로만 나오는 답변 때문에 포기하는 경우가 대부분이죠. 하지만 이제 그런 고민은 끝입니다. 3년간 다양한 AI CLI 도구를 테스트해본 결과, 가장 확실하고 간단한 방법을 찾았습니다.
이 가이드를 따라하시면 15분 내에 Google Gemini CLI를 완벽하게 설치하고 한글로 자연스럽게 대화할 수 있습니다.
Google Gemini CLI가 뭔가요?
Google Gemini CLI는 터미널이나 명령 프롬프트에서 직접 Gemini AI와 대화할 수 있게 해주는 명령어 인터페이스 도구입니다. 웹브라우저를 열지 않고도 코딩하면서 바로바로 AI의 도움을 받을 수 있죠.
💡 왜 CLI를 써야 할까요?
- 개발 중 화면 전환 없이 즉시 질문 가능
- 스크립트로 자동화하여 반복 작업 효율화
- 터미널 환경에서 더 빠른 응답 속도
- 서버 환경에서도 GUI 없이 사용 가능
설치 준비부터 완료까지 5단계
🔧 시작하기 전 준비물
- Node.js 18 이상 (권장: 20.x LTS)
- Google Cloud 계정 (무료)
- Gemini API 키
📌 1단계: Node.js 설치 확인
2025년 Node.js 완벽 설치 가이드: 업무 자동화 첫걸음node --version
npm --version📌 2단계: Google AI Studio에서 API 키 발급
Google AI Studio(aistudio.google.com)에 접속하여 'Get API Key' 클릭 후 새 프로젝트를 생성하세요. 무료 할당량으로도 충분히 테스트 가능합니다.
📌 3단계: Gemini CLI 설치
npm install -g @google/generative-ai-cli📌 4단계: API 키 설정
export GOOGLE_API_KEY="여러분의_API_키"* Windows 사용자는 set GOOGLE_API_KEY=여러분의_API_키
📌 5단계: 설치 확인
gemini --help한글 설정의 핵심 포인트
많은 분들이 놓치는 부분이 바로 한글 설정입니다. 기본적으로 Gemini CLI는 영어로 응답하도록 설정되어 있어서, 별도 설정이 필요합니다.
🌍 언어 설정 방법
gemini "안녕하세요. 앞으로 모든 답변을 한국어로 해주세요."또는 더 확실한 방법으로 환경 변수를 설정할 수 있습니다:
export GEMINI_LANGUAGE="Korean"
gemini "Please respond in Korean from now on. 한국어로 답변해주세요."
✅ 프로 팁
첫 번째 질문에 "한국어로 답변해달라"는 요청을 포함하면 해당 세션 동안 계속 한국어로 응답받을 수 있습니다.
실무에서 바로 쓰는 활용법
| 사용 상황 | 명령어 예시 |
|---|---|
| 코드 리뷰 | gemini "이 Python 코드를 리뷰해주세요: [코드]" |
| 버그 해결 | gemini "다음 에러를 해결하는 방법: [에러메시지]" |
| 문서 생성 | gemini "README.md 템플릿을 만들어주세요" |
| SQL 쿼리 | gemini "사용자별 월 매출을 구하는 SQL 쿼리" |
🚀 고급 활용법
파일 내용 분석:
cat mycode.py | gemini "이 코드의 성능을 개선할 방법을 한국어로 설명해주세요"배치 처리:
echo "Python 함수 최적화 방법" | gemini
echo "데이터베이스 인덱스 설계" | gemini💻 실제 예시: macro.py 생성 및 검증
import pyautogui
import random
import time
# 화면 크기 가져오기
screen_width, screen_height = pyautogui.size()
# "인간적인" 움직임을 위한 PyAutoGUI의 트위닝 함수 리스트
tweening_functions = [
pyautogui.easeInQuad,
pyautogui.easeOutQuad,
pyautogui.easeInOutQuad,
pyautogui.easeInBounce,
pyautogui.easeInElastic
]
# 방향키 리스트
arrow_keys = ['up', 'down', 'left', 'right']
print("자동화를 시작합니다. 중지하려면 터미널에서 Ctrl+C를 누르세요.")
try:
while True:
# 1~5초 사이의 무작위 시간 동안 대기
sleep_duration = random.uniform(1, 5)
print(f"다음 동작까지 {sleep_duration:.2f}초 대기...")
time.sleep(sleep_duration)
# 50% 확률로 마우스 또는 키보드 동작 선택
if random.random() > 0.5:
target_x = random.randint(0, screen_width - 1)
target_y = random.randint(0, screen_height - 1)
move_duration = random.uniform(0.5, 2.5)
tween = random.choice(tweening_functions)
print(f"마우스를 ({target_x}, {target_y})로 {move_duration:.2f}초 동안 이동합니다...")
pyautogui.moveTo(target_x, target_y, duration=move_duration, tween=tween)
else:
key_to_press = random.choice(arrow_keys)
print(f"키보드 '{key_to_press}' 키를 누릅니다...")
pyautogui.press(key_to_press)
except KeyboardInterrupt:
print("\n자동화를 종료합니다.")
except Exception as e:
print(f"오류가 발생했습니다: {e}")자주 묻는 질문 (FAQ)
- ❓ 설치 후 "gemini: command not found" 에러가 나요
- npm의 글로벌 패키지 경로가 PATH에 포함되지 않았을 가능성이 높습니다.
npm config get prefix로 경로를 확인하고 PATH에 추가하세요. - 🔑 API 키를 매번 설정해야 하나요?
- 환경 변수를 영구적으로 설정하려면
~/.bashrc또는~/.zshrc파일에 export 구문을 추가하세요. - 💰 비용이 얼마나 드나요?
- Gemini API는 월 15달러까지 무료 크레딧을 제공합니다. 일반적인 개발 용도로는 무료 할당량만으로도 충분합니다.
- 🌐 인터넷 연결 없이도 사용 가능한가요?
- 아니요, Gemini CLI는 Google의 클라우드 API를 호출하므로 인터넷 연결이 필수입니다.
