IT / AI · 2026.03.12
구글이 2026년 2월 공식 발표한 Gemini CLI v0.28 업데이트로
익스텐션 설치·설정·관리 방식이 완전히 달라졌습니다.
MCP 서버 연동, 보안 키체인 저장, Hooks 기본 활성화까지 —
지금 이 내용을 모르면 터미널 AI의 절반도 못 쓰고 있는 겁니다.
🔧 v0.28.0 이상 필수
🆓 무료 1,000회/일
⚡ Hooks 기본 활성화
Gemini CLI 익스텐션은 구글의 오픈소스 AI 에이전트인 Gemini CLI에 외부 서비스·도구·데이터를 직접 연결해 주는 확장 패키지입니다. 한마디로 “터미널 AI에게 새로운 손발을 달아주는 것”이라고 보시면 됩니다. 별도의 GUI 없이 명령 한 줄로 BigQuery 쿼리를 날리고, Cloud Run에 배포하고, Google Drive 문서를 요약하는 것이 모두 가능해집니다.
기술적으로는 MCP(Model Context Protocol) 서버, GEMINI.md 컨텍스트 파일, .toml 커맨드 파일, excludeTools 설정을 하나의 패키지로 묶어 배포하는 구조입니다. 설치 시 gemini extensions install <GitHub URL> 명령 하나면 MCP 서버 설정, 컨텍스트 파일 등록, 인증 가이드가 한 번에 처리됩니다. Claude Code의 MCP 연동과 방향이 같지만, 구글 생태계(BigQuery·Cloud Run·Workspace)와의 밀착도가 훨씬 높다는 점이 차별점입니다.
현재 공식 익스텐션 마켓에 100개 이상의 익스텐션이 등록되어 있으며, GitHub·Redis·Dynatrace·Supabase 같은 서드파티 서비스까지 커버합니다. 개발자 뿐만 아니라 데이터 분석가, 운영 담당자도 코딩 없이 업무 자동화를 구성할 수 있다는 점에서 실용 가치가 매우 높습니다.
💡 인사이트: Gemini CLI는 무료 계정으로도 하루 1,000회 요청이 가능하며(Gemini 2.5 Pro 기준), Gemini Code Assist Standard·Enterprise 구독 시 더 높은 할당량이 적용됩니다. 익스텐션은 이 할당량 내에서 자유롭게 작동합니다.
v0.28 최대 변화 — 익스텐션 설정(Settings) 자동화
2026년 2월 11일 공개된 v0.28.0 업데이트의 핵심은 ‘익스텐션 설정(Extension Settings)’ 기능입니다. 기존에는 익스텐션이 요구하는 API 키, 프로젝트 ID, 데이터베이스 주소 같은 환경 변수를 사용자가 직접 export 명령으로 설정해야 했습니다. README를 뒤지다가 오타 한 줄로 익스텐션이 먹통이 되는 상황이 비일비재했습니다.
이제는 익스텐션 제작자가 gemini-extension.json에 필요한 설정 항목을 미리 선언해두면, 설치 시 CLI가 자동으로 프롬프트를 띄워 값을 입력받습니다. 특히 “sensitive”: true로 표시된 API 키·비밀번호는 평문 파일이 아닌 시스템 키체인(Keychain)에 암호화 저장됩니다. 보안 사고 위험이 크게 줄어드는 실질적인 개선입니다.
설치 후에도 gemini extensions config <익스텐션명> 명령으로 언제든지 설정값을 대화형으로 수정할 수 있으며, 특정 값만 바꾸고 싶을 때는 환경 변수 이름을 추가 인자로 지정하면 됩니다. 프로젝트별로 다른 설정이 필요할 때는 --scope workspace 플래그로 디렉터리 단위 오버라이드도 가능합니다.
| 항목 | v0.27 이전 | v0.28 이후 |
|---|---|---|
| 환경 변수 설정 | 수동 export | 설치 시 자동 프롬프트 |
| API 키 보안 | 평문 파일 저장 | 시스템 키체인 암호화 |
| 설정 변경 | 파일 직접 수정 | extensions config 명령 |
| 프로젝트별 설정 | 미지원 | –scope workspace 지원 |
v0.26 핵심 업데이트 — Hooks·Skills·/rewind
2026년 1월 26일 공개된 v0.26.0은 Gemini CLI의 에이전트 루프를 완전히 통제할 수 있게 해주는 세 가지 기능을 동시에 선보였습니다. 개발자 커뮤니티에서 가장 요청이 많았던 기능들이라, 이 업데이트 하나로 Gemini CLI의 실용성이 한 단계 도약했다는 평가가 많습니다.
① Hooks — 기본 활성화로 에이전트 루프 완전 제어
Hooks는 Gemini CLI의 에이전트 실행 전후에 사용자 정의 스크립트를 자동으로 끼워 넣는 기능입니다. 예를 들어 특정 도구가 실행되기 전 보안 검사를 트리거하거나, AI가 파일을 수정한 후 자동 포맷팅·린팅을 돌리는 방식으로 활용할 수 있습니다. v0.26부터는 이 기능이 별도 설정 없이 기본 활성화됩니다.
② Skills — 전문화된 에이전트 능력 확장
Skills는 Gemini CLI에 특화된 전문 지식·절차적 워크플로우·리소스를 추가하는 기능입니다. 기존 익스텐션이 외부 서비스 연결에 초점을 뒀다면, Skills는 AI가 특정 도메인에서 더 깊이 있게 판단하고 행동하도록 해줍니다. 내장 skill-creator 도구로 자신만의 Skills를 생성할 수 있습니다.
③ /rewind — 실수를 되돌리는 시간여행 명령어
AI가 파일을 잘못 수정했을 때 이를 이전 상태로 되돌리는 /rewind 슬래시 명령어가 추가됐습니다. 확인 다이얼로그와 과거 상태를 탐색하는 뷰어 컴포넌트도 함께 제공됩니다. 개인적으로 이 기능은 AI 코딩 에이전트를 실무에서 쓰는 데 있어 심리적 안전판 역할을 한다고 생각합니다. “혹시 AI가 잘못 건드리면 어떡하지”라는 걱정을 크게 덜어주기 때문입니다.
💡 추가로 v0.26에서는 Persistent “Always Allow” Policies도 도입됐습니다. 특정 셸 명령이나 MCP 도구에 대해 “항상 허용” 결정을 저장해두면, 매번 확인 프롬프트가 뜨는 불편을 해소할 수 있습니다.
실전 설치 가이드: Cloud Run·BigQuery·Workspace
익스텐션 설치 명령어는 모두 동일한 패턴을 따릅니다. gemini extensions install <GitHub URL 또는 로컬 경로>를 실행하면 CLI가 익스텐션 내용을 파악하고 필요한 MCP 서버 실행 계획을 제시한 뒤 사용자의 동의를 구합니다. v0.28 이후에는 필요한 설정값을 이 시점에 대화형으로 입력받으므로 설치 완료 즉시 사용 가능한 상태가 됩니다.
① Cloud Run 익스텐션 — 터미널에서 배포까지 원스톱
Cloud Run MCP 익스텐션은 가장 인기 있는 구글 공식 익스텐션 중 하나입니다. 설치 후 앱 코드가 있는 디렉터리에서 /deploy --project="프로젝트ID" --location="리전" --name="서비스명"을 입력하면 Dockerfile 생성, Artifact Registry 업로드, Cloud Run 배포까지 AI가 자동 처리합니다.
② BigQuery 데이터 분석 익스텐션 — 자연어로 SQL 쿼리
BigQuery 익스텐션을 설치하면 Gemini가 직접 SQL 쿼리를 생성하고 실행한 뒤 결과를 해석해줍니다. “이커머스 공개 데이터셋에서 주문이 가장 많은 상품 5개를 찾아줘”라고 자연어로 입력하면 Gemini가 SQL을 짜고, MCP 도구로 실행하고, 결과를 요약해줍니다. 심지어 AI.Forecast 함수를 활용한 예측 분석도 가능합니다.
③ Google Workspace 익스텐션 — Drive·Gmail·Calendar 통합 제어
Google Workspace 익스텐션은 OAuth 2.0 인증을 통해 Drive, Docs, Gmail, Chat, Calendar에 접근합니다. “아프리카의 눈(리차트 구조)에 대한 1페이저 문서를 만들어 Drive에 저장해줘”처럼 복합 작업을 자연어 한 문장으로 처리할 수 있습니다. 보안상 주의할 점은, 이 익스텐션은 실제 Gmail·Drive에 쓰기 권한이 생기므로 신뢰할 수 있는 환경에서만 사용해야 합니다.
보안·권한·폴더 신뢰 설정 완전 정리
익스텐션 설치 시에도 CLI는 해당 익스텐션이 실행할 MCP 서버 목록을 명시적으로 보여주며 동의를 요청합니다. 이는 악의적인 익스텐션이 사용자 모르게 외부 서버에 데이터를 전송하는 것을 방지하기 위한 설계입니다. 출처가 불분명한 GitHub URL의 익스텐션은 반드시 소스 코드를 확인한 후 설치하는 것이 권장됩니다.
현재 설치된 익스텐션의 설정값 전체를 확인하고 싶다면 gemini extensions list를 실행하면 됩니다. 각 익스텐션의 버전, 소스 URL, 릴리스 태그, 활성 여부, 설정값(비밀값은 마스킹)이 한눈에 출력됩니다. 보안 점검이나 팀 온보딩 시 유용한 명령어입니다.
⚠️ 주의: Google Workspace 익스텐션처럼 실제 서비스에 쓰기 권한이 있는 익스텐션은 반드시 --scope workspace로 범위를 제한하고, 프로덕션 환경이 아닌 테스트 계정에서 먼저 검증하세요.
지금 당장 써야 할 추천 익스텐션 7선
실무에서 즉시 효용이 높은 익스텐션 7개를 정리했습니다. 모두 공식 마켓에서 원클릭 설치가 가능합니다.
터미널에서 Flask·Node 앱을 한 줄 명령으로 Cloud Run에 배포. Docker·Artifact Registry 설정을 AI가 알아서 처리.
자연어로 BigQuery 쿼리·예측 분석 실행. BI 툴 없이 터미널에서 데이터 인사이트 즉시 확인 가능.
Drive·Docs·Gmail·Chat·Calendar를 하나의 AI 에이전트로 통합. 문서 작성부터 회의 일정 조회까지 원스톱.
Supabase 프로젝트와 직접 연결해 테이블 관리·마이그레이션·데이터 쿼리를 컨텍스트 전환 없이 처리.
v0.28 설정 자동화의 대표 사례. 설치 시 프로젝트ID·리전·클러스터 정보를 대화형으로 입력, 키체인 보안 저장.
Firestore 데이터 자연어 조회·문서 생성·컬렉션 탐색. 모바일 앱 백엔드 개발 시 생산성을 크게 끌어올립니다.
Looker 대시보드 데이터를 CLI에서 직접 조회·분석. 비즈니스 지표 모니터링에 별도 UI 없이 접근 가능.
Q&A — 자주 묻는 5가지
Q1. Gemini CLI 익스텐션은 무료로 사용할 수 있나요?
Q2. v0.28 설정 자동화 기능은 어떻게 업데이트하나요?
터미널에서 npm install -g @google/gemini-cli@latest를 실행하면 최신 버전으로 업데이트됩니다. v0.28.0 이상이어야 익스텐션 설정 자동화 기능을 사용할 수 있습니다. 현재 버전은 gemini --version으로 확인하세요.
Q3. Claude Code의 MCP와 Gemini CLI 익스텐션은 어떻게 다른가요?
두 방식 모두 MCP 프로토콜을 기반으로 하지만, Gemini CLI 익스텐션은 MCP 서버 외에 GEMINI.md 컨텍스트 파일, 슬래시 커맨드 파일(.toml)을 하나의 패키지로 묶어 배포합니다. 또한 구글 클라우드 서비스(BigQuery, Cloud Run, AlloyDB 등)와의 공식 지원이 더 촘촘합니다. 반면 Claude Code의 MCP는 서드파티 서버 생태계가 더 방대합니다.
Q4. 직접 만든 익스텐션을 팀원과 공유할 수 있나요?
GitHub 저장소에 익스텐션을 올리면 팀원들이 URL로 바로 설치할 수 있습니다. 공식 마켓(geminicli.com/extensions)에 등록 신청을 통해 공개 배포도 가능합니다. 로컬 개발 중인 경우에는 gemini extensions install --path=./my-extension으로 로컬 경로를 직접 지정할 수도 있습니다.
Q5. Hooks와 익스텐션을 함께 사용하면 어떤 조합이 좋나요?
Cloud Run 익스텐션 + Hooks 조합이 특히 강력합니다. Hooks로 배포 전 자동 단위 테스트를 실행하고, 통과 시에만 Cloud Run MCP 익스텐션의 /deploy 커맨드가 이어지도록 에이전트 루프를 설계할 수 있습니다. CI/CD 파이프라인을 별도 설정 없이 Gemini CLI 터미널 안에서 구성하는 셈이라 소규모 팀에게 특히 유용합니다.
마치며 — 총평
솔직히 말씀드리면, 2025년 출시 당시의 Gemini CLI는 “쓸 수 있는 물건”이었지만 2026년 v0.26~v0.28을 거치며 “써야 하는 물건”으로 격이 달라졌습니다. 특히 익스텐션 설정 자동화와 시스템 키체인 보안 저장은 “그래도 API 키 관리가 불편하다”는 개발자들의 오랜 불만을 정면으로 해결했습니다. Hooks가 기본 활성화되면서 에이전트 루프를 자기 업무 방식에 맞게 커스터마이징할 수 있게 된 것도 큰 전진입니다.
아쉬운 점이 있다면 여전히 비개발자에게는 초기 설치 허들(Node.js, npm)이 존재하고, Google Workspace 익스텐션의 OAuth 설정은 약간의 기술 지식이 필요합니다. 하지만 구글이 GCP 서비스와의 밀착 연동에 집중하고 있는 방향성은 매우 명확하고, 앞으로 4월 Google Cloud Next 2026에서 추가 기능 발표가 예상됩니다.
무료로 하루 1,000회 요청이 가능하다는 점에서 지금 당장 시도해볼 명분은 충분합니다. Cloud Run 익스텐션 하나만 설치해도 배포 작업에서 체감하는 효율 차이가 확연합니다. 이미 Claude Code나 Cursor를 쓰고 있더라도, GCP 기반 프로젝트라면 Gemini CLI 익스텐션은 병행할 이유가 충분한 도구입니다.
본 콘텐츠는 2026년 3월 12일 기준 공개된 정보를 바탕으로 작성되었습니다.
공식 릴리스 노트를 직접 확인하시기 바랍니다.
Google Cloud 서비스 사용 시 별도 요금이 발생할 수 있습니다.
댓글 남기기