✨💻🚀Gemini CLI: Gemini 2.5 Pro를 터미널에서 무료로 만나세요

안녕하세요! 오늘은 구글이 새롭게 공개한 오픈 소스 AI 에이전트, Gemini CLI에 대해 알아보겠습니다. 이 도구는 강력한 Gemini 모델의 기능을 개발자의 터미널에 직접 가져와, 단순한 코드 보조를 넘어 다중 모드 입력 처리, 광범위한 코드베이스 이해, 워크플로우 자동화 등 다양한 고급 기능을 지원하는 것이 특징입니다. 특히 Gemini CLI는 무료로 이용할 수 있을 뿐만 아니라 개인 Google 계정만 있으면 업계 최대 수준의 요청 한도와 1백만 토큰 컨텍스트 창에 접근할 수 있어 개발자들의 큰 주목을 받고 있습니다. 이번 블로그에서는 Gemini CLI의 개요부터 주요 특징, 설치 및 사용 방법, 실제 테스트 사례까지 살펴보며, 터미널 환경에서 AI가 어떻게 개발 경험을 혁신하는지 알아보겠습니다.

✨💻🚀Gemini CLI: Gemini 2.5 Pro를 터미널에서 무료로 만나세요

 

 

 

 

1. Gemini CLI 개요

Gemini CLI는 구글의 강력한 AI 모델인 Gemini의 기능을 개발자의 터미널로 직접 가져오는 오픈 소스 AI 에이전트입니다. 이 도구는 개발자 경험을 향상시키기 위해 설계되었으며, 코딩, 문제 해결, 작업 관리 등 다양한 작업에 활용될 수 있는 다재다능한 유틸리티입니다. 개인 사용자에게는 전례 없는 접근성을 제공하며, 무료로 이용할 수 있습니다.

 

Gemini CLI는 Gemini Code Assist와 기술을 공유하여, 개발자들이 VS Code와 Gemini CLI 모두에서 AI 기반 코딩 지원을 받을 수 있도록 합니다. 이는 개발자에게 프롬프트 기반의 AI 우선 코딩 경험을 제공하며, 터미널을 통해 모델에 가장 직접적으로 접근할 수 있는 경로를 제공합니다.

https://blog.google/technology/developers/introducing-gemini-cli-open-source-ai-agent/

Gemini CLI: your open-source AI agent

728x90

2. Gemini CLI 특징 및 주요 기능

Gemini CLI는 터미널 경험을 근본적으로 업그레이드할 수 있는 강력한 AI 기능을 제공합니다.

• 광범위한 코드 이해 및 조작: Gemini CLI는 Gemini의 1백만 토큰 컨텍스트 창을 넘어선 대규모 코드베이스를 쿼리하고 편집할 수 있습니다. 코드 이해, 파일 조작, 명령 실행 및 동적 문제 해결과 같은 강력한 AI 기능을 제공하여 자연어로 코드를 작성하고, 문제를 디버그하며, 워크플로우를 간소화할 수 있도록 돕습니다.
• 다중 모드 기능: PDF나 스케치로부터 새로운 애플리케이션을 생성하는 등 Gemini의 다중 모드 기능을 활용할 수 있습니다. 이는 텍스트뿐만 아니라 다양한 형태의 입력 데이터를 이해하고 처리할 수 있음을 의미합니다.
• 워크플로우 자동화: 풀 리퀘스트 쿼리 또는 복잡한 리베이스 처리와 같은 운영 작업을 자동화할 수 있습니다. 또한, MCP(Model Context Protocol) 서버를 사용하여 Imagen, Veo 또는 Lyria와 같은 도구와 새로운 기능을 연결하여 미디어 생성까지 가능하게 합니다.

네이버 검색 MCP 서버 실행결과

• Google 검색 통합: Gemini에 내장된 Google 검색 도구를 사용하여 쿼리에 실시간 외부 컨텍스트를 제공하고 웹 페이지를 가져와 프롬프트의 정확성을 높일 수 있습니다.

Gemini CLI의 Google 검색 도구

• 확장성 및 맞춤화: Gemini CLI는 완전히 오픈 소스(Apache 2.0 라이선스)로 제공되어, 개발자들이 코드를 검사하고 보안 영향을 확인할 수 있습니다. 버그 보고, 기능 제안, 보안 관행 개선 및 코드 개선 사항 제출을 통해 글로벌 개발자 커뮤니티가 이 프로젝트에 기여하는 것이 환영됩니다. 또한, MCP, 시스템 프롬프트(GEMINI.md를 통해), 개인 및 팀 구성 설정을 포함한 최신 표준을 기반으로 구축되어 확장성이 뛰어나며, 특정 요구와 워크플로우에 맞게 Gemini를 맞춤 설정할 수 있습니다.

https://github.com/google-gemini/gemini-cli

GitHub - google-gemini/gemini-cli: An open-source AI agent that brings the power of Gemini directly into your terminal.

GEMINI.md 파일(한국어 응답 시스템 프롬프트)

• 파격적인 사용 제한: 개인 Google 계정으로 로그인하면 무료 Gemini Code Assist 라이선스를 통해 Gemini CLI를 무료로 사용할 수 있습니다. 이 무료 라이선스는 Gemini 2.5 Pro 및 1백만 토큰 컨텍스트 창에 대한 접근 권한을 제공하며, 분당 60개의 모델 요청과 일일 1,000개의 모델 요청이라는 업계 최대의 무료 허용량을 제공하여 거의 사용 제한에 부딪히지 않도록 보장합니다. 더 높은 요청 용량이 필요하거나 특정 모델을 사용하려는 전문 개발자는 Google AI Studio 또는 Vertex AI 키를 사용하여 사용량 기반 요금을 지불하거나 Gemini Code Assist Standard 또는 Enterprise 라이선스를 얻을 수 있습니다.

Gemini CLI 입출력 토큰 사용현황

• Gemini Code Assist와의 시너지: Gemini Code Assist는 VS Code에서 에이전트 모드를 통해 강력한 AI 기능을 제공하며, 테스트 작성, 오류 수정, 기능 구축, 코드 마이그레이션 등 다양한 작업을 수행합니다. 이 에이전트는 다단계 계획을 구축하고, 실패한 구현 경로에서 자동 복구하며, 예상치 못한 솔루션을 추천합니다. Gemini CLI와 Gemini Code Assist는 동일한 기술을 공유하므로, 터미널과 IDE 환경 모두에서 일관된 AI 지원을 받을 수 있습니다.

Windsurf에서 실행한 Gemini Code Assist와 Gemini CLI

 

 

 

 

3. Gemini CLI 사용 방법

Gemini CLI를 시작하는 것은 매우 간단합니다.

1) 사전 준비: Node.js 버전 18 이상이 설치되어 있는지 확인해야 합니다.

2) CLI 실행 또는 설치: 터미널에서 다음 명령어를 실행하여 CLI를 바로 실행할 수 있습니다: 

npx https://github.com/google-gemini/gemini-cli

Gemini CLI 설치화면

또는 아래 명령어를 통해 전역적으로 설치할 수도 있습니다:

npm install -g @google/gemini-cli

Gemini CLI 전역 설치

3) 인증: 프롬프트가 나타나면 개인 Google 계정으로 로그인합니다. 이렇게 하면 분당 최대 60회, 일일 1,000회 모델 요청 권한이 부여됩니다. 

Gemini CLI(Code Assis)의 구글 계정 연동

고급 사용 또는 더 높은 사용 한도가 필요한 경우, API 키를 사용할 수 있습니다.

1. Google AI Studio에서 키를 생성합니다.
2. 터미널에 환경 변수로 설정하거나, /auth 명령어로 설정할 수 있습니다. 

export GEMINI_API_KEY="YOUR_API_KEY"

Gemini CLI /auth 명령어 실행화면

Gemini CLI 실행 최초에는 Gemini 2.5 Pro 모델이 선택되지만 응답이 느려지는 경우 Gemini 2.5 Flash 모델로 자동전환 됩니다. 

Gemini 2.5 Flash 모델 자동전환 메시지

4. Gemini CLI 테스트

다음은 Gemini CLI의 성능을 테스트해 보겠습니다. 테스트는 윈도우11 WSL과 Windsurf 터미널에서 이전 단계의 설치방법으로 Gemini CLI를 설치하여 스크립트 및 애니메이션, 시뮬레이터 생성, MCP 서버 구성을 테스트 하였습니다.

Gemini CLI 실행 초기화면

• 구면 내에서 튀는 100개의 노란색 공 생성 스크립트:  Gemini CLI는 천천히 회전하는 구 내에서 노란색 공이 머무르면서 충돌 감지를 처리하는 스크립트를 p5.js로 구현하는 데 성공하였습니다. 다음 링크를 클릭하시면 스크립트 실행결과를 보실 수 있습니다. https://yellow-ball-rg3270.windsurf.build/

Windsurf 터미널에서 Gemini CLI 실행

구면 내에서 튀는 100개의 노란색 공 생성 스크립트 실행결과

• 3D 인터랙티브 태양계 애니메이션: 사용자가 자유롭게 확대, 축소, 회전하며 탐색할 수 있는 태양계를 만들고, 각 행성의 공전 애니메이션을 구현하도록 요청한 결과, Gemini CLI는 한 번에 성공하지 못했으나, 몇 번의 피드백과 에러 수정을 통해 아래와 같이 구현에 성공하였습니다. https://solar-system-rg3270.windsurf.build 에서 결과를 확인하실 수 있습니다.

3D 인터랙티브 태양계 애니메이션 html 실행

 

Gemini CLI가 구현한 3D 인터랙티브 태양계 애니메이션

• Rubik's 큐브 시뮬레이터: 크기 조정이 가능한 정육면체 큐브의 색을 섞은 후, 전체 면의 색을 다시 맞추는 시뮬레이터 구현에서는 Gemini CLI는 큐브의 각 면을 생성하는 기본 기능은 성공하였지만 회전과 색상전환을 완전하게 구현하지 못하였습니다. https://cube-simulator-rg3270.windsurf.build/

 

Gemini CLI가 구현한 Rubik's 큐브 시뮬레이터

모델명, 시스템 프롬프트, 응답 길이 제한 등 Gemini CLI의 환경설정 방법에 대한 자세한 내용은 아래 링크를 참고하세요.

https://github.com/google-gemini/gemini-cli/blob/main/docs/cli/configuration.md

gemini-cli/docs/cli/configuration.md at main · google-gemini/gemini-cli

• 네이버 검색 MCP 서버 연동: Naver-search-mcp MCP 서버는 네이버의 웹문서, 뉴스, 쇼핑, 이미지, 블로그, 지식iN, 전문자료, 책, 백과사전, 지역 등 다양한 검색 서비스를 API 형태로 제공합니다. 사용자가 Gemini CLI를 통해 자연어로 원하는 정보를 입력하면, 해당 카테고리에 맞는 네이버 검색 결과를 빠르게 받아볼 수 있습니다.

~/.gemini/settings.json 파일 네이버 검색 MCP 서버 설정

Gemini CLI 네이버 검색 MCP서버 실행결과

5. 맺음말

Gemini CLI는 오픈 소스 AI 에이전트로서 Gemini의 강력한 기능을 개발자의 터미널에 직접 통합하여 코딩, 문제 해결, 워크플로우 자동화에 혁신을 가져왔습니다. 개인 Google 계정으로 로그인하면 업계 최대의 무료 사용 한도를 제공하는 Gemini 2.5 Pro에 접근할 수 있어, 사실상 무제한으로 AI의 도움을 받을 수 있습니다.

 

개방성과 확장성, 그리고 Gemini Code Assist와의 기술 공유는 Gemini CLI가 더욱 강력한 도구로 발전할 잠재력을 보여줍니다. 여러분도 Gemini CLI를 설치하고 터미널 경험을 업그레이드하세요. 이메일 주소만으로 터미널에서 Gemini의 기능을 무료로 경험하실 수 있습니다. 그럼 저는 다음 시간에 더 유익한 정보를 가지고 다시 찾아뵙겠습니다. 감사합니다!

 

https://fornewchallenge.tistory.com/

 

 

2024.05.31 - [AI 언어 모델] - 🌟코딩 혁신: Codestral - 미스트랄이 만든 AI 코드 생성 끝판왕!🚀

🌟코딩 혁신: Codestral - 미스트랄이 만든 AI 코드 생성 끝판왕!🚀