혁신을 이룹니다, 오딘박스(OdinBOX)

언제나 어디서나 오딘박스와 함께!

Google Gemini CLI, 사용방법

간지뽕빨리턴님 2025. 7. 6. 14:21
반응형

윈도우 기준으로 Node.js를 설치하고 Google의 최신 AI 터미널 도구인 Gemini CLI를 사용하는 방법

윈도우에서 Node.js 설치부터 Gemini CLI 설정까지 한 번에!

개발 입문 자라면 AI 도구를 활용해 개발 생산성을 높이고 싶을 때가 있습니다. 구글이 공개한 Gemini CLI는 터미널에서 바로 AI 도움을 받을 수 있는 오픈소스 도구로 개인 Google 계정만 있으면 무료로 구글 AI 모델인 Gemini 2.5 Pro의 기능을 사용할 수 있습니다. 이 글에서는 윈도우(Windows) 운영체제 기준으로 NodeJS 설치부터 Google Gemini CLI 설치 및 초기 설정, 그리고 기본 사용방법까지 단계별로 정리를 해보겠습니다.

목차

    Google Gemini CLI

    NodeJS 설치방법

    Install Node.JS를 선택해도 되고, 상단 다운로드를 선택하고 설치를 하셔도 됩니다.

    Gemini CLI는 NodeJS로 구현되어 있으므로 먼저 노드 JS를 먼저 설치를 해야 합니다. 사이트[#]에 접속을 하여 LTS 버전 설치 프로그램을 다운로드하면 됩니다.

    설치를 하기 전 NodeJS가 설치되어 있는지 확인을 해보도록 하겠습니다, 하단 윈도우 로고에서 오른쪽 마우스 클릭하면 메뉴가 뜨는데 해당 메뉴에서 터미널(관리자)을 선택하고 아래의 명령어를 입력하면 됩니다. (설치를 다 하고 확인을 반드시 해주시길 바랍니다.)

    node -v # Node.JS 버전 확인(정상 설치 시 버전 번호 출력)
    npm -v # npm 버전 확인(정상 설치 시 버전 번호 출력)

    정상적으로 설치가 되었다면 숫자로 된 글자 등이 출력이 될 것이고 만약 제대로 설치가 되질 않았다면 'node'은(는) 내부 또는 외부 명령... 인식되지 않습니다. 등의 에러 메시지가 나옵니다. 이때는 삭제하고 재설치하는 것을 추천해 드립니다.

    사실상 설치를 할 때 특별하게 설정할 것이 없어 그냥 다음만 눌러도 잘 설치가 됩니다. 반드시 설치하고 명령프롬프트에 설치가 잘되었는지 확인하는 것을 권장해 드립니다.

    Google Gemini GLI 설치방법(npm)

    환경 세팅은 완료가 되었습니다. Gemini CLI는 npm 패키지로 배포되어 있어 한 줄의 명령어로 설치가 가능합니다. 명령프롬프트(또는 PowerShell)에서 아래 명령어를 실행하시면 됩니다.

    npm install -g @google/gemini-cli

    위 명령은 전역(-g) 옵션으로 Gemini CLI를 설치합니다. 설치 과정에서 인터넷을 통해 패키지를 내려받으므로 약간의 시간이 소모될 수 있습니다. 설치 완료 후 오류 없이 명령프롬프트로 돌아오게 되었다면 성공입니다.

     

    * 전역 패키지 설치 시 권한 오류가 발생하는 경우 관리자 권한으로 명령 프롬프트를 실행하거나 Mac/Linux의 경우 sudo를 붙여 시도를 하면 됩니다.

    Google Gemini CLI 초기 설정 및 Google 계정 인증

    이제 설치는 다 완료가 되었습니다. 터미널에서 Gemini 명령을 입력하면 실행을 할 수 있습니다. 처음 실행 시 CLI가 몇 가지 초기 설정을 필요로 합니다.

     

    테마 선택 : 터미널 화면에 텍스트 테마를 선택하는 메뉴가 나타나면 화살표 키로 마음에 드는 테마를 선택하고 Enter 키를 누릅니다.

    인증방법 선택 : Login With Google 구글 계정으로 로그인 옵션을 선택합니다. 개인 구글 계정으로 로그인하면 분당 60회 하루 1000회의 요청을 무료로 사용할 수 있는 자격이 주어집니다.

    구글 로그인 또는 제미나이 API Key를 사용을 하거나 Vertex AI 등을 선택을 할 수 있습니다.

    설치부터 설정까지 모두 완료가 되었습니다. 간단하게 명령프롬프트에서 여러분이 원하는 것을 AI에 질문을 할 수 있습니다.

    무료 사용량 및 크레딧 확인방법

    개인 계정으로 사용하는 한 완전히 무료로 사용을 할 수 있고 사용 한도도 일반적인 개발 작업량을 훨씬 웃돌 정도로 여유롭게 사용할 수 있습니다. 구글에 따르면 대부분의 개발자가 이 한도에 도달하지 않을 것이라고 한만큼 넉넉한 무료 사용량(분당 60회, 일 1000회 요청)을 제공을 하고 있습니다. 따라서 개인 프로젝트나 학습 용도로는 사실상 제한 없이 사용할 수 있습니다.

     

    무료 사용량 내에서는 별도의 크레딧을 충전을 할 필요가 없으며 크레딧 잔액을 신경 쓸 필요 없이 마음껏 AI 기능을 활용하면 됩니다. 그러나 만약에 기업 환경이나 이런 곳에서 여러 개발자가 동시에 사용을 한다면 구글 클라우드의 Vertext  AI API키를 사용해 확장할 수 있습니다. 구글 AI Studio에서 제미나이 키를 받급하여 유료로 사용을 하거나 할 수 있습니다.

    현재 사용량이 궁금하다면 Gemini CLI 상에서 /help 명령을 입력하여 확인을 할 수 있습니다.

    MacOS/Linux 사용자를 위한 설치방법

    Mac은 아까 설치했던 NodeJS 공식홈페이지에서 설치를 진행을 하고 Linux 사용자의 경우 apt, dnf 등의 패키지 관리자 또는 NodeSource의 설치 스크립트를 사용할 수 있습니다. 어느 경우든 Node18 버전이상을 서치를 해야 합니다.

    그리고, npm install -g @google/gemini-cli를 입력하여 설치를 할 수 있습니다. 만약 에러가 난다면 앞에 sudo를 입력하시면 됩니다. 그리고 난 뒤 동일하게 초기 설정을 진행을 하고 설정하면 사용을 할 수 있습니다.

    마무리

    이제 터미널에서 AI 활용하는 첫걸음을 떼신 것을 환영합니다. 처음에는 다소 생소할 수 있지만 사용하다 보면 자연어로 코딩을 돕고 문제를 해결해 주는 AI비서가 주는 편리함도 있을 겁니다. 특히 초보 개발자들에게 막막한 문제 해결을 하거나 예시코드를 얻는데 큰 도움이 될 수 있으니 적극적으로 활용해 보세요.

     

    물론, 해당 제미나이 CLI가 완벽한 것은 아닙니다. 생성된 코드나 주고받은 내용들이 AI 학습을 위해 활용을 할 수 있다고 하니 유념해서 사용을 하시는 것을 추천해 드립니다.

     

    직접 여러분이 터미널에서 Gemini CLI를 실행하고 AI와 함께 코딩 경험을 즐겨보고 다양한 아이디어로 현실에서 만드는 속도가 빨라지고 개발 과정이 한층 수월해질 겁니다!

    (+ 다음엔 이걸 활용하여 MCP를 구축하여 한번 만들어보도록 하겠습니다.)