gemini-cli

참고

무료 티어 및 Google One 사용자: Gemini CLI는 2026년 6월 18일부로 Antigravity CLI로 대체되었습니다. 자세한 내용은 블로그 게시물을 참고하세요.

Gemini CLI는 Gemini 4 Argon에 최적화되지 않았습니다. Gemini 4 Argon을 사용하려면 Antigravity를 사용하세요.

Gemini CLI

참고

Gemini CLI는 최신 Gemini 모델에 최적화되어 있지 않습니다. Gemini 모델로 최고의 코딩 경험을 원하시면 Antigravity CLI를 사용하세요.

Gemini CLI는 Gemini의 성능을 터미널에 직접 제공하는 오픈소스 AI 에이전트입니다. Gemini에 가볍게 접근할 수 있게 해주며, 프롬프트에서 모델까지 가장 직접적인 경로를 제공합니다.

Gemini CLI에 대한 모든 내용은 문서에서 확인하세요.

📦 설치
권장 시스템 사양과 자세한 설치 가이드는 Gemini CLI 설치, 실행 및 릴리스에서 확인하세요.

빠른 설치
npx로 즉시 실행
# npx 사용 (설치 불필요)
npx @google/gemini-cli
npm으로 전역 설치
npm install -g @google/gemini-cli
Homebrew로 전역 설치 (macOS/Linux)
brew install gemini-cli
MacPorts로 전역 설치 (macOS)
sudo port install gemini-cli
Anaconda로 설치 (제한된 환경용)
# 새 환경 생성 및 활성화
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env

# 환경 내에서 npm을 통해 Gemini CLI 전역 설치
npm install -g @google/gemini-cli
릴리스 채널
자세한 내용은 릴리스를 참고하세요.

Preview
새 preview 릴리스는 매주 화요일 UTC 23:59에 게시됩니다. 이 릴리스는 완전히 검증되지 않았으며 회귀나 기타 미해결 문제가 포함될 수 있습니다. 테스트에 참여하시고 preview 태그로 설치해 주세요.

npm install -g @google/gemini-cli@preview
Stable

새 stable 릴리스는 매주 화요일 UTC 20:00에 게시되며, 지난주 preview 릴리스의 전체 프로모션과 버그 수정 및 검증이 포함됩니다. latest 태그를 사용하세요.

npm install -g @google/gemini-cli@latest
Nightly

새 릴리스는 매일 UTC 00:00에 게시됩니다. 릴리스 시점의 main 브랜치의 모든 변경 사항이 포함됩니다. 미완료된 검증과 문제가 있을 수 있다고 가정해야 합니다. nightly 태그를 사용하세요.

npm install -g @google/gemini-cli@nightly
📋 주요 기능
코드 이해 및 생성

대규모 코드베이스 쿼리 및 편집
멀티모달 기능을 사용하여 PDF, 이미지 또는 스케치에서 새 앱 생성
자연어로 문제 디버깅 및 트러블슈팅

자동화 및 통합

pull request 쿼리나 복잡한 rebase 처리 같은 운영 작업 자동화
MCP 서버를 사용하여 Imagen, Veo 또는 Lyria를 통한 미디어 생성 등 새로운 기능 연결
워크플로 자동화를 위해 스크립트에서 비대화형으로 실행

🔐 인증 옵션
필요에 가장 적합한 인증 방법을 선택하세요:

옵션 1: Google로 로그인 (Google 계정을 사용한 OAuth 로그인)
조직의 유료 Code Assist 라이선스를 사용하는 경우 Google Cloud Project를 설정해야 합니다
# Google Cloud Project 설정
export GOOGLE_CLOUD_PROJECT= " YOUR_PROJECT_ID "
gemini
옵션 2: Gemini API 키
✨ 적합한 대상: 특정 모델 제어 또는 유료 티어 액세스가 필요한 개발자

이점:

모델 선택 : 특정 Gemini 모델 선택
사용량 기반 과금 : 필요 시 더 높은 한도로 업그레이드

# https://aistudio.google.com/apikey 에서 키 발급
export GEMINI_API_KEY= " YOUR_API_KEY "
gemini
옵션 3: Vertex AI
✨ 적합한 대상: 엔터프라이즈 팀 및 프로덕션 워크로드

이점:

엔터프라이즈 기능 : 고급 보안 및 규정 준수
확장 가능 : 결제 계정으로 더 높은 속도 한도
통합 : 기존 Google Cloud 인프라와 연동

# Google Cloud Console에서 키 발급
export GOOGLE_API_KEY= " YOUR_API_KEY "
export GOOGLE_GENAI_USE_VERTEXAI=true
gemini
Google Workspace 계정 및 기타 인증 방법은 인증 가이드를 참고하세요.

🚀 시작하기
참고

Gemini CLI는 최신 Gemini 모델에 최적화되어 있지 않습니다. Gemini 모델로 최고의 코딩 경험을 원하시면 Antigravity CLI를 사용하세요.

기본 사용법
현재 디렉터리에서 시작
gemini
여러 디렉터리 포함
gemini --include-directories ../lib,../docs
특정 모델 사용
gemini -m gemini-2.5-flash
스크립트용 비대화형 모드
간단한 텍스트 응답 받기:

gemini -p " Explain the architecture of this codebase "
JSON 파싱 및 오류 처리 방법을 포함한 고급 스크립팅의 경우 --output-format json 플래그를 사용하여 구조화된 출력을 받으세요:

gemini -p " Explain the architecture of this codebase " --output-format json
실시간 이벤트 스트리밍(장시간 실행 작업 모니터링에 유용)의 경우 --output-format stream-json을 사용하여 줄바꿈으로 구분된 JSON 이벤트를 받으세요:

gemini -p " Run tests and deploy " --output-format stream-json
빠른 예제
새 프로젝트 시작
cd new-project/
gemini
> Write me a Discord bot that answers questions using a FAQ.md file I will provide
기존 코드 분석
git clone https://github.com/google-gemini/gemini-cli
cd gemini-cli
gemini
> Give me a summary of all of the changes that went in yesterday
📚 문서
시작하기

빠른 시작 가이드 - 빠르게 시작하고 실행하세요.
인증 설정 - 자세한 인증 구성.
구성 가이드 - 설정 및 사용자 정의.
키보드 단축키 - 생산성 팁.

핵심 기능

명령어 참조 - 모든 슬래시 명령어 ( /help , /chat 등).
사용자 정의 명령어 - 재사용 가능한 나만의 명령어 생성.
컨텍스트 파일 (GEMINI.md) - Gemini CLI에 지속적인 컨텍스트 제공.
체크포인팅 - 대화 저장 및 재개.
토큰 캐싱 - 토큰 사용 최적화.

도구 및 확장

내장 도구 개요

파일 시스템 작업
셸 명령어
웹 가져오기 및 검색

MCP 서버 통합 - 사용자 정의 도구로 확장.
사용자 정의 확장 - 나만의 명령어를 만들고 공유.

고급 주제

헤드리스 모드 (스크립팅) - 자동화된 워크플로에서 Gemini CLI 사용.
IDE 통합 - VS Code 컴패니언.
샌드박싱 및 보안 - 안전한 실행 환경.
신뢰할 수 있는 폴더 - 폴더별 실행 정책 제어.
엔터프라이즈 가이드 - 기업 환경에서 배포 및 관리.
텔레메트리 및 모니터링 - 사용량 추적.
도구 참조 - 내장 도구 개요.
로컬 개발 - 로컬 개발 도구.

문제 해결 및 지원

문제 해결 가이드 - 일반적인 문제 및 해결 방법.
FAQ - 자주 묻는 질문.
CLI에서 직접 문제를 보고하려면 /bug 명령어를 사용하세요.

MCP 서버 사용
~/.gemini/settings.json에서 MCP 서버를 구성하여 사용자 정의 도구로 Gemini CLI를 확장하세요:

> @github List my open pull requests
> @slack Send a summary of today's commits to #dev channel
> @database Run a query to find inactive users

설정 방법은 MCP 서버 통합 가이드를 참고하세요.

🤝 기여
기여를 환영합니다! Gemini CLI는 완전한 오픈소스(Apache 2.0)이며, 커뮤니티의 다음 활동을 권장합니다:

버그 보고 및 기능 제안.
문서 개선.
코드 개선 제출.
MCP 서버 및 확장 공유.

개발 설정, 코딩 표준 및 pull request 제출 방법은 기여 가이드를 참고하세요.

계획된 기능과 우선순위는 공식 로드맵을 확인하세요.

📖 리소스

무료 강좌 - 기본 사항 학습.
공식 로드맵 - 다음에 올 내용 확인.
변경 로그 - 최근 주요 업데이트 확인.
NPM 패키지 - 패키지 레지스트리.
GitHub 이슈 - 버그 보고 또는 기능 요청.
보안 공지 - 보안 업데이트.

제거
제거 방법은 제거 가이드를 참고하세요.

📄 법적 고지

라이선스 : Apache License 2.0
서비스 약관 : 약관 및 개인정보
보안 : 보안 정책

Google과 오픈소스 커뮤니티가 ❤️로 만들었습니다