Gemini CLI 사용량 확인 방법

Gemini CLI 설치/실행 가이드 (macOS / Windows / Linux)

목표: Node.js가 아예 없는 상태에서도 Node 설치 → Gemini CLI 설치 → 실행/로그인 → 동작 확인까지.

0) 공통: 설치 확인(이미 깔려있으면 스킵)

터미널(또는 PowerShell)에서 아래가 정상 출력되면 Node 설치는 이미 된 상태입니다.

node -v
npm -v

Node.js 설치는 공식 다운로드/설치 방법을 따르는 게 가장 안전합니다.

• https://nodejs.org/en/download

깔려있으면 바로 4) 으로 이동합니다.

1) macOS (Apple Silicon / Intel)

방법 A) 가장 쉬움: Homebrew로 Node 설치

1) Homebrew 설치(없으면):

• https://docs.brew.sh/Installation

2) Node 설치:

brew install node

3) 확인:

node -v
npm -v

방법 B) 버전 관리가 필요하면: nvm (권장)

1) nvm 설치:

• https://github.com/nvm-sh/nvm

2) Node LTS 설치/사용:

nvm install --lts
nvm use --lts
node -v
npm -v

2) Windows 10/11

방법 A) 가장 쉬움: winget으로 Node LTS 설치

PowerShell에서:

winget install -e --id OpenJS.NodeJS.LTS

설치 후 새 터미널 열고 확인:

node -v
npm -v

방법 B) 버전 관리가 필요하면: nvm-windows

• https://github.com/coreybutler/nvm-windows

설치 후 예시:

nvm install lts
nvm use lts
node -v
npm -v

3) Linux (Ubuntu/Debian 계열 기준)

방법 A) 가장 호환 좋은 방법: nvm (권장)

1) nvm 설치:

• https://github.com/nvm-sh/nvm

2) Node LTS 설치/사용:

nvm install --lts
nvm use --lts
node -v
npm -v

방법 B) 시스템 패키지(간단하지만 버전이 낮을 수 있음)

sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v

4) Gemini CLI 설치/실행 (공통)

4-1) 설치

Node/npm이 준비되면:

npm install -g @google/gemini-cli

4-2) 실행

gemini

4-3) 로그인(인증)

대부분은 gemini 실행 후 브라우저 로그인(개인 Google 계정) 흐름을 따릅니다.

• https://geminicli.com/docs/get-started/authentication/

5) 동작 확인 / 사용량(세션) 확인

Gemini CLI 안에서:

/stats

6) 자주 나는 문제 체크

(1) gemini: command not found

• 새 터미널을 다시 열어 PATH가 갱신되었는지 확인

• npm 글로벌 설치 경로가 PATH에 있는지 확인:

• macOS/Linux:

    npm prefix -g
    npm bin -g

(2) Windows에서 node는 되는데 npm이 안 잡힘

• 설치가 꼬였을 수 있어 Node 재설치(winget) 또는 nvm-windows로 통일 추천