Gemini CLI

구글이 만든 오픈소스 터미널 AI 에이전트

npm install -g @google/gemini-cli

구글이 공개한 터미널 코딩 에이전트입니다. Gemini 모델에 가장 짧은 경로로 닿는 것을 목표로 만들었고 확장과 MCP 연결을 지원합니다. npm 전역 설치와 Homebrew, npx 실행 중 편한 경로를 고르면 됩니다.

판단

이럴 때 씁니다

  • Gemini 모델을 터미널에서 바로 쓰고 싶을 때
  • 구글 계정 로그인만으로 무료 한도 안에서 코딩 에이전트를 써 보고 싶을 때
  • MCP 서버와 확장을 붙여 작업 범위를 넓히고 싶을 때
  • 오픈소스라 동작을 직접 확인하고 고칠 수 있어야 할 때

이럴 땐 쓰지 마세요

  • Gemini 외 모델을 주로 쓰는 팀일 때
  • 설정을 최소로 유지하며 한 모델만 깊게 쓰고 싶을 때
  • 릴리스가 자주 바뀌는 도구를 팀 표준으로 두기 어려울 때

차별점

  • 구글이 직접 만든 공식 오픈소스 터미널 에이전트입니다.
  • 무료 한도가 있어 시작 문턱이 낮습니다.
  • 확장과 MCP 를 통해 도구를 넓히는 구조를 갖췄습니다.
  • 저장소 활동이 매우 활발해 문제 보고가 빨리 반영됩니다.

워크플로

  1. 01npm install -g @google/gemini-cli 또는 brew install gemini-cli 로 설치합니다.
  2. 02프로젝트 디렉터리에서 gemini 를 실행하고 계정으로 인증합니다.
  3. 03필요한 MCP 서버를 설정에 등록해 도구를 넓힙니다.
  4. 04확장을 설치할 때는 환경 변수 변경 동의 요청을 확인하고 넘어갑니다.

주요 명령

명령설명
npm install -g @google/gemini-cli안정 버전을 전역 설치합니다.
brew install gemini-climacOS 에서 Homebrew 로 설치합니다.
npm install -g @google/gemini-cli@nightly야간 빌드를 씁니다. 변경이 잦으니 실험용으로만 권합니다.

함정

설치 전에 확인하세요

  • 야간 빌드가 매일 나옵니다. 팀에서 쓴다면 안정 태그로 고정하는 편이 좋습니다.
  • 확장이 환경 변수를 바꿀 수 있습니다. 최근 버전은 이때 동의를 묻고 실행에 영향을 주는 변수를 걸러냅니다.
  • 시스템 전역 설정 경로에는 권한과 소유권 검사가 걸립니다. 공용 머신에서 설정이 무시되면 이 검사를 확인해야 합니다.

비교

Claude Code 나 Codex 와 같은 자리를 놓고 겨루는 도구입니다. 모델 선택지가 Gemini 로 좁은 대신 무료 한도가 있어 부담 없이 붙어 볼 수 있습니다. 여러 모델을 오가야 한다면 Crush 나 goose 처럼 프로바이더를 갈아 끼우는 쪽이 맞습니다.

최근 변경

v0.59.0에서는 MCP OAuth 메타데이터 탐색·인증의 SSRF 방어를 강화하고, restricted mode에서 workspace trust를 fail-closed로 적용하면서 MCP 서버 필터링을 추가했습니다.

공식 변경 내역