터미널 속 AI 비서, Gemini CLI 시작 가이드 – 개발자 손끝에서 바로 실행되는 오픈소스 AI 에이전트
개발 중 막히는 순간, 구글 검색 대신 터미널에서 바로 AI에게 물어볼 수 있다면 어떨까요?
Gemini CLI는 그런 상상을 현실로 만든 도구입니다. 구글의 Gemini 모델을 기반으로, 오픈소스로 제공되는 이 AI 에이전트는 여러분의 터미널 환경에서 직접 실행되며, 코딩 보조는 물론 파일 시스템 접근, 명령어 실행, 애플리케이션 생성까지 도와줍니다. 이 블로그에서는 Gemini CLI의 기본 설치부터 실제 예제 프로젝트까지, 어떻게 시작하고 어떤 기능들이 있는지 쉽게 설명드립니다.
Gemini CLI란?
Gemini 모델을 터미널로 끌어온 오픈소스 AI 도우미
Gemini CLI는 구글이 개발한 AI 모델인 Gemini를 로컬 터미널에서 사용할 수 있게 해주는 CLI 툴입니다.
주요 특징은 다음과 같습니다:
- 터미널 기반 AI 인터페이스: 터미널에서 직접 명령 입력, 코드 생성, 명령 실행 가능
- 파일 시스템 접근 및 명령어 실행: 실제 디렉토리 생성, 파일 작성 등 직접 작업
- MCP 서버 지원 및 다양한 도구 내장
- 오픈소스 + 무료 티어 제공 (분당 60요청, 일일 1000모델 요청 지원)
설치 방법
환경 세팅부터 최초 실행까지
- Node.js 설치 (v18 이상)
Node.js 설치 페이지에서 본인 운영체제에 맞는 설치파일 다운로드 및 설치 - Gemini CLI 설치
- npm install -g @google/gemini-cli
- 버전 확인
- gemini -v
- 실행 및 테마/인증 선택
- 테마 선택 후 구글 로그인 방식 인증 선택 (브라우저 열림)
- 기본 무료 티어 사용 가능
- gemini
기본 인터페이스 및 명령어
Gemini CLI를 실행하면 다음 기능을 사용할 수 있습니다:
- /help: 전체 명령어 및 키보드 단축키 목록 확인
- /tools: 사용 가능한 AI 도구 목록
- /session: 세션 정보 (토큰 사용량, 시간 등)
- Shell 모드 전환: ! 입력 → 시스템 쉘 명령 직접 실행
- /quit: 종료
실제 사용 예제
RSS 피드를 보여주는 Flask 웹앱 만들기
Gemini CLI에게 직접 웹 애플리케이션 생성 요청을 해봤습니다. 요청 내용은 다음과 같습니다:
“Python Flask 애플리케이션을 만들어주세요. 이 RSS 주소를 사용해서 실시간 크리켓 점수 목록을 보여주고 싶어요.”
https://static.cricinfo.com/rss/livescores.xml
결과
Gemini CLI가 수행한 작업:
- 디렉토리 생성
- Flask 프로젝트 구조 자동 생성
- 필요한 패키지 자동 설치 (feedparser, Flask 등)
- Python 코드와 HTML 템플릿 자동 작성
- 서버 실행 (포트 충돌 시 대체 포트 제안)
생성된 코드 예시
app.py
from flask import Flask, render_template
import feedparser
app = Flask(__name__)
@app.route('/')
def index():
feed = feedparser.parse("https://static.cricinfo.com/rss/livescores.xml")
return render_template('index.html', entries=feed.entries)
if __name__ == '__main__':
app.run(debug=True, port=8080)
templates/index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Live Cricket Scores</title>
</head>
<body>
<h1>Live Cricket Scores</h1>
<ul>
{% for entry in entries %}
<li><a href="{{ entry.link }}">{{ entry.title }}</a> - {{ entry.description }}</li>
{% endfor %}
</ul>
</body>
</html>
Gemini CLI는 단순한 코딩 도우미를 넘어, 개발 환경 내에서 직접 실행 가능한 AI 에이전트라는 점에서 혁신적입니다.
터미널 명령어, 파일 작업, 코드 생성 등 개발자가 자주 하는 반복적인 작업들을 간소화하며,
향후 더 많은 오픈소스 기여와 도구 확장이 기대됩니다.
다음 편에서는 Gemini CLI의 고급 설정과 다양한 개발 환경 맞춤형 활용법을 다룰 예정입니다.
이제 여러분의 터미널에서 AI와 함께 새로운 개발 경험을 시작해보세요.
https://medium.com/google-cloud/gemini-cli-tutorial-series-77da7d494718
Gemini CLI Tutorial Series
Welcome to the Gemini CLI Tutorial Series. It is an open-source AI agent that brings the power of Gemini directly into your terminal. You…
medium.com
