gemini-cli
무엇인가
Gemini CLI는 Google의 Gemini 모델을 터미널 세션에서 직접 호출하는 AI 에이전트 클라이언트다. 모델 자체가 아니라 모델과 로컬 파일 시스템·셸 사이를 중개하는 실행기이며, IDE 플러그인이나 웹 채팅 UI 대신 명령줄을 작업 공간으로 삼는 자리에 있다. TypeScript로 작성돼 Node.js 위에서 돈다.
어떻게 동작하나
동작은 도구 호출 루프다. 사용자 프롬프트를 Gemini API 또는 Vertex AI로 보내고, 모델이 반환한 도구 호출을 로컬에서 실행한 뒤 결과를 다시 모델에 넣는다. 내장 도구는 파일 조작, 셸 명령 실행, 웹 페이지 가져오기, Google Search 그라운딩이다. MCP(Model Context Protocol) 서버를 등록하면 Imagen·Veo·Lyria 같은 외부 기능이 도구 목록에 추가된다. 프로젝트별 GEMINI.md 컨텍스트 파일이 세션에 주입되고, 체크포인팅으로 대화 상태를 저장·재개하며, 토큰 캐싱으로 반복 컨텍스트 비용을 줄인다.
무엇과 다른가
같은 자리의 대체 대상과 갈리는 지점은 실행 위치와 인증이다. IDE 내장 어시스턴트는 편집기 프로세스에 붙지만 이 도구는 독립 실행 파일로 터미널에서 돌아 편집기 없이 동작한다. 모델 API를 직접 호출하는 스크립트와 달리 도구 실행 루프, 검색 그라운딩, 컨텍스트 파일 로딩을 자체 처리한다. 인증은 Google 계정 OAuth, Gemini API 키, Vertex AI 세 갈래이며 OAuth 경로는 키 관리 없이 무료 할당량을 쓴다.
어떻게 쓰나
설치 후 프로젝트 디렉터리에서 `gemini`를 실행하면 대화형 세션이 열린다. `--include-directories`로 여러 디렉터리를 함께 넣거나 모델을 지정해 실행할 수 있다. 스크립트에서는 비대화형 모드로 단일 텍스트 응답을 받고, `--output-format json`으로 구조화 출력을, `--output-format stream-json`으로 줄바꿈 구분 JSON 이벤트 스트림을 받는다. GitHub Action을 붙이면 PR 리뷰, 이슈 라벨링·우선순위 지정, `@gemini-cli` 멘션 응답이 워크플로에서 돌아간다.
전제와 한계
전제는 Node.js 실행 환경과 인증 수단이다. 무료 할당량은 개인 Google 계정 기준 분당 60회·일 1,000회이고, API 키 경로는 일 1,000회, Vertex AI는 결제 계정을 요구한다. 배포는 preview(화요일 23:59 UTC), stable(화요일 20:00 UTC), nightly(매일 00:00 UTC) 세 채널로 나뉘며 preview와 nightly는 검증이 끝나지 않은 변경을 포함한다. 라이선스는 Apache 2.0이다.
관련 논문 1
유사 도구
- qwen-code터미널에서 동작하는 오픈소스 AI 코딩 에이전트다. OpenAI·Anthropic·Gemini·Qwen API와 로컬 모델을 런타임에 전환하며 MCP와 서브에이전트를 쓴다.
- opencode터미널에서 동작하는 오픈소스 AI 코딩 에이전트다. build와 plan 두 에이전트를 Tab 키로 전환하며 코드 편집과 탐색을 나눠 수행한다.
- inspectorMCP 서버를 웹·CLI·TUI 세 가지 방식으로 검사하는 TypeScript 개발 도구다. 전역 mcp-inspector 바이너리 하나로 실행한다.
- claude-delegatorClaude Code가 복잡한 작업을 GPT·Gemini 전문 서브에이전트에게 위임하도록 MCP 라우팅 규칙과 전문가 프롬프트를 주입하는 플러그인이다.
- plandex터미널에서 대규모 코딩 작업을 계획하고 실행하는 Go 기반 AI 에이전트다. 누적 diff 샌드박스로 변경을 프로젝트 파일과 분리해 검토·롤백한다.
- mcp-toolboxAI 에이전트와 IDE를 데이터베이스에 직접 연결하는 Go 기반 MCP 서버다. 미리 만들어진 범용 도구와 tools.yaml 기반 커스텀 도구 정의를 함께 제공한다.