터미널에서 자연어로 코드를 다루는 AI 에이전트
터미널 창에 프롬프트를 입력하면 모델이 코드베이스를 분석하거나 새 앱을 생성하는 과정을 바로 확인할 수 있습니다. Gemini CLI는 구글의 AI 모델 Gemini를 터미널 환경으로 가져와, 프롬프트 입력부터 모델 응답까지 가장 직접적인 경로를 제공합니다. 개발 환경 설정을 복잡하게 하지 않고도 즉시 코딩 작업을 시작할 수 있는 도구입니다.
Antigravity CLI로의 전환 안내
또한 최신 Gemini 모델, 특히 Gemini 4 Argon에는 최적화되어 있지 않습니다. 최신 모델로 최상의 코딩 경험을 원한다면 Antigravity CLI 사용을 권장합니다. 이 저장소는 여전히 오픈소스로 유지되지만, 최신 모델 지원 측면에서는 제한이 있습니다.
터미널에서 가능한 작업
대규모 코드베이스를 조회하고 편집할 수 있으며, PDF나 이미지, 스케치와 같은 멀티모달 입력을 받아 새로운 앱을 생성합니다. 자연어로 문제를 설명하면 디버깅과 트러블슈팅을 도와줍니다. 또한 풀 리퀘스트 조회나 복잡한 리베이스 처리 같은 운영 작업을 자동화할 수 있습니다. 스크립트 내에서 비대화형으로 실행되어 워크플로우 자동화에 활용할 수 있습니다.
설치와 인증 방법
TypeScript로 작성된 이 도구는 npx @google/gemini-cli 명령으로 즉시 실행하거나, npm install -g @google/gemini-cli로 전역 설치할 수 있습니다. macOS와 Linux에서는 Homebrew, macOS에서는 MacPorts, 제한된 환경에서는 Anaconda를 통해 설치할 수도 있습니다. 인증은 구글 계정 로그인, Gemini API 키, Vertex AI 중 선택합니다. 조직의 유료 Code Assist 라이선스를 사용하는 경우 Google Cloud 프로젝트를 설정해야 합니다.
릴리스 채널과 업데이트 주기
릴리스는 프리뷰, 스테이블, 나이트리 세 가지 채널로 나뉩니다. 프리뷰 버전은 매주 화요일 UTC 23:59에 공개되며, 완전히 검증되지 않아 회귀 오류가 있을 수 있습니다. 스테이블 버전은 매주 화요일 UTC 20:00에 공개되며, 지난주 프리뷰 버전의 검증과 버그 수정이 완료된 상태입니다. 나이트리 버전은 매일 UTC 00:00에 메인 브랜치의 변경 사항이 반영되어 공개됩니다.
사용 전 확인 사항
이 도구는 Apache 2.0 라이선스로 오픈소스이며, 커뮤니티 기여를 환영합니다. 하지만 최신 Gemini 모델에 최적화되지 않았다는 점을 반드시 인지해야 합니다. 특히 Gemini 4 Argon을 사용하려면 Antigravity CLI를 선택하는 것이 좋습니다. MCP 서버를 통해 Imagen, Veo, Lyria와 같은 미디어 생성 기능을 확장할 수 있으며, ~/.gemini/settings.json에서 설정합니다. 기업 환경에서는 Vertex AI 인증을 통해 보안과 규정 준수 기능을 활용할 수 있습니다.