안녕하세요,
최근 AI 기술의 발전으로 인해 코딩은 더 이상 전문 개발자만의 영역이 아닙니다. 그 중심에는 AI 에이전트 기반 자동화 도구, 특히 구글이 새롭게 공개한 무료 AI 코드 생성 도구 "Gemini CLI"가 있습니다. Gemini CLI는 자연어로 명령만 입력하면, 코드 작성, 파일 수정, 셸 명령 실행 등 복잡한 개발 작업을 AI가 자동으로 처리해주는 오픈소스 AI 에이전트입니다. 기존에는 유료 플랫폼에서만 사용 가능했던 기능을, 이제 누구나 무료로 체험할 수 있게 된 것입니다.
이번 포스팅에서는 Google이 공개한 AI 개발 도구 Gemini CLI의 특징과 사용법에 대해 자세히 알아보겠습니다.
Gemini CLI란
Gemini CLI는 구글이 개발한 오픈소스 AI 에이전트로, 명령줄 터미널 환경에서 바로 사용할 수 있도록 설계되었습니다. 이 도구는 자연어 프롬프트를 통해 코드 작성, 디버깅, 콘텐츠 생성, 리서치 등 다양한 작업을 수행할 수 있으며, 개발자의 워크플로우를 보다 효율적으로 만들어 줍니다.
기반 모델로는 Gemini 2.5 Pro가 사용되며, 최대 100만 토큰의 컨텍스트 윈도우를 처리할 수 있는 고성능 AI 모델을 탑재하고 있습니다. 또한, Apache 2.0 라이선스를 적용한 완전한 오픈소스 프로젝트로 누구나 자유롭게 소스를 확인하고, 기능을 기여하거나 확장할 수 있는 것이 특징입니다.
주요 특징
- 풍부한 무료 사용량 : 개인 구글 계정만으로 Gemini 2.5 Pro 모델을 무료로 사용할 수 있으며, 분당 60회 / 하루 1,000회 요청이라는 높은 무료 사용 한도를 제공합니다.
- 터미널 기반 AI 비서 : 터미널에서 코드 생성, 파일 조작, 셸 명령 실행, 리팩토링 등 다양한 작업을 자연어로 처리하며, 복잡한 멀티스텝 작업도 수행할 수 있습니다.
- 실시간 웹 검색 통합 : Google Search와 연동되어 최신 웹 정보를 AI 응답에 반영하며, 프롬프트에 따라 실시간 정보 기반 도움을 받을 수 있습니다.
- 높은 커스터마이징 및 확장성 : GEMINI.md 파일로 맞춤형 시스템 프롬프트를 설정할 수 있고, MCP 표준 및 플러그인 구조를 통해 외부 서비스와 유연하게 연동 가능합니다.
- VS Code 연동 : Gemini CLI는 Gemini Code Assist와 동일한 엔진을 사용하며, VS Code 내에서도 동일한 AI 지원 경험을 제공합니다.
요금 및 사용량 안내
Gemini CLI는 개인 Google 계정만 있으면 누구나 무료로 사용할 수 있으며, 다음과 같은 공식 쿼터(요청 제한)가 적용됩니다. 분당 최대 60회, 하루 최대 1,000회의 요청이 가능한 업계 최고 수준의 무료 사용량을 제공하며, 추가 사용량이 필요한 경우에는 API 키 등록 또는 상위 라이선스를 통해 확장할 수 있습니다.
[기본 무료 사용량 (Gemini 2.5 Pro 기준)]
| 구분 | 사용량 한도 | 비고 |
| 분당 | 최대 60회 요청 | 무료, 개인 Google 계정 기준 |
| 일일 | 최대 1,000회 요청 | 무료, 개인 Google 계정 기준 |
| 컨텍스트 | 최대 100만 토큰 | Gemini 2.5 Pro 모델 기준 |
※ 이 사용량은 Gemini Code Assist(VS Code 연동 기능)과도 공유됩니다.
라이선스
Gemini CLI는 Apache 2.0 라이선스를 적용한 오픈소스 프로젝트로, 상업적 사용이 자유롭게 허용됩니다. 누구나 별도의 제약 없이 이 도구를 개인, 기업, 상업적 프로젝트에 활용하거나 수정 및 배포할 수 있습니다. 또한, 소스 코드에 대한 접근과 수정이 가능해 자체 서비스나 제품에 맞게 커스터마이징할 수 있습니다. 복잡한 라이선스 조건 없이 기업 환경에서도 안심하고 도입할 수 있는 것이 큰 장점입니다.
Gemini CLI의 사용 방식
Gemini CLI는 Google Gemini API를 호출하는 클라우드 기반 도구로, 로컬 터미널에서 실행되지만 실제 처리는 Google 서버에서 이루어집니다. 사용 방식은 크게 설치 없이 일시적으로 실행하는 방식과 로컬 또는 전역에 설치하여 사용하는 방식으로 나뉩니다. 이 글에서는 이러한 두 가지 터미널 기반 사용 방법을 순서대로 소개합니다.
[사전 준비 사항]
- 터미널에서 사용하는 방식 : Node.js 18 버전 이상이 설치되어 있어야 합니다.
👉 Node.js 공식 다운로드 : https://nodejs.org/en/download/current
1. 설치 없이 일시적으로 실행하는 방식
아래 명령어를 통해 Gemini CLI를 설치 없이 즉시 실행할 수 있습니다. 이 방식은 일시 실행 방식으로, 종료 시 일부 캐시만 남고 나머지 데이터는 삭제됩니다. 간단히 테스트하거나 가볍게 사용해볼 때 적합한 방법입니다.
# Windows PowerShell
npx https://github.com/google-gemini/gemini-cli
실행이 성공하면 Gemini CLI의 첫 화면이 나타납니다. 처음에는 테마를 선택하는 화면이 나타나며, 이후에도 언제든지 변경할 수 있습니다. 테마를 선택하면 이어서 인증 방식 선택 단계로 넘어갑니다.
- 구글 계정으로 로그인
- Gemini API 키 등록
- Vertex AI 연동
이 중에서 가장 간단한 방법인 "구글 계정 로그인" 방식으로 진행해보겠습니다. 아래는 위 과정을 캡처한 이미지입니다.
Gemini CLI 실행이 완료되면, GPT처럼 프롬프트 입력창이 나타납니다. 여기에 원하는 내용을 입력하면, 코드 생성이나 질문 응답 등 다양한 작업을 수행할 수 있습니다. 겉으로 보기에는 일반적인 LLM과 비슷해 보일 수 있지만, Gemini CLI는 로컬 환경에 직접 접근이 가능하다는 점에서 차별화됩니다. 예를 들어, 명령어를 통해 특정 경로의 파일 목록을 조회하거나, 해당 파일을 실행할 수 있습니다.
또한, 파일 수정 요청도 가능합니다. 예를 들어, "Hello"라는 문장이 포함된 HTML 파일을 픽셀아트처럼 보이도록 수정해달라는 프롬프트를 입력하면, Gemini CLI는 해당 요청을 분석하고 작업을 준비합니다. 이때 Gemini CLI의 중요한 특징이 나타납니다. 바로, AI가 사용자의 파일을 곧바로 수정하지 않고 반드시 사전 승인을 요청한다는 점입니다. AI는 수행할 작업의 내용을 요약해 보여주고, “이렇게 수정해도 괜찮을까요?” 라고 사용자에게 확인을 구합니다. 사용자가 승인하면 그제서야 실제 파일 수정 작업이 실행됩니다. 아래는 이 과정과 수정 결과를 캡처한 이미지입니다.
Gemini CLI를 종료하면, 지금까지 사용한 요청 횟수, 토큰 수, 소요 시간 등의 요약 정보를 확인할 수 있습니다.
2. 로컬 또는 전역에 설치하여 사용하는 방식
첫 번째 방식이 설치 없이 일시적으로 사용하는 방법이라면, 이번에는 Gemini CLI를 로컬 또는 전역 환경에 설치하여 지속적으로 사용할 수 있는 방법을 소개합니다. 아래 명령어를 통해 설치한 후에는 gemini 명령어로 언제든지 실행할 수 있습니다.
# Windows PowerShell
# (선택 1)
npm install -g @google/gemini-cli # 전역(Global) 환경에 설치
gemini # CLI 실행
# (선택 2)
npm install @google/gemini-cli # 현재 디렉토리에 로컬 설치
npx gemini # CLI 실행 (반드시 설치된 디렉토리에서 실행해야 함)
이번 포스팅에서는 (선택 2) 로컬 설치 방식으로 진행해보겠습니다. 아래와 같이 원하는 경로에 설치되며, 나머지 사용 과정은 앞서 살펴본 방법과 동일합니다.
Gemini CLI를 특정 디렉토리에 로컬로 설치한 경우, 해당 디렉토리 내에서는 정상적으로 동작하지만, 다른 디렉토리로 이동하면 실행이 되지 않거나 일부 기능이 제한될 수 있습니다. 간단한 테스트 결과, 다른 경로에 폴더를 생성하는 작업은 성공했지만, 외부 경로의 이미지 파일을 불러오는 작업은 실패하는 경우가 있었습니다. 여러 경로에서 제약 없이 자유롭게 사용하고 싶다면, 전역(Global) 설치 방식을 사용하는 것을 권장드립니다.
지금까지 Gemini CLI의 개요와 사용 방식에 대해 살펴보았습니다. Gemini CLI는 설치 없이 간편하게 실행할 수 있는 npx 방식부터, 지속적으로 활용할 수 있는 설치형 방식까지 다양한 사용 옵션을 제공합니다. 무엇보다 중요한 점은, Gemini CLI는 단순히 텍스트를 생성하는 일반적인 LLM이 아니라, 프롬프트를 이해하고 직접 행동하는 AI 에이전트라는 점입니다. 로컬 파일 시스템에 접근하고, 셸 명령어를 실행하며, 사용자와의 대화를 통해 작업을 계획하고 실행하는 능력은 기존의 LLM 도구들과 확실히 차별화되는 강력한 기능입니다.
또한, Gemini CLI는 MCP 서버와의 연동도 지원하므로, 다음 포스팅에서는 이를 활용한 고급 자동화와 통합 방식에 대해 다뤄보겠습니다.
읽어주셔서 감사합니다. 😊
