1. Gemini CLI

Note:

• 구글랩스:구글의 실험적인 기능테스트

• GitHub

• 홈페이지

• 명령어참고서

  
  

Gemini CLI는 터미널에서 직접 Gemini를 사용할 수 있는 오픈 소스 AI 에이전트이다. Apache 2.0 라이선스.

1.1. 특징

• 무료 요금제: Google 계정 로그인 시 분당 60건, 하루 1,000건 요청 가능

• Gemini 3 모델: 100만 토큰 컨텍스트 윈도우

• 멀티모달: PDF, 이미지, 스케치 등 다양한 입력 지원

• 내장 도구: Google 검색, 파일 작업, 셸 명령, 웹 가져오기

• MCP 지원: 확장 프로그램을 통한 커스텀 통합 (Figma, GitHub, Slack 등)

• 대화 체크포인트: 세션 저장/복원 가능

1.2. 설치

요구사항: Node.js 20 이상 / macOS, Linux, Windows

1.2.1. Windows / Linux

1. 윈도우 cmd를 열고 아래의 명령어 입력

npm install -g @google/gemini-cli

1. 설치 없이 바로 실행:

npx @google/gemini-cli

1. 윈도우 에서 아래와 같이 오류 발생 할 경우

1. 아래와 같이 입력후 다시 1을 진행한다.

Set-ExecutionPolicy RemoteSigned

1. 설치완료

   

1.2.2. macOS

brew install gemini-cli

또는 MacPorts:

sudo port install gemini-cli

1.3. 인증 (3가지 방식)

1.3.1. Google 로그인 (권장)

1. 터미널에 gemini 입력 후 엔터

  gemini

1. 신뢰할수 있는 폴더인지 묻는다.

2. 1 선택후 엔터

   

3. "How would you like to authenticate?" 질문에서 Login with Google 선택후 엔터

   

1. 브라우저에서 Google 계정 로그인 및 권한 허용 계속 엔터키 친다

   

   

2. 신뢰할수 있는 사이트 인지 묻는다. 허용을 클릭 하고 구글 계정으로 로그인한다.

3. 
   

   

4. 로그인 클릭

   

5. .브라우저의 화면이 아래와 같이 변경된다.

6. 
   

   

7. 터미널 화면은 아래와 같이 변경된다.

   

8. 터미널 창에서 ctrl + c 를 두번 눌러 geminicli를 종료한다.

9. 다시 gemini를 입력하여 실행하면 사용할수 있다.

1.3.1. 요금제

1.3.2. Gemini API 키

API 키 발급 후 환경변수 설정:

export GEMINI_API_KEY="발급받은_키"

1.3.3. Vertex AI (기업용)

export GOOGLE_API_KEY="키"
export GOOGLE_GENAI_USE_VERTEXAI=true

90일 무료 체험 후 토큰 기반 과금. 높은 요청 한도 제공.

1.4. 실행

gemini

특정 모델 지정:

gemini -m gemini-2.5-flash

비대화형 모드 (스크립트용):

gemini -p "이 프로젝트 구조를 설명해줘"

1.5. 슬래시 명령어

대화 중 / 로 시작하는 명령어이다.

1.5.1. 기본

1.5.2. 대화 관리

1.5.3. 설정

1.5.4. 도구 및 확장

1.6. 특수 입력

1.7. 예약된 파일명

Gemini CLI가 특별한 목적으로 인식하는 파일들이다. 프로젝트 루트나 .gemini/ 폴더에 위치한다.

1.8. 활용 예시

Note: 공식 예제

1.8.1. 파일명 일괄 변경

photos/photo1.png
photos/photo2.png
photos/photo3.png

gemini -p 'Rename the photos in my "photos" directory based on their contents.'

1.8.2. 코드 분석

gemini -p "이 프로젝트의 아키텍처를 분석하고 개선점을 알려줘"

1.8.3. 사용량 확인

대화 중 아래 명령어로 현재 토큰 사용량과 쿼터를 확인할 수 있다:

/stats model

1.9. 확장 프로그램 (Extensions)

Note: 확장 프로그램 갤러리 - 441개 이상의 확장 제공

확장 프로그램 설치 명령어:

gemini extensions install [GitHub URL]

1.9.1. Figma 연결

gemini extensions install https://github.com/figma/figma-gemini-cli-extension

인증키 설정 (Figma에서 Personal Access Token 발급 후):

gemini extensions config figma FIGMA_PERSONAL_ACCESS_TOKEN

발급받은 토큰을 붙여넣는다.

1.9.2. GitHub 연결

gemini extensions install https://github.com/github/github-mcp-server

1.9.3. 주요 확장 목록