Gemini CLI 설치 및 사용법: 터미널에서 구글 AI 바로 활용하기

구글이 무료화한 Gemini 추론 모델을 터미널에서 자유롭게 사용할 수 있도록 해주는 CLI 도구 Gemini CLI를 Windows 환경에 설치하고, 매일 최대 1,000건까지 무료로 AI 기능을 활용하는 방법과 주요 활용 사례에 대해 알아봅니다.

1. 사전 준비

1. Node.js 20 이상 설치 확인

node -v

2. Windows Terminal 또는 PowerShell 실행 권한 확보

3. 구글 계정 또는 API 키 준비

▶ Node.js 설치 이전 게시물 참고: Node.js 소개 및 윈도우에 설치하는 방법

2. Gemini CLI 설치

1. Windows Terminal 또는 PowerShell을 관리자 권한으로 실행

2. 다음 명령어로 전역 설치

npm install -g @google/gemini-cli

4. 설치 확인

gemini --version

3. 초기 설정 및 인증

설치 직후 gemini만 입력하면 첫 실행 설정이 시작됩니다.

Enter를 눌러 테마를 선택한 뒤, 인증 방식 화면에서:

• Login with Google: 브라우저가 열리면 Google 계정으로 로그인 후 권한 허용
• Gemini API Key: AI Studio에서 발급받은 API 키를 붙여넣기

4. 기본 사용법

• 대화형 모드
  gemini 실행 후 프롬프트에 질문 입력
• 비대화형 모드
  gemini -p "Hello, Gemini!"

5. 주요 기능 및 활용 사례

• 코드 어시스트 & 파일 생성: HTML·JavaScript 파일 생성, 코드 리팩토링, 테스트 코드 자동 생성
• 물리 시뮬레이션: Fractal 스타일 캔버스 그리기, 물리 엔진 코드 작성
• 웹 데이터 처리: web_fetch 도구로 페이지 내용 수집, 이미지 포맷 변환
• 데이터베이스 연동: Supabase MCP 서버 연결 후 DB 입출력·API 함수 생성
• 자동화 스크립트: 배치(.bat) 또는 PowerShell 스크립트에 gemini 호출 통합

6. MCP 서버 연동

Model Context Protocol(MCP) 서버를 통해 AI의 작업 범위를 확장할 수 있습니다. 프로젝트 폴더에 .gemini/settings.json 파일을 생성하고, 예시처럼 작성하면 됩니다.

{
  "context": { /* 초기화할 컨텍스트 설정 */ },
  "tools": ["web_fetch", "fs"]
}

7. 주의사항 및 팁

• 무료 사용은 하루 1,000건 제한(사실상 평생 무료 수준)
• 기본값으로 모든 대화가 학습 데이터로 수집됩니다. 민감한 프로젝트엔 API 키 모드를 권장
• telemetry, sandbox 등 불필요한 도구는 settings.json에서 비활성화 가능

결론

이제 Windows 터미널에서 gemini 한 줄로 구글 AI의 강력한 기능을 손쉽게 사용해 보세요. 코드 어시스트, 문서 요약, 데이터 처리 등 다양한 시나리오에 AI를 통합해 업무 효율을 극대화할 수 있습니다!

함께 보면 좋은 게시글

• 코드펜(CodePen) 사용법 및 티스토리에 적용하는 방법
• ChatGPT 무료 서비스 및 유료 구독 서비스에 가입하는 방법
• ChatGPT Desktop 버전의 장점과 다운로드 및 사용 방법
• 인공 지능 SUNO AI 음악 생성하기: Copilot 및 ChatGPT 활용
• 유튜브 자막 추출하기: 스크립트 사용과 외부 사이트 이용

이 글이 도움이 되셨다면 공유 부탁 드립니다.