google-gemini/gemini-cli

An open-source AI agent that brings the power of Gemini directly into your terminal.

Gemini CLI – AI 기반 명령줄 도우미

정의 – Google이 유지 관리하는 오픈소스 명령줄 도구로, 터미널에서 직접 Gemini 계열 대규모 언어 모델과 대화할 수 있게 해줍니다. 코드를 읽고, 편집하고, 생성하고, 셸 명령을 실행하고, 웹 데이터를 가져오고, Google의 Vertex AI 및 기타 서비스와 통합할 수 있는 AI 에이전트 역할을 합니다.

주요 기능

코드 이해 및 생성 – Gemini의 멀티모달 모델을 사용하여 변경 사항 요약, 디버그, 또는 전체 애플리케이션 생성(PDF, 이미지, 스케치에서도 가능)을 수행합니다.
자동화 – 풀 리퀘스트 조회, 리베이스 수행, 스크립트 실행, 또는 미디어 생성, Slack 메시지, 데이터베이스 쿼리 등을 위한 사용자 지정 MCP(모델 연결 프로그램) 서버 호출이 가능합니다.
유연한 인증 – Google OAuth, Gemini API 키, 또는 엔터프라이즈 워크로드를 위한 Vertex AI 자격 증명을 지원합니다.
스크립팅 및 헤드리스 모드 – 비대화형 -p 플래그와 JSON/스트림 JSON 출력으로 CI 파이프라인에 쉽게 통합할 수 있습니다.
확장 가능한 도구 – 내장 파일 시스템, 셸, 웹 가져오기 도구; GEMINI.md를 통한 사용자 지정 명령; 특정 기능을 위한 플러그인 MCP 서버.
IDE 통합 및 샌드박싱 – VS Code 동반 앱, 토큰 캐싱, 체크포인팅, 안전한 실행을 위한 신뢰할 수 있는 폴더 정책.

설치 (하나 선택)

# 일회성 실행
npx @google/gemini-cli

# 전역 npm 설치
npm install -g @google/gemini-cli

# Homebrew (macOS/Linux)
brew install gemini-cli

다른 옵션으로는 MacPorts와 제한된 시스템을 위한 Anaconda 기반 환경이 있습니다.

시작하기

# 현재 폴더에서 시작 (대화형 REPL)
gemini

# 단일 프롬프트를 비대화형으로 실행
 gemini -p "이 코드베이스의 아키텍처를 설명하세요"

# 스크립트용 구조화된 출력
 gemini -p "모든 함수 나열" --output-format json

--include-directories로 범위를 제한하고, -m gemini-2.5-flash로 모델을 선택하고, --output-format stream-json으로 이벤트를 스트리밍할 수 있습니다.

인증 옵션

Google OAuth – Google 계정으로 로그인합니다(유료 Code Assist 라이선스에 필요). 필요한 경우 GOOGLE_CLOUD_PROJECT를 설정합니다.
Gemini API 키 – GEMINI_API_KEY를 내보내 직접 모델 선택 및 사용량 기반 과금을 합니다.
Vertex AI – GOOGLE_API_KEY를 내보내고 GOOGLE_GENAI_USE_VERTEXAI=true를 설정하여 엔터프라이즈급 보안, 더 높은 속도 제한, 원활한 GCP 통합을 제공합니다.

일반적인 워크플로우

REPL 시작 – gemini는 현재 디렉토리를 컨텍스트로 자동 로드하는 대화형 채팅을 엽니다.
코드 요청 – 예: FAQ.md를 사용하여 질문에 답하는 Discord 봇을 작성하세요.
반복 – 슬래시 명령(/help, /chat, /bug) 또는 GEMINI.md에 정의된 사용자 지정 명령을 사용합니다.
자동화 – JSON 출력을 사용하여 결과를 프로그래밍 방식으로 파싱하고 CI 스크립트에 호출을 포함합니다.

도구 확장

GEMINI.md 파일을 통해 사용자 지정 명령을 추가합니다.
~/.gemini/settings.json에 MCP 서버를 등록하여 새 도구(Slack, 데이터베이스 등)를 노출합니다.
사용자 지정 확장 아래에 링크된 문서에 따라 확장을 빌드하고 공유합니다.

커뮤니티 및 지원

Apache 2.0에 따라 오픈소스입니다. 풀 리퀘스트를 통한 기여를 환영합니다.
문서 사이트: https://www.geminicli.com/docs
이슈 트래커, 로드맵, 보안 정책은 모두 GitHub에서 호스팅됩니다.
DeepLearning.AI를 통해 무료 입문 과정을 이용할 수 있습니다.

상태 참고 – Gemini CLI는 최신 Gemini 4 Argon 모델에 최적화되어 있지 않습니다. Google은 이러한 워크로드에 더 새로운 Antigravity CLI를 사용할 것을 권장합니다.

google-gemini/gemini-cli

Gemini CLI – AI 기반 명령줄 도우미

관련