Gemini CLI 익스텐션: 모르면 AI 코딩 생산성 절반 날린다
터미널 명령어 한 줄로 Google Drive·BigQuery·Cloud Run까지 연결하는
🔌 익스텐션 100개+ 지원
💸 Google 계정만 있으면 무료
⚡ Gemini 3.1 기반
Gemini CLI 익스텐션이란? — 알면 게임이 달라진다
Gemini CLI 익스텐션은 구글이 2025년 하반기에 공개한 터미널 기반 AI 에이전트
‘Gemini CLI’에 기능 모듈을 붙여 넣는 확장 패키지입니다.
한 마디로, VS Code 확장처럼 설치하면 Gemini가 Google Drive·BigQuery·Cloud Run·Firebase
같은 외부 서비스를 직접 조작할 수 있게 됩니다. 2026년 2월 ‘Gemini 3 Deep Think’ 발표와 함께
익스텐션 생태계가 공식 확대됐고, 현재 100개 이상의 익스텐션이 공개 갤러리에 올라와 있습니다.
기존 Gemini CLI가 단순히 텍스트 질문에 답하거나 코드를 생성하는 수준이었다면,
익스텐션을 장착한 순간부터는 실제 파일을 읽고, SQL을 실행하고, 서비스를 배포하는
진짜 에이전트로 변신합니다. 단순한 챗봇과의 차이가 바로 여기에 있습니다.
“AI가 직접 실행한다”는 패러다임의 전환입니다. 프롬프트를 넣으면 Gemini가 스스로
MCP 서버를 호출해 실제 작업을 수행합니다.
익스텐션 구조 완전 해부 — MCP·GEMINI.md·명령어의 삼각형
이 구조를 이해하면 직접 만들거나 수정하는 것도 어렵지 않습니다.
| 구성 요소 | 역할 | 파일 형식 |
|---|---|---|
| MCP 서버 | 외부 API·서비스와 Gemini를 연결하는 브릿지 | settings.json에 등록 |
| GEMINI.md | 익스텐션의 컨텍스트·사용 규칙을 Gemini에게 가르치는 문서 | 마크다운 |
| 커스텀 명령어 | /deploy, /calendar:get-schedule 같은 슬래시 명령어 | .toml 등 |
| excludeTools | 보안상 허용하지 않을 도구를 명시적으로 차단 | 설정 파일 |
핵심은 MCP(Model Context Protocol) 서버입니다. MCP는 AI 모델과 외부 시스템 사이의 표준 통신
프로토콜로, 익스텐션은 이 MCP 서버를 로컬 또는 원격으로 실행해 Gemini가 API를 직접 호출하도록
만들어 줍니다. GitHub, Redis, DynaTrace, Google Cloud 서비스 등 이미 수십 개 파트너사의
MCP 서버가 공개 갤러리에 등록되어 있습니다.
확인을 요청하라”는 식의 규칙을 써두면, Gemini가 실수로 프로덕션에 바로 배포하는 사고를 막을 수 있습니다.
설치 3분 완성 — 명령어 한 줄로 끝내는 법
먼저 Gemini CLI 자체가 설치되어 있어야 하며, Google 계정 인증만 마치면 신용카드 없이도 무료로 사용할 수 있습니다.
1Gemini CLI 설치 (최초 1회)
# 설치 확인
gemini
2익스텐션 설치 — GitHub URL 방식
# 또는 로컬 폴더 경로
gemini extensions install –path=some/local/path
3설치된 익스텐션 확인·관리
gemini extensions update # 업데이트
설치 시 익스텐션이 실행할 MCP 서버 목록이 화면에 표시되며,
명시적으로 Y를 입력해야 설치가 진행됩니다. 이는 신뢰할 수 없는 익스텐션의
자동 실행을 막는 안전장치입니다. 공개 갤러리(geminicli.com/extensions/browse/)에서
익스텐션을 탐색하고 ‘Copy install’ 버튼으로 명령어를 복사하는 방식이 가장 빠릅니다.
Google Workspace 연동 — 드라이브·메일·캘린더를 터미널로
Drive, Docs, Gmail, Calendar, Chat을 터미널 한 줄로 조작할 수 있어
“GUI를 열지 않고 일하는” 워크플로가 현실이 됩니다.
설치 명령어
실전 활용 시나리오 3가지
① 드라이브 문서 검색 → 요약 → 새 문서 생성: “리카트 구조(아프리카의 눈)에 대해
조사하고 1페이지 문서를 Google Drive에 만들어 줘”라고 입력하면 Gemini가 검색부터 문서 생성까지
원스톱으로 처리합니다. 프레젠테이션 준비 시간이 실제로 절반 이하로 줄어드는 효과가 있습니다.
② 캘린더 일정 확인 및 요약: /calendar:get-schedule 명령어로
“오늘 일정이 뭐야?”를 물으면 구글 캘린더를 실시간 조회해서 답해줍니다.
회의 전 브리핑 자료 자동 생성에 특히 유용합니다.
③ Gmail 검색 → Chat 공유: 특정 프로젝트 관련 메일을 검색하고 핵심 내용을
Google Chat 공간에 공유하는 것까지 한 번에 처리합니다. OAuth 2.0 인증이 최초 1회 필요하지만,
이후에는 완전 자동으로 작동합니다.
이미지를 깨는 결정적 기능입니다. 코딩을 전혀 모르는 기획자·마케터도 이 하나만으로
반복 업무의 60%는 자동화할 수 있다고 생각합니다.
BigQuery 분석 자동화 — 코딩 없이 SQL을 AI가 써준다
데이터 분석 업무에서 Gemini CLI 익스텐션은 또 다른 차원의 효율을 보여줍니다.
BigQuery Data Analytics 익스텐션을 설치하면 SQL을 직접 작성하지 않아도
자연어로 데이터를 조회하고, 예측 분석(AI.Forecast)까지 실행할 수 있습니다.
설치 및 프로젝트 설정
gemini extensions install https://github.com/gemini-cli-extensions/bigquery-data-analytics
자연어 → SQL 자동 변환 예시
Look at BigQuery’s the look ecommerce public dataset. Identify the top 5 products that had the most orders.
# 다음 달 반품률 예측
Forecast what the return rate will be next month.
첫 번째 명령어를 입력하면 Gemini가 스스로 SQL 쿼리를 작성하고, MCP의 execute_sql
도구를 통해 BigQuery에서 실제 쿼리를 실행한 뒤 결과를 돌려줍니다. 두 번째 명령어는 더 놀랍습니다.
BigQuery AI.Forecast를 자동으로 호출해 시계열 예측 모델을 돌리고 결과를 해석까지 해줍니다.
최소 권한 원칙(roles/bigquery.user)으로 서비스 계정을 만들어 연결하면 보안 사고를
예방할 수 있습니다. 프로덕션 데이터베이스에 바로 연결하지 말고 샌드박스 환경을 먼저 구성하세요.
Cloud Run 원클릭 배포 — 개발자 필수 워크플로
서비스 배포까지 터미널 AI가 담당하는 시대가 왔습니다.
Cloud Run MCP 익스텐션을 설치하면 폴더 안의 코드를 보고
Dockerfile 작성·Artifact Registry 업로드·Cloud Run 배포를 단계별로 자동 처리합니다.
Cloud Run 익스텐션 설치
배포 슬래시 명령어
이 명령어 하나를 실행하면 Gemini가 코드를 분석하고, Docker 이미지를 빌드하고,
Artifact Registry에 푸시하고, Cloud Run 서비스를 생성합니다.
2~3분 후 배포된 URL이 터미널에 출력됩니다. 기존에 Cloud Build 파이프라인을 손수 구성하던 작업이
자연어 명령 하나로 대체됩니다.
특히 스타트업이나 1인 개발자에게 이 기능은 인프라 엔지니어 한 명분의 업무를 줄여주는 수준입니다.
익스텐션 설치 확인(gemini extensions list) 후 /mcp 명령어로
연결된 MCP 서버를 확인하는 것이 처음 사용할 때 추천하는 순서입니다.
보안·신뢰 주의사항 — 익스텐션이 위험할 수 있는 이유
익스텐션은 로컬 파일 시스템을 읽고 쓰거나, 외부 API를 호출하거나, 심지어 클라우드 서비스를
직접 조작할 수 있습니다. 신뢰할 수 없는 소스에서 받은 익스텐션은 악의적인 MCP 서버를
포함할 수 있습니다.
설치 시 터미널에 출력되는 경고 메시지는 무시하지 마세요.
“Extensions may introduce unexpected behavior. Ensure you have investigated the extension source and trust the author.”
이 문구가 나오면 반드시 GitHub 저장소 코드를 한 번은 직접 확인하는 습관을 들여야 합니다.
공개 갤러리(geminicli.com/extensions)에 등록된 익스텐션은 구글이 검토한
것들이므로 상대적으로 안전하지만, 개인 GitHub 저장소에서 직접 받는 경우에는 코드 리뷰가 필수입니다.
excludeTools 설정으로 특정 도구의 실행 권한을 명시적으로 차단하는 것도
실무에서 꼭 적용해야 할 보안 레이어입니다.
반드시 읽기 전용(Read-Only) IAM 권한으로 시작하세요. 작동을 충분히 검증한 후에 쓰기 권한을 부여하는
단계적 접근이 사고를 막는 가장 현실적인 방법입니다.
❓ 자주 묻는 질문 (Q&A)
Gemini CLI 익스텐션을 사용하려면 유료 요금제가 필요한가요?
Gemini CLI 익스텐션과 Claude Code(클로드 코드)의 차이는 무엇인가요?
Google Workspace 익스텐션에서 개인 Gmail 데이터가 외부로 유출될 위험은 없나요?
Gemini CLI 익스텐션을 직접 만들어 팀에 배포할 수 있나요?
gemini extensions install [저장소 URL]로 배포하면 됩니다. 회사 내부 API나 사내 시스템을 Gemini에 연결하는 엔터프라이즈 활용 사례가 2026년 들어 빠르게 증가하고 있습니다.
Windows 환경에서도 Gemini CLI 익스텐션이 정상 동작하나요?
✍️ 마치며 — 총평
개발자 도구로 분류되다 보니 비개발자들의 레이더에는 잘 걸리지 않지만,
실제로 써보면 코딩을 모르는 사람도 Google 생태계 업무 자동화의 핵심 도구로 활용할 수 있습니다.
특히 Google Workspace 익스텐션은 드라이브·메일·캘린더·채팅을 터미널 하나로 통합한다는 점에서
단순한 CLI 도구를 넘어 개인 AI 비서에 가깝습니다. BigQuery·Cloud Run 연동까지 더하면
데이터 분석부터 서비스 배포까지 원스톱으로 처리하는 진짜 에이전트 워크플로가 완성됩니다.
단, 보안 주의사항을 가볍게 여기면 안 됩니다. 강력한 도구일수록 잘못 사용했을 때의
위험도 큽니다. 처음에는 읽기 전용 권한으로 시작하고, 신뢰할 수 있는 소스의 익스텐션만
설치하는 원칙을 지키면서 점진적으로 활용 범위를 넓혀가는 접근을 권합니다.
지금 당장 npm install -g @google/gemini-cli 하나로 시작해 보세요.
3분이면 첫 번째 익스텐션이 동작하는 걸 눈으로 확인할 수 있습니다.
※ 본 포스팅은 2026년 3월 8일 기준 공개된 정보를 바탕으로 작성되었습니다.
Google Cloud 서비스 요금 및 익스텐션 스펙은 Google의 정책 변경에 따라 달라질 수 있으므로,
최신 정보는 공식 익스텐션 갤러리 및
Google Cloud 공식 블로그에서 직접 확인하시기 바랍니다.
댓글 남기기