Gemini CLI가 뭔지부터 짚고 가겠습니다
Gemini CLI 사용법을 찾아보셨다면, 아마 이런 질문이 먼저 드셨을 겁니다. "터미널? 그거 개발자들이 쓰는 그 까만 화면?"
맞습니다. Gemini CLI는 그 터미널에서 Gemini AI와 대화할 수 있게 해주는 구글의 오픈소스 AI 에이전트입니다. 웹 브라우저를 열지 않아도, 터미널 창 하나로 파일을 읽고 코드를 수정하고 질문에 답을 받을 수 있죠. 설치는 npm 명령어 한 줄로 끝납니다.
여기서 중요한 건 '오픈소스'라는 점입니다. Apache 2.0 라이선스로 공개되어 있어서, 누구나 소스코드를 들여다볼 수 있고 원한다면 직접 고쳐 쓸 수도 있습니다. Claude Code가 클로즈드 소스인 것과 대조적이죠.
저는 개발자가 아닙니다. Python 문법도 가물가물하고, 터미널은 가끔 git 명령어 복사 붙여넣기 할 때나 열었습니다. 그런 제가 Gemini CLI를 설치해보면서 막혔던 지점과 해결 방법을 솔직하게 적어보려 합니다.
비전공자 기준 Gemini CLI 설치 체험기 — Node.js부터가 관문
Gemini CLI npm 설치의 첫 관문은 Node.js입니다. npm이라는 게 Node.js에 딸려 오는 패키지 관리 도구라서, Node.js가 없으면 npm 명령어 자체를 쓸 수 없습니다.
공식 문서 기준으로 Node.js 버전 18 이상이 필요합니다. 설치는 nodejs.org에서 본인 운영체제에 맞는 파일을 받아서 실행하면 됩니다. macOS나 Windows 모두 설치 파일 형태로 제공되니 어렵지 않아요.
Node.js가 설치됐다면, 터미널을 열고 이 한 줄을 입력합니다.
npm install -g @google/gemini-cli
설치가 끝나면 gemini 명령어를 입력해서 실행할 수 있습니다. 처음 실행하면 브라우저가 자동으로 열리면서 Google 계정 로그인 화면이 나옵니다. 로그인하면 OAuth 토큰이 로컬에 저장되고, 이후에는 별도 API 키 설정 없이 바로 사용할 수 있습니다.
제가 처음에 막혔던 지점은 macOS에서 npm 권한 오류가 뜬 경우였습니다. npm ERR! 로 시작하는 에러인데, 이때는 nvm(Node Version Manager)을 통해 Node.js를 다시 설치하면 대부분 해결됩니다. 전역 설치 권한 문제라서, nvm으로 설치하면 sudo 없이도 잘 동작합니다.
설치 자체는 30분 이내로 끝납니다. 다만 터미널 명령어가 익숙하지 않다면, 에러 메시지를 복사해서 ChatGPT에 붙여넣는 게 가장 빠른 해결책이었습니다.
무료 티어의 실체 — 하루 1,000 요청이 실제로는 어느 정도일까
Gemini CLI 무료 사용의 핵심 조건은 개인 Google 계정 로그인입니다. 이렇게 하면 분당 60 요청, 하루 1,000 요청을 무료로 쓸 수 있습니다.
1,000 요청이 얼마나 될까요? 생각보다 많습니다.
Gemini CLI에서는 메시지 하나를 보낼 때마다 요청 1회가 소모됩니다. 아무리 긴 파일을 붙여 넣어도, 아무리 복잡한 질문을 해도 한 번에 하나입니다. 짧은 질문 여러 개로 쪼개는 것보다 하나의 잘 다듬어진 질문으로 보내는 게 더 효율적인 이유이기도 합니다.
일반적인 하루 업무 흐름을 생각해보면, 글 다듬기, 이메일 초안 작성, 아이디어 정리 같은 작업을 하루 종일 하더라도 수십 회 정도입니다. 1,000 요청에 도달하기가 쉽지 않죠. 물론 코딩 에이전트로 대규모 리팩터링을 진행한다면 이야기가 달라지지만, 일반 사용자라면 무료 한도로 충분히 쓸 수 있습니다.
현재 지원되는 Gemini 모델의 컨텍스트 윈도우는 100만 토큰에 달합니다. 비교적 긴 문서나 파일을 통째로 넣고 질문해도 잘 처리해요. 300만 줄짜리 레거시 코드를 단일 대화로 분석했다는 사례도 있을 정도입니다.
Gemini CLI vs Claude Code — 무료와 유료의 체감 차이
이 부분이 아마 가장 궁금하실 겁니다.
두 도구의 가장 큰 차이는 비용 구조입니다.
- Gemini CLI: 개인 Google 계정만 있으면 하루 1,000 요청을 무료로 사용 가능
- Claude Code: 무료 플랜이 없고, 터미널 에이전트를 쓰려면 월 $20의 Pro 플랜 이상이 필요합니다. 정확한 현재 가격은 공식 페이지에서 확인하는 것을 권장합니다.
코드 품질 면에서는 사용자들 사이에서 Claude Code가 전반적으로 더 높은 평가를 받고 있습니다. 특히 여러 파일에 걸친 복잡한 리팩터링에서 더 믿음직스럽다는 후기가 많습니다.
작동 방식에서도 체감 차이가 있습니다. Claude Code는 모르는 게 있으면 "이 파일을 찾지 못했습니다, 경로를 알려주시겠어요?" 하고 물어보는 반면, Gemini CLI는 맥락을 추측해서 일단 진행하는 경향이 있습니다. 추측이 맞으면 편하지만, 틀렸을 때 수정 비용이 생깁니다.
UI 측면에서도 차이가 있습니다. Claude Code는 각 단계를 하나씩 나열해서 보여주고, Gemini CLI는 여러 액션을 한 박스 안에 묶어서 요약합니다. Claude Code 쪽이 읽기 편하다는 평이 많고, 저도 비슷하게 느꼈습니다.
반면 Gemini CLI가 확실히 앞서는 점도 있습니다. 100만 토큰 컨텍스트 윈도우 덕분에, 덩치 큰 프로젝트 전체를 한 번에 읽고 분석할 수 있습니다. Google Cloud, BigQuery 같은 구글 생태계와의 연동도 자연스러운 편입니다.
비전공자 입장에서 솔직하게 정리하면, 코딩이 주목적이 아닌 일반 사용자라면 Gemini CLI의 무료 티어로도 충분히 만족스럽습니다. Claude Code의 세밀함이 빛을 발하는 건 대규모 코드베이스를 다룰 때인데, 그 상황이 아니라면 유료 전환의 필요성이 잘 느껴지지 않습니다.
이런 분께 추천, 이런 분께는 비추천
Gemini CLI가 잘 맞는 경우입니다.
- Google 계정은 있고, 비용 없이 터미널 AI 에이전트를 경험해보고 싶은 분
- 코딩보다는 파일 분석, 글쓰기 보조, 아이디어 정리 등 일반 작업이 주목적인 분
- 구글 서비스와 연동해서 쓰고 싶은 분
- 오픈소스 특성상 소스코드를 직접 확인하고 싶은 분
반면 이런 경우라면 처음부터 Claude Code를 고려하거나, 최소한 병행 사용을 생각해볼 만합니다.
- 매일 프로덕션 코드를 작성하고, 코드 품질 신뢰도가 중요한 분
- 여러 파일에 걸친 복잡한 리팩터링을 자주 하는 분
- 에이전트가 중간에 막혔을 때 알아서 수정해주는 자율성을 원하는 분
터미널 AI 에이전트 입문으로는 Gemini CLI가 현실적으로 좋은 선택지입니다. 설치도 간단하고, 비용 부담 없이 실제로 써보면서 이 분야가 나한테 필요한지 가늠할 수 있으니까요. 어차피 마음에 안 들면 지우면 그만이고, 마음에 들면 그때 Claude Code를 비교해봐도 늦지 않습니다.
