제미나이 cli 설치

GitHub – google-gemini/gemini-cli: An open-source AI agent that brings the power of Gemini directly into your terminal.

https://youtu.be/6a3DEU9z_eo

🎯 Gemini CLI란?

Gemini CLI는 구글의 Gemini 2.5 Pro 모델을 터미널에서 바로 사용할 수 있게 해주는 오픈소스 AI 에이전트입니다. 소스코드를 분석하고, 오류를 수정하며, 쉘 명령 실행 등 다양한 작업을 자연어 프롬프트로 가능하게 해줍니다. 또한 built‑in MCP 서버와 Google Search, 이미지 생성 툴 등과도 통합되어 있습니다.DEV Community+3The Verge+3해커눈+3

⚙️ 설치 및 인증

1. 사전 준비

2. 설치 방법

nginx복사편집npm install -g @google/gemini-cli

또는 설치 없이 실행하려면:

bash복사편집npx https://github.com/google‑gemini/gemini‑cli

blog.google+2YouTube+2DEV Community+2

3. 실행 및 로그인

nginx복사편집gemini

처음 실행 시 Google 계정 인증을 통해 무료 라이선스를 활성화하세요해커눈blog.google
원하는 경우 Google AI Studio 또는 Vertex AI API 키를 사용할 수도 있습니다.Simon Willison’s Weblog+6philschmid.de+6blog.google+6

🚀 기본 사용 방법

◻️ 대화형 사용

  • gemini 커맨드 실행 후 REPL 환경에서 자연어로 메시지 입력 가능

◻️ 비대화형 사용

  • 프롬프트 하나만 실행: 
nginx복사편집gemini -p "Summarize this file. @./README.md"
  • 파이프 입력: 
bash복사편집echo "Count to ten" | gemini

해커눈

◻️ 쉘 커맨드 실행

  • ! 프롬프트를 통해: 
shell복사편집> !ls -al
  • 단독 ! 입력하면 쉘 모드 전환 후 다시 !로 종료할 수 있음philschmid.de

🛠 기본 내장 도구 (Built-in Tools)

클라이언트는 기본적으로 다음과 같은 도구를 제공하여 작업을 수행합니다해커눈Medium:

도구설명
ls / ReadFolder디렉터리 목록을 보여줌
read-file단일 파일 전체 내용 읽기
read-many-filesglob 패턴으로 여러 파일 읽기
glob / FindFiles파일 패턴 검색

⚙️ 설정 및 옵션

설정 파일

예시 설정:

json복사편집{
  "theme": "GitHub",
  "autoAccept": false,
  "sandbox": "docker",
  "checkpointing": { "enabled": true },
  "fileFiltering": { "respectGitIgnore": true }
}

philschmid.de

✨ 주요 슬래시(/) 명령어

  • /help: 도움말 표시
  • /stats: 사용량 및 토큰 통계 확인
  • /tools: 사용 가능한 도구 목록 보기
  • /mcp: 설정된 MCP 서버 목록
  • /restore: 체크포인트에서 프로젝트 복원
  • /clear: 화면 및 컨텍스트 초기화
  • /theme: 테마 변경
  • /auth: 인증 방식 전환
  • /compress: 컨텍스트 요약으로 압축
  • /copy: 마지막 응답을 클립보드에 복사
  • /chat save/resume <tag>: 대화 세션 저장 및 재개Medium+9philschmid.de+9Google for Developers+9

🔄 체크포인트 (Checkpointing)

  • -c 또는 --checkpointing 플래그로 시작하면 중요한 변경 전 프로젝트 상태 자동 스냅샷 생성됨.
  • /restore 명령으로 특정 시점 복원 가능하며, 각 스냅샷은 타임스탬프와 수정 도구명으로 식별됨Medium+1philschmid.de+1

🧩 MCP 서버 및 확장 기능

  • MCP(Model Context Protocol) 사용으로 GitHub, 이미지·비디오 생성 도구(Imagen, Veo) 등 외부 툴과 통합
  • .gemini/settings.json에 설정 추가 가능: 
json복사편집{
  "mcpServers": {
    "github": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "<MY_GITHUB_PAT>" },
      "timeout": 5000
    }
  }
}

Google for Developers+7The Verge+7Indiatimes+7

  • /mcp 명령을 통해 사용 가능한 툴 확인 가능

🔎 활용 예시

  • 코드 요약 또는 설명: 
shell복사편집> What does index.js do? @./index.js
  • 버그 수정 요청: 
pgsql복사편집> Add error handling to index.js
  • 커밋 메시지 자동 생성 (git diff 파이프로 입력)
  • GitHub 리포지토리 분석 및 자동 수정 (MCP 서버 필요)해커눈Medium

📺 사용 예제 영상

위 영상은 설치부터 코드 분석, Git 커밋 메시지 생성, MCP 설정까지 단계별로 설명한 좋은 데모입니다.

✅ 요약 정리

  1. Node.js 18+ 설치
  2. npm install -g @google/gemini-cli 또는 npx ...
  3. gemini 실행 후 Google 계정 로그인
  4. 슬래시 명령어로 도구 활용 (/stats, /mcp, /restore 등)
  5. ! 명령으로 쉘 커맨드 직접 실행
  6. MCP 서버 설정으로 확장 기능 이용 가능
  7. --checkpointing 모드로 안전하게 코드 실험하기