[Gemini CLI] 쉽게 따라 할 수 있는 AI 도구 Gemini CLI 설치하기

개발 환경을 한 단계 업그레이드할 수 있는 강력한 도구, Gemini CLI의 설치 방법을 안내해 드리겠습니다.

Gemini CLI는 구글의 최신 AI 모델인 Gemini를 터미널 환경에서 직접 활용할 수 있게 해주는 Command Line Interface입니다.

이 도구를 통해 코드 작성, 디버깅, 정보 검색 등 다양한 작업을 효율적으로 수행할 수 있습니다.

 

1. Gemini CLI

• Gemini의 100만 토큰 컨텍스트 창 안팎에서 대규모 코드베이스를 쿼리하고 편집합니다.
• 풀 리퀘스트 쿼리나 복잡한 리베이스 처리와 같은 운영 작업을 자동화합니다.
• Imagen, Veo 또는 Lyria를 사용한 미디어 생성을 포함한 새로운 기능을 연결하기 위해 도구와 MCP 서버를 사용하세요.
• Gemini에 내장된 Google 검색 도구를 사용하여 궁금한 사항을 구체적으로 검색해 보세요.
• 분당 60회, 일 1000회로 무료 이용이 가능합니다.

 

 

2. Node.js 버전 확인 및 설치 사전 준비

Gemini CLI는 Node.js 기반으로 동작합니다. 설치를 진행하기 전에 시스템에 적합한 Node.js 버전이 설치되어 있는지 확인하는 것이 필수적입니다.

먼저, 터미널(macOS/Linux) 또는 명령 프롬프트(Windows)를 실행합니다.

다음 명령어를 입력하여 Node.js 및 npm(Node Package Manager)의 버전을 확인합니다.

node -v
npm -v

Gemini CLI는 Node.js 20.x 버전 이상을 요구합니다. 만약 node -v 명령의 결과가 v20.x.x 미만인 경우, Node.js 업데이트 과정을 반드시 수행해야 합니다.

Node.js 버전이 요구 사항을 충족하지 못할 경우, npm WARN EBADENGINE Unsupported engine과 같은 경고와 함께 설치가 정상적으로 완료되지 않을 수 있습니다.

 

 

3. Node.js 버전 업데이트 가이드 (nvm 활용)

Node.js 버전이 Gemini CLI의 요구 사항을 충족하지 못하는 경우, Node.js를 업데이트해야 합니다.

nvm(Node Version Manager)은 여러 Node.js 버전을 효과적으로 관리할 수 있는 유용한 도구입니다.

 

[nvm이 이미 설치된 경우]

1. Node.js 20 LTS 버전 설치: 터미널에서 다음 명령어를 실행하여 최신 LTS(Long Term Support) 버전인 Node.js 20을 설치합니다.

   nvm install 20
   

2. 설치된 Node.js 20 버전 활성화: 새로 설치된 Node.js 20 버전을 현재 터미널 세션에 적용합니다.
   이후 node -v 명령을 다시 실행하여 v20.x.x가 출력되는지 확인합니다.
   만약 버전이 변경되지 않았다면, 터미널을 재시작한 후 nvm use 20 명령을 다시 실행해야 합니다.

   nvm use 20
   

[nvm이 설치되지 않은 경우]

• Node.js 공식 웹사이트를 통한 직접 설치: Node.js 공식 웹사이트(https://nodejs.org/)에 접속하여 메인 페이지에 명시된 **LTS 버전(v20.x.x)**의 설치 파일을 직접 다운로드하여 실행합니다.
  설치 마법사가 기존 버전을 최신 버전으로 업데이트하는 과정을 안내합니다.
  설치 완료 후에는 반드시 터미널을 재시작해야 변경된 버전이 적용됩니다.

Node.js 버전 업데이트가 성공적으로 완료되면, Gemini CLI 설치를 진행할 수 있습니다.

 

 

4: Gemini CLI 설치 명령어 실행

Node.js 환경 설정이 완료되었다면, 이제 npm을 사용하여 Gemini CLI를 시스템에 설치합니다.

npm install -g @google/gemini-cli

• -g 플래그는 Gemini CLI를 전역으로 설치하여, 시스템의 어느 디렉토리에서든 gemini 명령어를 사용할 수 있도록 합니다.
• EACCES와 같은 권한 오류가 발생하는 경우, sudo 명령어를 사용하여 sudo npm install -g @google/gemini-cli와 같이 실행해야 할 수 있습니다. (이는 주로 macOS나 Linux 환경에서 발생합니다.)

 

5. Gemini CLI 초기 설정 및 구글 계정 인증

Gemini CLI 설치가 완료된 후, 첫 사용을 위한 초기 설정 및 구글 계정 인증이 필요합니다.

터미널에 다음 명령어를 입력하여 Gemini CLI를 실행합니다.

gemini

 

1. 테마 선택: Gemini CLI의 시각적 테마를 선택하는 옵션이 제공될 수 있습니다.
2. 구글 계정 인증: 웹 브라우저가 자동으로 열리며, Gemini CLI가 구글 서비스에 접근할 수 있도록 구글 계정으로 로그인하고 권한을 부여하라는 메시지가 표시됩니다.
   
   • 개인 구글 계정으로 로그인하면 무료 Gemini Code Assist 라이선스를 획득하게 되며, 이를 통해 Gemini 2.5 Pro 모델을 활용할 수 있습니다.
   • 필요에 따라 Google AI Studio 또는 Vertex AI에서 발급받은 API 키를 사용하여 인증하는 옵션도 존재합니다.

 

구글 계정 인증이 성공적으로 완료되면, 터미널에 설정 완료 메시지가 표시되며 Gemini CLI를 사용할 준비가 완료됩니다.

 

 

6: Gemini CLI 활용 및 기본적인 사용법

모든 설정이 완료되었다면, 이제 Gemini CLI를 통해 AI의 강력한 기능을 활용할 수 있습니다.

해당 폴더에 접근해서 html을 만들어 달라거나, 이미지 포맷 변환을 해달라고도 할 수 있습니다.

 

 

Gemini CLI를 통해 AI 기반의 개발 환경을 구축하고, 코딩 효율성을 크게 향상시킬 수 있습니다.

개발 과정에서 발생하는 다양한 문제들을 Gemini CLI와 함께 해결하며, 더욱 생산적인 개발 경험을 하시길 바랍니다.