Gemini CLI: 소개
Gemini CLI v0.65.0은 터미널에서 제미니 모델과 연동하여 코드 조작, 파일 연산, MCP 서버 확장 기능을 제공하는 오픈소스 AI 에이전트입니다.
마지막 업데이트
메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

터미널 환경에서 개발 작업을 진행하다 보면 브라우저를 오가며 프롬프트를 입력하거나 복잡한 API 키를 설정하는 과정이 번거롭게 느껴질 때가 많아요. 이번 글에서는 공식 문서와 릴리스 정보를 바탕으로 터미널에서 제미니 모델을 직접 활용할 수 있는 오픈소스 AI 에이전트인 Gemini CLI의 주요 특징과 활용법을 자세히 살펴볼게요. 본 포스팅은 직접 실습을 수행한 후기가 아니라 공식 문서와 릴리스 노트를 토대로 작성된 문서 기반 가이드이므로, 실제 도입 전 최신 공식 안내를 꼭 확인해 주세요.
이 글은 Gemini CLI v0.65.0 공식 릴리스를 다뤄요. 공식 릴리스 기록의 공개일은 2026-10-20(UTC)이고, 자료 확인일은 2026-10-21이에요.
터미널에서 어떤 작업을 도와주나요?
Gemini CLI는 개발자가 명령줄 인터페이스에서 떠나지 않고도 모델과 대화하며 다양한 작업을 처리할 수 있도록 돕는 오픈소스 AI 에이전트예요 F1. 터미널 창을 벗어나지 않고도 코드 작성, 파일 탐색, 셸 명령어 실행 등을 일관되게 수행할 수 있는 것이 가장 큰 특징이에요 D2. 터미널 중심의 작업 흐름을 선호하는 개발자라면 자연스럽게 기존 개발 파이프라인에 녹여낼 수 있어요. 특히 복잡한 웹 UI를 거치지 않고 프롬프트에서 곧바로 모델의 응답을 받아볼 수 있어 작업의 집중도를 높여주는 장점이 있답니다.
이 제품은 AI 기능을 가진 앱이면서 CLI와 MCP를 통한 에이전트 작업을 지원해요. 이 사실만으로 앱 자체가 AI로 얼마나 개발됐는지는 알 수 없어요. 이번에 확보한 자료로 그 개발 과정까지 확정하지는 않았어요.
무료 티어와 모델 비용은 어떻게 다른가요?
이 툴은 개인용 구글 계정을 사용하는 경우 분당 60회, 하루 1,000회 요청이 가능한 무료 티어(Free tier)를 제공해요 F3. README에는 Gemini 3 모델과 1M 토큰 컨텍스트 윈도우가 안내돼 있어요 D2. 다만 공개 상태와 이용 조건은 계정 유형이나 사용하는 API 키의 정책에 따라 달라질 수 있으므로, 상용 환경이나 기업용 계정에서는 별도의 인증 가이드와 요금제를 확인하는 과정이 필요해요 D2. 오픈소스 Apache 2.0 라이선스를 따르지만 모든 클라우드 모델 호출이나 인프라 비용이 무료인 것은 아니라는 점도 유의해 주세요.
연결 도구와 코드 구조 파악은 구분해 봐요
공식 README에는 로컬 파일 시스템 연산과 셸 명령어 실행, 구글 검색 그라운딩 기능이 기본 도구로 안내돼 있어요 D2. 또한 MCP(Model Context Protocol) 서버를 통한 확장 기능을 지원하여 사용자가 필요한 도구를 직접 붙여 쓸 수 있어요 D2. 반면, 프로젝트 전체의 구조를 자동으로 지도처럼 정리한다고 설명하는 Aider와 비교할 때는 F8, Gemini CLI의 파일·셸 도구와 MCP 연결 방식도 함께 확인해 보면 좋아요 D2. 두 툴 모두 터미널 환경을 지원하지만, 툴마다 확장 방식이나 작업 범위에서 차이가 있으므로 본인의 프로젝트 규모에 맞춰 선택하는 것이 좋아요.
실행 방식과 릴리스 채널을 확인해요
확인된 기능으로는 현재 디렉터리 기반 실행 F4, 특정 모델 지정 실행 D2, 다중 디렉터리 포함 기능 D2, 그리고 스크립트 자동화를 위한 비인터랙티브 모드가 있어요 F7. 비인터랙티브 모드에서는 -p 플래그를 통해 스크립트 내에서 곧바로 프롬프트를 실행할 수 있어요 F7. 미확인 사항이나 주의할 점으로는 매주 화요일에 배포되는 프리뷰(Preview) 릴리스의 경우 충분한 검증을 거치지 않아 회귀 버그나 예기치 않은 이슈가 포함되어 있을 수 있다는 점이에요 F5. 따라서 안정적인 운영 환경에서는 프리뷰 태그 대신 안정 버전이나 정식 릴리스 채널을 선택하는 것이 안전해요 D2.
코드 구조 설명을 파일로 남기는 작업이에요
문서 기반으로 간단한 코드베이스 분석 작업을 수행하는 시나리오를 살펴볼게요. 공식 설치 예시는 npm/npx, macOS/Linux의 Homebrew, macOS의 MacPorts를 포함해요. 여기서는 모든 운영체제의 설치를 직접 확인하지 않았어요. 먼저 사전 요구 사항으로 Node.js 환경과 툴 설치가 필요하며, 개인 구글 계정으로 로그인하거나 API 키를 설정해야 해요 D2.
예시 입력
gemini -p "Explain the architecture of this codebase."
예상 결과
제미니 모델이 코드베이스의 디렉터리 구조와 주요 모듈 간의 관계를 분석하여 터미널 표준 출력으로 요약된 아키텍처 설명을 반환해요. 구조화된 데이터가 필요한 경우 --output-format json 플래그를 추가하여 JSON 형식으로 결과를 받아볼 수도 있어요 F7. 터미널 출력을 파일로 저장하려면 다음과 같이 셸 리디렉션을 사용할 수 있어요.
gemini -p "Explain the architecture of this codebase" --output-format json > architecture.json
이때 생성된 architecture.json은 네이티브 프로젝트 내보내기 파일이 아니라 사용자가 셸 리디렉션을 통해 명시적으로 생성한 임시 터미널 출력 파일임을 구분해야 해요. 저장된 파일을 확인하고 다시 열어보려면 일반적인 텍스트 에디터나 명령어(cat architecture.json 등)를 사용해 내용을 점검하면 돼요. 완료 조건은 architecture.json 파일이 정상적으로 생성되어 내부의 JSON 구조가 깨지지 않고 파싱 가능한 상태로 열리는지 확인하는 것이에요 F7.
문제가 생기면 어떤 자료를 확인하나요?
문제 해결 및 트러블슈팅 측면에서, 최근 릴리스인 v0.65.0 버전에서는 신뢰할 수 없는 폴더에서 작업할 때 워크스페이스 설정을 읽기 전용으로 강제하는 보안 수정 사항이 반영되었어요 F2. 이 변경의 범위는 워크스페이스 설정이고, 모든 파일의 쓰기를 막는다고 확인한 것은 아니에요. 만약 권한 관련 오류나 예상치 못한 세션 종료 문제가 발생한다면 최신 버전으로 업데이트 상태를 점검하고 신뢰할 수 있는 폴더 설정이 올바르게 적용되었는지 확인해 주세요. 공식 문서와 릴리스 노트를 꾸준히 참고하면서 본인의 개발 스타일에 맞는 최적의 터미널 AI 에이전트 활용법을 찾아보세요.
BumbleV가 만든 자료 안내 그림이며 실제 앱 화면이나 실행 결과가 아니에요. 그림의 근거가 된 공식 발표 · CC BY 4.0 · 2026-10-21

참고 자료
- https://github.com/google-gemini/gemini-cli/releases/tag/v0.65.0
- https://raw.githubusercontent.com/google-gemini/gemini-cli/6006c14a4decfe4b891c6263ad6ad5992e404b5b/README.md
- https://raw.githubusercontent.com/Aider-AI/aider/5dc9490bb35f9729ef2c95d00a19ccd30c26339c/README.md
- https://api.github.com/repos/google-gemini/gemini-cli