2026년 코딩을 위한 Gemini CLI: Google의 터미널 에이전트 리뷰

Google은 2025년 중반에 Gemini CLI를 오픈 소스 터미널 에이전트로 출시했으며, 2026년에 이르러 이 도구는 명확한 니치(niche) 시장을 확보했습니다. 바로 세련미보다는 컨텍스트 크기(context size)로 경쟁하는, 무료로 로컬에서 실행되는 코딩 에이전트라는 점입니다. 설치 후 저장소(repository)를 지정하면, 이 에이전트는 셸(shell)을 벗어나지 않고 추론 루프(reasoning loop)를 통해 파일을 읽고, 수정하며, 명령어를 실행합니다. 우리는 Claude Code 및 Aider와 나란히 설 만한 가치가 있는지, 그리고 여전히 방해가 되는 부분은 무엇인지 확인하기 위해 실제 프로젝트인 중간 규모의 TypeScript 앱과 방대한 테스트 스위트가 포함된 Python 서비스에 이를 적용해 보았습니다.

Gemini CLI의 실제 작동 방식

Gemini CLI는 Apache 2.0 라이선스로 출시되어 소스 코드가 공개되어 있으므로, 무엇을 전송하고 실행하는지 정확히 감사(audit)할 수 있습니다. npm install -g @google/gemini-cli로 설치하거나(또는 npx로 한 번 실행), 인증 과정을 거치면 됩니다. 개인 Google 계정으로 로그인하면 무료 티어(free tier)를 사용할 수 있으며, Gemini API 키나 Vertex AI 프로젝트를 입력하면 유료의 더 높은 한도 사용량으로 전환됩니다.

내부적으로는 ReAct 스타일의 루프를 실행합니다. 모델이 사용자의 요청에 대해 추론하고, 도구(tool)를 호출하고, 결과를 읽은 다음, 작업이 완료되거나 사용자에게 확인을 요청할 때까지 이 과정을 반복합니다. 내장된 도구 세트(toolset)는 이 도구를 단순한 채팅창이 아닌 '에이전트(agent)'로 만드는 핵심 요소입니다. 파일을 읽고 쓸 수 있으며, 트리 전체를 grep으로 검색하고, 셸 명령어를 실행하며, 웹 페이지를 가져올 수 있습니다. Google 제품이기 때문에 웹 검색 그라운딩(web search grounding)이 직접 연결되어 있어, 학습 데이터에서 추측하는 대신 작업 도중에 최신 문서를 가져올 수 있습니다.

기능 목록이 시사하는 것보다 더 중요한 두 가지 기능이 있습니다. 첫째, 저장소 루트에 있는 GEMINI.md 파일은 지속적인 프로젝트 컨텍스트(project context) 역할을 합니다. 이는 관례, 아키텍처 노트, 실행해서는 안 될 명령어 등을 포함하며, Claude Code의 CLAUDE.md와 동일한 패턴으로 매 호출 시마다 로드됩니다. 둘째, Gemini CLI는 모델 컨텍스트 프로토콜(Model Context Protocol, MCP)을 지원하므로 외부 서버(데이터베이스, 이슈 트래커, 자체 내부 도구 등)를 연결할 수 있으며, 에이전트는 이를 일급 기능(first-class capabilities)으로 취급합니다.

워크플로우에서 차지하는 위치

가장 핵심적인 장점은 컨텍스트(context)입니다. Gemini 2.5 Pro는 100만 토큰의 컨텍스트 창(context window)을 제공하며, CLI는 이를 활용하도록 설계되었습니다. 수십 개의 상호 연결된 파일에 대해 추론하도록 요청할 때, 이 도구는 더 작은 컨텍스트 창에 제한된 에이전트들보다 훨씬 더 많은 코드베이스를 작업 메모리(working memory)에 유지할 수 있습니다. TypeScript 앱 테스트 시, 이 에이전트는 우리가 각 파일을 수동으로 입력하지 않았음에도 불구하고 단 한 번의 과정(single pass)으로 React 컴포넌트에서 시작해 두 개의 유틸리티 모듈과 설정 파일을 거쳐 버그를 추적해냈습니다. 이는 컨텍스트가 작은 도구들이 헤매는 방식인 파일 간 추론(cross-file reasoning)의 전형적인 사례입니다.

두 번째 장점은 가격입니다. Google 계정으로 인증하는 무료 티어(free tier)는 실제로 사용할 수 있는 수준의 일일 허용량을 제공합니다. 출시 당시에는 분당 수십 개의 요청과 하루 최대 약 1,000개의 요청을 허용했으나, Google이 시간이 지남에 따라 이러한 할당량(quotas)을 조정해 왔으므로, 워크플로우를 구축하기 전에 현재 제한 사항을 확인하십시오. 개인 개발자와 사이드 프로젝트(side projects)의 경우, 비용 부담 없이 매일 의존하기에 충분한 양입니다.

대안들과 비교하면 어떤 위치에 있을까요? Claude Code는 더 세련된 에이전트입니다. 편집 정밀도(editing precision)와 다단계 작업 규율(multi-step task discipline) 면에서는 여전히 앞서 있습니다. Aider는 엄격한 git-diff 제어와 페어 프로그래밍(pair-programming) 스타일의 편집을 원할 때 여전히 더 가볍고 결정론적인(deterministic) 선택지로 남아 있습니다. Gemini CLI는 그 중간 지점을 공략합니다. Aider보다는 더 자율적이고, Claude Code보다는 일관성이 낮지만, 대규모 컨텍스트 작업에 대한 토큰당 비용(cost-per-token) 측면에서는 타의 추종을 불허합니다.

첫 번째 실제 세션을 시작하기 전에 GEMINI.md 파일을 작성하세요. 에이전트가 절대 실행해서는 안 되는 명령(파괴적인 마이그레이션, git push --force 등), 테스트 명령, 그리고 귀하의 포맷팅 규칙을 나열하십시오. 에이전트가 매번 귀하의 컨벤션(conventions)을 추측하는 것을 멈추게 되면 출력 품질이 눈에 띄게 향상됩니다. 이 파일 하나가 그 어떤 프롬프트 수정(prompt tweak)보다 출력 품질에 더 큰 기여를 합니다.

비대화형 모드(non-interactive mode)에 대한 실용적인 참고 사항: 프롬프트를 파이프(pipe)로 입력하여 단일 응답을 출력받을 수 있으며, 이를 통해 Gemini CLI를 스크립트화할 수 있습니다. 저희는 이를 사용하여 커밋 메시지(commit-message) 초안을 생성하거나 PR(Pull Request)의 변경 사항을 요약하는 데 사용했으며, 두 경우 모두 한 줄의 셸 호출(shell invocation)로 처리했습니다. 이것이 CI 에이전트를 완전히 대체하는 것은 아니지만, 자동화를 위한 정당한 빌딩 블록(building block)이 될 수 있습니다.

사용 전 알아두어야 할 한계점

편집 정밀도(Editing precision)는 반복적으로 나타나는 약점입니다. 규모가 큰 리팩터링(refactor) 시, Gemini CLI는 때때로 깔끔하게 적용되지 않는 편집을 생성하거나 작업에 필요한 것보다 더 많은 파일 내용을 다시 작성하기도 합니다. 따라서 모든 차이점(diff)을 단순히 승인(rubber-stamp)하기보다는 검토해야 합니다. 이는 어쨌든 좋은 습관이지만, Claude Code의 경우에는 차이점(diff)을 더 자주 신뢰할 수 있었습니다.

또한 루프(loop)에 빠지기도 합니다. 도구 호출(tool call)이 실패할 때 — 즉, 셸 명령(shell command)에 오류가 발생하거나 파일 경로가 잘못되었을 때 — 에이전트는 뒤로 물러나는 대신 때때로 동일한 접근 방식을 재시도합니다. 에이전트가 조정을 하기 전까지 몇 차례의 턴(turn)을 낭비하는 것을 보게 될 것이며, 무료 티어(free tier)에서는 이러한 낭비된 턴이 할당량(quota)에 포함됩니다. 작업을 범위 내로 제한하는 것(한 번에 하나의 버그, 하나의 기능, 하나의 파일 그룹)이

2026년의 대부분의 개발자들에게 Gemini CLI를 설치할 가치가 있는 단 한 가지 이유는 다음과 같습니다. 바로 비용 부담 없이 유능하고 긴 컨텍스트 (large-context)를 가진 코딩 에이전트 (coding agent)를 사용할 수 있다는 점입니다. 이는 탐색적 작업 (exploratory work), 코드베이스 질의응답 (codebase Q&A), 그리고 정밀한 수정 (surgical edits)보다 많은 수의 파일을 컨텍스트 (context)에 유지하는 것이 더 중요한 모든 작업에 있어 명백히 유리한 도구가 됩니다. 실제 배포할 수정 작업을 위해 더 정밀한 에이전트 (agent)와 함께 사용한다면, 유료 도구의 이점을 대부분 무료로 누릴 수 있습니다.