Gemini CLI는 구글의 오픈소스 터미널 AI 에이전트입니다. 네 가지 주요 AI CLI(클로드·코덱스·제미나이·그록) 중 유일하게 구글 계정 로그인만으로 무료 사용이 가능해서, AI CLI를 처음 접한다면 가장 부담 없는 출발점입니다. 설치는 한 줄입니다.
npm install -g @google/gemini-cli설치 — 윈도우와 맥 공통
Node.js 18 이상이 필요합니다(윈도우 winget install OpenJS.NodeJS.LTS, 맥 brew install node). 설치가 망설여지면 npx로 설치 없이 바로 실행해 볼 수도 있습니다:
npx @google/gemini-cli설치 확인은 gemini --version.
첫 실행 — 인증 방식 3가지 중 하나 선택
터미널에서 gemini를 입력하면 인증 방식을 묻습니다. 셋의 차이는 이렇습니다.
- Sign in with Google (추천) — 개인 구글 계정으로 브라우저 로그인. 무료 사용 한도가 제공됩니다. 대부분은 이걸 고르면 됩니다.
- Use Gemini API Key — Google AI Studio에서 발급받은 API 키로 인증. 무료 한도를 넘겨 쓰거나 자동화 스크립트에서 쓸 때 씁니다(종량제 과금).
- Vertex AI — 회사에서 구글 클라우드를 쓸 때의 기업용 경로입니다. 개인은 신경 쓸 필요 없습니다.
요금이 궁금하실 텐데, 개인 구글 계정 로그인은 무료 한도 안에서 과금이 없습니다. 한도를 넘기는 헤비 유저만 API 키(종량제)를 고려하면 됩니다.
기본 사용법
- 실행 후 한국어로 그냥 지시하면 됩니다 — “이 폴더에서 큰 파일 10개 찾아줘”.
- 특정 파일을 지정할 때는
@파일명으로 참조합니다. - 구글 검색과 연동돼 최신 정보를 물어보는 용도로도 강합니다.
설치가 안 될 때
- “gemini를 찾을 수 없습니다” — 터미널을 껐다 다시 여세요(PATH 갱신).
- npm 오류 —
node --version이 18 이상인지 확인. - 로그인 창이 안 뜸 — 터미널에 출력된 인증 URL을 복사해 브라우저에 직접 붙여넣으면 됩니다.
같이 보면 좋은 글
Claude Code·Codex·Grok까지 네 가지 CLI의 설치 명령 비교는 AI 코딩 CLI 설치 총정리에, Gemini와 ChatGPT 중 뭘 쓸지 고민이라면 Gemini 대 ChatGPT 비교에 정리해 두었습니다.
CLI로 만든 확장을 스토어에 올리실 계획이라면 — AI로 만든 크롬 확장이 웹스토어 심사에서 걸리는 지점 6가지에 권한·원격 코드·난독화처럼 코드를 짜는 단계에서 미리 잡아야 하는 항목을 정리해 뒀습니다.
답글 남기기