[GCP] Gemini CLI 설치

GEMINI CLI

https://github.com/google-gemini/gemini-cli

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

 

Gemini CLI는 터미널에서 직접 Gemini에 접근할 수 있는 오픈소스 AI Agent이다.

사용자의 tools에 연결하고, 사용자의 코드를 이해하여 작업을 가속화시켜 줄 수 있는 툴이다.

 

공식 GitHub에선 다음과 같은 일들을 할 수 있다고 한다.

• Gemini의 1M context안에서 대규모 코드베이스를 수정하고 질의할 수 있다.
• Gemini의 멀티모달 기능을 사용하여 PDP들이나 설계안으로 새로운 앱을 만들 수 있다.
• PR 질의나 복잡한 rebase상황을 제어하는 것과 같은 운영 작업의 자동화가 가능하다. 
• 새로운 확장기능을 연결하는 툴이나 MCP 서버를 사용할 수 있다.
• 내장된 Google Search와 함께 질문들을 구체화 할 수 있다.

 

설치

Node 설치

먼저 Node.js 20이나 그 이상의 버전이 필요

다음 명령어를 실행

npx https://github.com/google-gemini/gemini-cli

 

또는 다음 명령어로 설치

npm install -g @google/gemini-cli

 

그리고 다음 명령어 실행하여 gemini cli를 실행

gemini

 

Homebrew 설치

homebrew가 있는 경우는 간단하다.

brew install gemini-cli

 

이후 gemini cli 실행

gemini

 

나는 homebrew가 있어 homebrew로 설치한다.

먼저 brew update로 레포지토리를 갱신한다.

 

이후 gemini-cli를 설치한다.

 

이제 gemini를 실행시켜 본다.

나는 iterms2를 사용하는데, iterms2가 3개 정도의 저장소에 접근권한을 가져야 한다고 해서 전부 허용했다.

gemini cli가 실행됬다

 

설정

먼저 색상테마를 선택한다고 하는데 나는 인증 먼저 나온다.

 

프롬프트를 쓰려면 개인 구글 계정으로 로그인해야 하는데, 기본적으로 분당 60회의 요청, 하루 1,000건의 요청을 사용할 수 있다.

인증 방법엔 3가지가 있는데, Google 로그인, Gemini API Key를 통한 인증, Vertex AI API Key를 통한 인증이 있다.

https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/authentication.md

Google Login을 통한 인증

다른 서비스에서 구글계정연동 하는 것 처럼 google 로그인 창이 나오고 접근 허용하면 된다.

Gemini API key를 이용한 인증

Gemini API는 무료 사용일 경우 Gemini 2.5 Pro 모델에 하루 100개의 요청제한이 있다.

1. google AI Studio에서 키를 발급받는다.

2. 터미널 환경변수로 다음 두 값을 추가한다. (YOUR_API_KEY를 발급받은 키로 바꾼다)

export GOOGLE_API_KEY="YOUR_API_KEY"

 

Vertex AI API Key를 이용한 인증

Vertex AI API는 무료 사용일 경우 익스프레스 모드를 사용하는 Gemini 2.5 Pro를 사용할 수 있다.

1. Google Cloud에서 키를 발급받는다.

2. 터미널 환경변수로 다음 두 값을 추가한다. (YOUR_API_KEY를 발급받은 키로 바꾼다)

export GOOGLE_API_KEY="YOUR_API_KEY"
export GOOGLE_GENAI_USE_VERTEXAI=true

 

방향키로 움직일 수 있으며 나는 1번을 선택해 인증하려고 한다. 

구글 로그인창이 나온다

 

계정을 선택하거나 로그인 하면 다음 창이 뜨고, 이제 gemini-cli를 사용할 수 있게 된다.

\

사용

로그인을 마친 gemini-cli는 이런 창이 뜬다.

 

창에는 gemini 로고, 사용 팁, 그리고 프롬프트 영역이 있다.

하단에는 3가지 요소가 보이는데 왼쪽엔 현재 디렉토리 및 git branch, 중간엔 sandbox에서 실행됐는지, 오른쪽엔 gemini-2.5-pro 모델에 대한 사용가능량이 보인다.

 

명령어

프롬프트 창에 슬래쉬(/)를 입력하면 사용할 수 있는 명령어들이 나오고, 방향키를 통해 자동 완성이 가능하다.

각 명령어에 대한 설명은 다음 링크에 설명되어 있다.(https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/commands.md)

 

/theme을 입력 시 아까 하려고 했던 테마 변경창이 나온다.

개인적으론 기본이 제일 이쁘다

/tools를 사용 시 현재 gemini-cli에서 사용할 수 있는 툴들이 보인다.

/tools desc 명령어를 통해 설명까지 볼 수 있다.

/stats를 사용하면 현재 세션의 통계들을 볼 수 있다.

 

다 사용하고 나갈 떈 ctrl+C 또는 /quit을 통해 나갈 수 있다.

 

에디터 설정 및 사용

사실 gemini-cli를 설치한 가장 큰 이유가 editor들과의 전환이 자연스럽다는 평이 많아서 사용했다.

/editor 명령어를 통해 초기에 에디터를 설정한다.

설치된 설정 가능한 editor들 목록이 표시된다.

나는 현재 컴퓨터엔 Cursor와 Vim밖에 없어 Cursor로 선택했다.

User Settings할 지, Workspace에만 Settings 할지 고르는데, 나는 아직은 따로 할 필요가 없어 User Settings를 선택했다.

입력 후엔 다음과 같은 메세지와 함께 다시 chat 창으로 돌아온다.

하지만 gemini-cli를 사용한다면 cursor가 필요 없지 않을까 싶다.

 

이후 gemini-cli에서 특정 모듈에 객체 하나를 만들어달라고 시켜봤다.

이렇게 한 번 허용, 항상 허용, 외부 에디터에서 변경, 적용 안함이 있다.

3번을 선택하여 외부 에디터를 연결해 본다.

cursor에서 diff가 열리고, 수정할 수 있다.

이제 수정을 마치고 에디터를 닫으면 수정된 코드가 반영되어 다시 적용할지 물어본다.

 

이제 적용하거나 취소하여 작업을 완료할 수 있다.

 

마치며

Gemini-cli의 다양한 명령어, 단축키, 테마, 툴 사용법, mcp 추가 등등 문서들은 https://github.com/google-gemini/gemini-cli/blob/main/docs/index.md 또는 /docs 명령어를 통하여 볼 수 있다.

 

개인적으론 cursor의 자동완성 기능(tab-tab)이 너무 편해 결제하여 사용하고 있지만, gemini-cli를 통해 cursor의 상당 부분을 대체할 뿐 만 아니라 더 다양한 기능을 제공해줄 수 있을 것 같다.