터미널에서 AI를 활용해 코드 작성, 디버깅, 자동화까지 진행할 수 있다면 개발 흐름은 완전히 달라집니다. Google의 Gemini 모델을 직접 명령줄에서 제어할 수 있는 Gemini CLI는 이런 변화의 중심에 있는 도구입니다. 하지만 기능이 방대해 처음 접하면 어디서부터 어떻게 써야 할지 막막하기도 합니다.
이 글에서는 Gemini CLI의 핵심 개념부터 주요 기능, 고급 팁, 실제 활용법까지 개발 관점에서 바로 이해할 수 있도록 정리했습니다. 개발 효율을 높이는 실전적인 팁까지 함께 살펴보며, Gemini CLI가 어떤 방식으로 워크플로우를 강화하는지 한 번에 이해할 수 있을 것입니다.
Gemini CLI란 무엇인가
Gemini CLI는 Google Gemini 모델을 터미널에서 직접 사용하도록 만든 AI 기반 명령줄 인터페이스입니다. 웹 UI나 IDE 확장 없이도 자연어 명령만으로 코드 생성, 디버깅, 시스템 설정 등 다양한 작업을 수행할 수 있습니다.
특징
- Node.js/TypeScript 기반으로 모든 운영체제에서 동작
- 자연어 명령으로 다단계 작업 수행
- 명령 조합, 사용자 정의 명령, 파일 분석 등 고급 기능 지원
- 단순한 AI 봇이 아니라 개발 환경 전반을 제어하는 에이전틱 플랫폼
주요 기능과 고급 팁 정리
1. GEMINI.md 기반 지속적 컨텍스트 관리
Gemini CLI는 프로젝트의 규칙이나 개발 스타일 등 핵심 지침을 GEMINI.md에 저장해 항상 동일한 컨텍스트로 답변하도록 설정할 수 있습니다.
- 전역과 프로젝트별 GEMINI.md 병합
- /memory show로 현재 컨텍스트 확인
- /memory refresh로 갱신
- /init으로 템플릿 생성
- @include로 여러 파일 로드
프로젝트 단위의 일관된 답변이 필요할 때 특히 유용합니다.
2. 사용자 정의 슬래시 명령
반복되는 작업을 자동화하고 싶다면 TOML 기반으로 커스텀 명령을 만들 수 있습니다.
예시
/test:gen → 요구사항을 바탕으로 Jest 테스트 자동 생성
/review:security → 보안 리뷰 포맷 출력
팀 단위 표준화된 워크플로우 구축에 강력합니다.
3. MCP(Model Context Protocol) 서버 확장
외부 서비스와 연동하기 위한 확장 기능입니다. Figma, Google Docs, 사내 데이터베이스 등을 Gemini CLI 내부에서 직접 다룰 수 있도록 MCP 서버를 연결할 수 있습니다.
- gemini mcp add로 서버 등록
- settings.json에서 구성 관리
- OAuth 2.0 인증 지원
Gemini CLI를 단순한 명령줄 도구에서 확장 가능한 통합 플랫폼으로 만들어주는 핵심 기능입니다.
4. 메모리 기능과 체크포인트 복원
장기 메모리
중요 정보를 /memory add ""로 저장해 장기 컨텍스트에 유지할 수 있습니다.
예: “RabbitMQ 포트는 5673”
체크포인트 복원
파일 변경 전 자동 스냅샷을 남기고 문제 발생 시 /restore 로 즉시 되돌릴 수 있습니다.
Git과 함께 사용하면 안전성이 크게 향상됩니다.
5. @ 문법으로 파일·이미지 직접 참조
대화 중 @파일경로를 입력하면 해당 파일의 내용을 분석해 답변을 제공합니다.
예
Explain this code: @./src/main.js
이미지(OCR 포함), 다중 파일 비교, 문서 분석 등 멀티모달 활용이 가능합니다.
6. YOLO 모드(자동 승인)
반복 작업을 빠르게 처리하고 싶을 때 --yolo 옵션 또는 Ctrl+Y로 모든 변경 작업을 자동 승인할 수 있습니다.
안전성은 낮아지므로 특정 명령만 화이트리스트로 허용하는 방식이 권장됩니다.
7. 헤드리스/스크립트 모드
CI/CD 파이프라인 또는 자동화 스크립트에서 사용할 수 있는 비대화형 모드입니다.
- gemini -p "prompt"
- --format=json으로 구조화된 출력 제공
- --session-summary로 요약 파일 생성
8. 채팅 세션 저장 및 재개
/ chat save
/ chat resume
프로젝트 단위로 대화 세션을 분리해 관리할 수 있어, 장시간 디버깅이나 멀티 프로젝트 환경에서 매우 유용합니다.
9. 다중 디렉터리 워크스페이스 지원
폴리레포 환경, 프런트·백엔드 동시 작업 같은 상황에서 --include-directories 옵션으로 여러 디렉터리를 하나의 작업공간처럼 다룰 수 있습니다.
10. VS Code와의 통합
확장을 설치하면 VS Code의 파일, 커서 위치, 선택 영역 등을 Gemini CLI가 자동으로 인식합니다.
- 코드 변경 시 VS Code diff 뷰 제공
- /ide install, /ide enable로 사용 설정
IDE와 터미널을 오가며 AI를 활용하는 데 최적화된 환경을 제공합니다.
11. GitHub Action 자동화
Gemini CLI GitHub Action을 사용하면 다음 같은 기능이 가능합니다.
- PR 리뷰 자동화
- 이슈 분류
- @gemini-cli 멘션으로 테스트 생성 요청
/ setup-github 명령으로 자동 구성할 수 있습니다.
12. 확장(Extensions) 기능
gemini extensions install 로 외부 시스템을 통합할 수 있습니다.
예: Cloud Run, BigQuery, Figma, Stripe 등
추가 모듈 설치 방식으로 Gemini CLI를 계속 확장해 나갈 수 있습니다.
Gemini CLI 간단 사용 예제
예제: 코드 리뷰 요청
gemini "Review my code and suggest improvements" @./src/index.js
예제: 자동 테스트 생성
/test:gen @./src/user-service.js
예제: 문제 상황 복원
/restore list
/restore 3
예제: Google Docs 읽기
/read_google_doc <문서 링크>
필요한 명령만 간단히 입력하면 되고, 파일 참조와 컨텍스트 관리를 함께 사용하면 훨씬 강력해집니다.
Gemini CLI가 바꾸는 개발 워크플로우
Gemini CLI는 단순한 AI 챗봇이 아니라, 개발 과정의 모든 단계를 아우르는 명령줄 기반 에이전틱 개발 플랫폼으로 발전하고 있습니다.
지속적 컨텍스트 관리, 사용자 정의 명령, MCP 확장, IDE 통합, 자동화 도구 등은 개발자가 AI를 단순히 ‘질문하는’ 단계에서 벗어나 AI를 적극적으로 ‘활용하고 실행시키는’ 단계로 이끌어 줍니다.
앞으로 Gemini CLI 생태계가 계속 확장되면서, 개발자는 더 적은 시간으로 더 많은 작업을 자동화하고, 복잡한 문제 해결 과정에서도 일관된 AI 도움을 받을 수 있게 될 것입니다.
지금부터 Gemini CLI를 활용한다면 개발 생산성을 크게 높이고 새로운 방식의 워크플로우를 경험할 수 있을 것입니다.
https://github.com/addyosmani/gemini-cli-tips
GitHub - addyosmani/gemini-cli-tips: Gemini CLI Tips and Tricks
Gemini CLI Tips and Tricks. Contribute to addyosmani/gemini-cli-tips development by creating an account on GitHub.
github.com
'인공지능' 카테고리의 다른 글
| INTELLECT-3: 100B+ 규모 RL 기반 Mixture-of-Experts 모델의 탄생과 기술적 혁신 (0) | 2025.11.28 |
|---|---|
| 왜 Spec-Driven Development는 인프라 자동화의 해답이 아닐까? AI 시대의 인프라를 위한 새로운 접근, 블루프린트 중심 배포 전략 (0) | 2025.11.28 |
| FLUX.2: 차세대 비주얼 생성과 편집을 위한 실제 제작 환경 중심의 이미지 생성 모델 (0) | 2025.11.27 |
| 왜 전통적인 부하 테스트는 AI 에이전트 성능을 속이는가 - AI 시대의 성능 테스트가 완전히 새로워져야 하는 이유 (0) | 2025.11.27 |
| Agent Framework, Runtime, Harness: AI 에이전트 개발의 차이와 활용 가이드 (0) | 2025.11.27 |
