“ 매주 목요일마다 당신이 항상 하던대로 신발끈을 묶으면 신발이 폭발한다고 생각해보라.
컴퓨터를 사용할 때는 이런 일이 항상 일어나는데도 아무도 불평할 생각을 안 한다. ”- Jef Raskin
맥의 아버지 - 애플컴퓨터의 매킨토시 프로젝트를 주도
윈도우 기준으로 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 설치방법
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를 구축하여 한번 만들어보도록 하겠습니다.)