Gemini CLI 설치, Windows에서 첫 프롬프트까지 10분 순서

Windows에서 바로 시작하려면 순서를 짧게 잡는 게 편합니다

Gemini CLI 설치를 찾는 사람은 대개 브라우저보다 터미널에서 바로 프롬프트를 넣고, 현재 폴더를 읽히고, 간단한 작업까지 이어가려는 경우가 많습니다. 그래서 이 글도 복잡한 옵션 설명보다 첫 프롬프트까지 가는 순서만 남겼습니다.

초반에 볼 건 세 가지입니다. Node.js가 준비됐는지, 설치 뒤에 PowerShell이 명령을 제대로 잡는지, 로그인과 API key 중 어떤 방식으로 들어갈지입니다. 이 세 가지만 정리하면 Windows에서도 시작 구간이 길어지지 않습니다.

Step 1: Node.js 버전부터 먼저 봅니다

Gemini CLI 설치는 Node.js가 먼저 있어야 진행됩니다. 여기서 먼저 볼 숫자는 20입니다. Node.js 20 이상이 아니면 설치 명령이 들어가더라도 뒤에서 다시 막히는 경우가 많습니다.

버전이 바로 보이면 다음 단계로 넘어가면 됩니다. 아무 응답이 없거나 npm이 인식되지 않으면 Gemini 쪽보다 Node 환경부터 다시 확인하는 편이 빠릅니다.

Windows에서는 Node를 설치한 직후에도 기존 PowerShell 창이 예전 PATH를 계속 들고 있는 경우가 있습니다. 그럴 때는 설정을 더 만지기 전에 새 PowerShell 창을 다시 여는 쪽이 먼저입니다.

Step 2: 설치 직후에는 버전과 경로를 같이 확인합니다

설치 명령 자체는 짧습니다. 대신 전역 설치가 끝난 뒤에 현재 창에서 바로 실행되는지까지 같이 확인해야 헷갈림이 줄어듭니다. 설치 완료보다 지금 열려 있는 PowerShell에서 명령이 잡히는지가 더 중요합니다.

gemini --version이 응답하고 where gemini에 경로가 보이면 다음 단계로 가면 됩니다. 2026년 5월 25일 시점에는 npm latest 태그가 0.3.4로 보였지만, 숫자 하나보다 현재 창에서 실행되느냐가 우선입니다.

명령이 안 잡히면 곧바로 설치 실패라고 보기보다 PATH 반영 문제부터 확인하는 편이 낫습니다. 특히 Windows는 설치는 끝났는데 터미널이 이전 상태를 계속 물고 있는 경우가 있어서, 여기서 시간을 많이 씁니다.

Step 3: 로그인 방식은 처음에 갈라두면 덜 꼬입니다

처음 실행하면 인증 방식을 고르게 됩니다. 개인 용도로 가볍게 시작하는 사람은 Sign in with Google 흐름이 가장 짧습니다. 브라우저가 열리고 계정을 고른 뒤 다시 터미널로 돌아오면 첫 대화로 이어집니다.

개인 Google 계정은 보통 이 경로로 시작하면 충분합니다. 반대로 자동화 작업, CI, headless 실행까지 생각하고 있다면 API key 방식이 더 맞을 수 있습니다.

이 분기를 초반에 알고 들어가면 나중에 인증 방식을 다시 갈아엎느라 시간을 덜 씁니다. 캐시된 로그인 상태가 없는 환경에서는 환경변수 기반 인증이 오히려 단순하게 느껴질 때도 있습니다.

Step 4: 첫 프롬프트는 현재 폴더 기준으로 넣는 게 좋습니다

Gemini CLI 설치가 끝난 뒤에는 큰 작업부터 던지기보다, 현재 폴더를 읽고 바로 결과가 보이는 요청으로 시작하는 편이 좋습니다. README 초안처럼 출력물이 눈에 바로 보이는 요청이 초반 확인에 잘 맞습니다.

이때 파일 읽기나 명령 실행 전에 권한 확인 화면이 보이면 이상한 흐름은 아닙니다. 로컬 폴더를 건드리는 작업에서는 어디까지 허용할지 한 번 멈춰 묻는 구조라서, 처음 쓰는 사람 입장에서는 오히려 범위를 파악하기 쉽습니다.

조금 더 가볍게 시작하고 싶다면 모델만 바꿔도 됩니다.

같은 요청이라도 기본 모델과 gemini-2.5-flash는 속도와 사용감이 다를 수 있습니다. 첫날에는 둘 다 한 번씩 비교해두면 이후에 어떤 작업을 어느 쪽으로 보낼지 정하기 편합니다.

Step 5: 업데이트와 확장은 나중에 한 번 더 봅니다

첫 실행이 끝나면 그다음부터는 업데이트 방법과 확장 목록을 알아두는 편이 좋습니다. 설치 직후부터 옵션을 한꺼번에 늘리기보다, 기본 상태로 먼저 굴린 뒤 필요한 것만 붙이는 쪽이 관리가 쉽습니다.

확장은 처음부터 많이 붙일 필요가 없습니다. 어떤 작업에서 자주 멈추는지 보고 필요한 것만 더해야 원인 파악도 편하고, 다음에 다시 켰을 때도 구성이 덜 복잡합니다.

마지막으로 보는 건 사용량과 막히는 자리입니다

Windows에서 여기까지 왔다면 남는 선택은 단순합니다. Google 계정 로그인으로 가볍게 쓸지, API key나 Vertex AI로 넘어가서 한도와 과금을 직접 관리할지 정하면 됩니다. 2026년 3월 26일 업데이트된 요금 안내 기준으로 개인 Google 계정은 하루 1000회, Google AI Pro는 1500회, AI Ultra는 2000회까지로 나뉘어 있었고, Gemini API key 무료 티어는 하루 250회로 적혀 있었습니다.

개인 작업이 중심이면 로그인 방식으로 시작해도 충분합니다. 팀 환경이나 자동화가 중심이면 초반부터 API key 구조를 잡는 편이 더 깔끔합니다. 어느 쪽이든 처음부터 다 외울 필요는 없습니다. Node 버전, PATH, 인증 방식 이 세 가지만 순서대로 보면 첫 프롬프트까지 가는 길이 짧아집니다.

터미널에서 AI 코딩 도구를 붙여 쓰고 싶은 사람이라면 이 정도만 정리해도 출발선은 충분합니다. 특히 Gemini CLI 설치를 검색해서 들어온 사람은 설치 자체보다 첫 실행 직전에서 많이 막히는데, 그 지점이 바로 Windows의 PATH와 인증 선택입니다. 그 둘만 넘기면 다음 단계는 훨씬 수월해집니다.