google-gemini/gemini-cli

어떤 프로젝트인가요?

핵심 기능

• 01자연어를 사용해 대규모 코드베이스를 조회하고 수정
• 02PDF, 이미지 또는 스케치 입력을 활용해 멀티모달 방식으로 앱 생성
• 03MCP 서버와 사용자 지정 명령으로 기능 확장
• 04텍스트, JSON 또는 스트리밍 출력을 사용해 스크립트에서 비대화형으로 실행
• 05Google 계정, Gemini API 키 또는 Vertex AI로 인증

활용 사례

• 터미널에서 익숙하지 않은 코드베이스를 탐색하고 요약
• 증상을 자연어로 설명해 문제 디버깅
• pull request 검토 같은 반복적인 저장소 작업 자동화
• Gemini를 호출하고 JSON 출력을 파싱하는 스크립트 워크플로 실행

빠른 시작

1. 1

   npx로 바로 실행할 수 있습니다(설치 불필요).

   npx @google/gemini-cli
2. 2

   또는 npm으로 전역 설치할 수 있습니다.

   npm install -g @google/gemini-cli
3. 3

   프로젝트 디렉터리에서 CLI를 시작한 뒤 Google 계정으로 로그인하거나 API 키를 설정하세요.

   gemini

사용 전 알아둘 점

• !README에 따르면 무료 요금제 사용자와 Google One 사용자를 대상으로 2026년 6월 18일에 Gemini CLI가 Antigravity CLI로 대체되었습니다.
• !Gemini 4 Argon과 같은 최신 Gemini 모델에 최적화되어 있지 않습니다.

토픽

자주 묻는 질문

gemini-cli은(는) 무엇인가요?

Google의 오픈소스 AI 에이전트로, 터미널에서 Gemini를 사용해 코드를 조회·수정하고 작업을 자동화합니다. Gemini CLI는 Gemini 모델을 기반으로 하는 터미널용 AI 에이전트입니다. 프로젝트 디렉터리에서 실행한 뒤 자연어 프롬프트를 입력해 코드베이스를 살펴보고, 파일을 생성하거나 수정하고, 문제를 디버깅하며, pull request 검토나 rebase 처리 같은 운영 작업을 자동화할 수 있습니다.

gemini-cli은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

gemini-cli은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

gemini-cli은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. gemini-cli의 마지막 커밋은 2026년 10월 20일입니다.

gemini-cli은(는) 어디에 사용할 수 있나요?

터미널에서 익숙하지 않은 코드베이스를 탐색하고 요약 증상을 자연어로 설명해 문제 디버깅 pull request 검토 같은 반복적인 저장소 작업 자동화 Gemini를 호출하고 JSON 출력을 파싱하는 스크립트 워크플로 실행

gemini-cli는 어떻게 설치하나요?

npx로 바로 실행할 수 있습니다(설치 불필요).: npx @google/gemini-cli 또는 npm으로 전역 설치할 수 있습니다.: npm install -g @google/gemini-cli 프로젝트 디렉터리에서 CLI를 시작한 뒤 Google 계정으로 로그인하거나 API 키를 설정하세요.: gemini

gemini-cli은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/google-gemini/gemini-cli