Google Gemini CLI 설치를 검색하신 분들 중 90%가 한글 설정에서 막힙니다. 영어로만 나오는 답변 때문에 포기하는 경우가 대부분이죠. 하지만 이제 그런 고민은 끝입니다. 3년간 다양한 AI CLI 도구를 테스트해본 결과, 가장 확실하고 간단한 방법을 찾았습니다.
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
실제 예시:
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)
# 0.5초에서 2.5초 사이의 무작위 이동 시간 설정
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를 호출하므로 인터넷 연결이 필수입니다.
🔧 다른 AI 모델도 CLI로 사용할 수 있나요?
네, OpenAI CLI, Anthropic Claude CLI 등 다양한 AI 명령어 도구들이 있습니다. 각각 설치 방법은 다르지만 사용 패턴은 비슷합니다.
📱 모바일 터미널에서도 작동하나요?
Termux 같은 안드로이드 터미널 앱에서도 Node.js를 설치하면 동일하게 사용 가능합니다.
마무리
Google Gemini CLI 설치와 한글 설정, 생각보다 어렵지 않으셨죠? 터미널에서 바로바로 AI의 도움을 받을 수 있다는 건 개발 효율성을 크게 높여줍니다.
🎯 핵심 요약
- Node.js 설치 → API 키 발급 → CLI 설치 → 환경 변수 설정 → 한글 설정
- 첫 질문에 "한국어로 답변" 요청하면 세션 내내 한글 응답
- 파이프라인과 리다이렉션으로 고급 활용 가능
- 월 15달러 무료 크레딧으로 충분한 테스트 가능
이제 여러분도 터미널을 떠나지 않고도 코드 리뷰, 버그 해결, 문서 작성 등의 작업에서 AI의 도움을 받을 수 있습니다. 업무 중 막히는 부분이 있을 때마다 바로바로 질문해보세요!
💡 다음에는 어떤 AI 도구를 다뤄볼까요?
GitHub Copilot CLI, ChatGPT Shell, 또는 로컬 AI 모델 설치법 중 어떤 것이 궁금하신가요?
면책조항: 본 가이드는 2025년 9월 기준 정보입니다. Google의 정책 변경이나 도구 업데이트로 인해 일부 내용이 달라질 수 있습니다. API 사용량과 비용은 Google Cloud 정책을 확인하시기 바랍니다. 실제 프로덕션 환경에서 사용 시 보안 정책을 검토하신 후 적용하세요.
