Gemini CLI 설치 가이드

Gemini CLI는 기존의 AI 사용 방식과 달리, 터미널 기반으로 작동하며 개발 작업에 특화된 에이전트형 도구입니다. 기존 방식은 사용자가 웹이나 IDE에서 직접 AI에게 질문을 입력하고 응답을 받는 구조였다면, Gemini CLI는 fix, run, explain처럼 명령어 중심으로 코드 작업을 자동화합니다. 가장 큰 차이점은 AI가 개발자의 명령을 기다리는 수동적 도구에서, 프로젝트 맥락을 이해하고 능동적으로 코드 분석과 수정을 제안하는 에이전트형 도구로 진화했다는 점입니다. 또한 세션마다 맥락이 초기화되는 기존 방식과 달리, Gemini CLI는 프로젝트 단위로 컨텍스트를 유지하면서 지속적인 코드 도움을 제공합니다.

Gemini CLI vs Cursor

Gemini CLI와 Cursor는 모두 AI를 활용해 개발을 도와주는 도구지만, 가장 큰 차이점은 사용 방식과 환경에 있습니다. Gemini CLI는 터미널에서 명령어로 작동하는 CLI 도구이며, Google의 Gemini 모델을 기반으로 합니다. 반면 Cursor는 VS Code를 기반으로 한 완전한 IDE 형태로, Claude, GPT-4 등의 모델을 사용하며 코드 편집기 안에서 AI와 직접 상호작용할 수 있습니다. 따라서 Gemini CLI는 터미널 환경에 익숙한 개발자에게, Cursor는 GUI 기반의 시각적인 개발 환경을 선호하는 사용자에게 적합한 도구입니다.

1. Node.js 설치

Node.js — Node.js® 다운로드

Node.js® is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.

nodejs.org

2. node, npm 설치 확인

Node.js는 Gemini CLI 도구가 동작하기 위한 실행 플랫폼(JavaScript 코드 실행 런타임)이고, npm은 Node.js 기반 도구를 설치하고 관리하는 패키지 관리자 입니다.

node -v
# 에러 메시지 발생할 경우 환경 변수 path값에 'C:\Program Files\nodejs\' 경로 추가

npm -v
# 에러 발생할 경우 
# "Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass"
# 명령을 통해 실행 권한 변경 "[Y] 예(Y) 클릭"

3. npm을 통해 Gemini CLI 설치

npm install -g @google/gemini-cli
# 시스템 전체에 쓸 수 있는 명령어 도구 설치

4. gemini 로그인

명령어 창에 'gemini' 입력 하면 바로 사용 가능하며, 테마를 선택 하고 Login with Google을 통해 내 계정으로 로그인 하면 끝.

5. Gemini CLI 사용

로컬 파일들을 전반적으로 접근할 수 있는게 가장 큰 장점 (cursur도 가능하지만 개발 생산성에 집중 차이) 입니다. 그 외 다양한 기능들을 포함하고 있습니다.

MCP (.gemini\settings.json 설정파일)
파일 생성/수정 (특정 확장자 모두 변경해서 복사해줘)
스크립트 실행
웹 검색

이런 기능들은 아래와 같은 기본 툴로 이용 가능하며, 툴을 사용하고 싶지 않다면 settings.json에서 excludeTools를 통해 제외하면 됩니다. 보통 DB (데이터베이스)에 접근하여 분석 컨텍스트 제공을 한다던지, 분석 로그 / 리포트 (텍스트 형태)로 추가 보고서 작성이 가능합니다.

# Gemini CLI 기본 툴 (/tools 확인)
ℹ Available Gemini CLI tools:

    - ReadFolder
    - ReadFile
    - SearchText
    - FindFiles
    - Edit
    - WriteFile
    - WebFetch
    - ReadManyFiles
    - Shell
    - Save Memory
    - GoogleSearch

6. 주의점

Gemini CLI를 개인 Google 계정으로 무료로 시작할 수 있지만, 이 경우 입력한 프롬프트와 코드가 Google 모델 학습에 사용될 수 있으므로 민감한 내용은 주의해야 합니다. 반면, Gemini API 키를 사용하면 동일한 기능을 사용할 수 있으면서도, 입력 데이터가 학습이나 수집 대상으로 절대 포함되지 않아 개인정보 보호나 보안이 중요한 프로젝트에 적합합니다.

두유노우컴퓨터