# npx 사용 (설치 불필요)
npx @google/gemini-cli

# 새 환경 생성 및 활성화
conda create -y -n gemini_env -c conda-forge nodejs
conda activate gemini_env
...

# Google Cloud Project 설정
export GOOGLE_CLOUD_PROJECT=

**무료 등급 (Free tier)**: Gemini 3를 사용하여 하루 1000회 요청 가능 (flash와 pro 혼합)
**모델 선택**: 특정 Gemini 모델을 선택할 수 있음
**사용량 기반 청구**: 필요에 따라 더 높은 한도로 업그레이드

**✨ 최적의 사용처**: 엔터프라이즈 팀 및 프로덕션 워크로드

**장점:**

**엔터프라이즈 기능**: 고급 보안 및 규정 준수
**확장성**: 결제 계정을 통해 더 높은 요청 한도 제공
**통합**: 기존 Google Cloud 인프라와 연동 가능

Google Workspace 계정 및 기타 인증 방법은 인증 가이드를 참조하세요.

`gemini`

`gemini --include-directories ../lib,../docs`

`gemini -m gemini-2.5-flash`

간단한 텍스트 응답을 얻으려면:

`gemini -p "이 코드베이스의 아키텍처를 설명해 주세요"`

JSON을 파싱하고 오류를 처리하는 방법 등 더 고급 스크립팅을 위해서는 다음 플래그를 사용하여 구조화된 출력을 받으세요:

`--output-format json`

`gemini -p "이 코드베이스의 아키텍처를 설명해 주세요" --output-format json`

실시간 이벤트 스트리밍(장기 실행 작업을 모니터링하는 데 유용)을 위해서는 다음 플래그를 사용하여 줄 바꿈으로 구분된 JSON 이벤트를 받으세요:

`--output-format stream-json`

`gemini -p "테스트를 실행하고 배포하세요" --output-format stream-json`

**빠른 시작 가이드 (Quickstart Guide)** - 빠르게 사용을 시작하세요.
**인증 설정 (Authentication Setup)** - 상세한 인증 구성.
**설정 가이드 (Configuration Guide)** - 설정 및 사용자 정의.
**키보드 단축키 (Keyboard Shortcuts)** - 생산성 팁.

**명령어 참조 (Commands Reference)** - 모든 슬래시 명령어 (`/help`, `/chat`)

기타 기능들).**사용자 정의 명령어(Custom Commands)** - 재사용 가능한 자신만의 명령어를 생성합니다.**컨텍스트 파일(Context Files, GEMINI.md)** - Gemini CLI에 지속적인 컨텍스트를 제공합니다.**체크포인팅(Checkpointing)** - 대화를 저장하고 다시 시작할 수 있습니다.**토큰 캐싱(Token Caching)** - 토큰 사용을 최적화합니다.

**내장 도구 개요(Built-in Tools Overview)**
* **MCP 서버 통합(MCP Server Integration)** - 사용자 정의 도구를 사용하여 기능을 확장합니다.**사용자 정의 확장 기능(Custom Extensions)** - 자신만의 명령어를 구축하고 공유할 수 있습니다.

**헤드리스 모드 (스크립팅, Headless Mode (Scripting))** - 자동화된 워크플로우에서 Gemini CLI를 사용합니다.**IDE 통합(IDE Integration)** - VS Code용 컴패니언입니다.**샌드박싱 및 보안(Sandboxing & Security)** - 안전한 실행 환경을 제공합니다.**신뢰 폴더(Trusted Folders)** - 폴더별로 실행 정책을 제어할 수 있습니다.**엔터프라이즈 가이드(Enterprise Guide)** - 기업 환경에 배포하고 관리하는 방법을 안내합니다.**텔레메트리 및 모니터링(Telemetry & Monitoring)** - 사용량을 추적합니다.**도구 참고 자료(Tools reference)** - 내장 도구 개요를 확인합니다.**로컬 개발(Local development)** - 로컬 개발을 위한 도구를 제공합니다.

**문제 해결 가이드(Troubleshooting Guide)** - 일반적인 문제와 해결책을 다룹니다.**자주 묻는 질문(FAQ)** - 자주 묻는 질문들을 모았습니다. `- `/bug` 명령어를 사용하여 CLI에서 직접 문제를 보고할 수 있습니다.

사용자 정의 도구로 Gemini CLI를 확장하려면 `~/.gemini/settings.json`에 MCP 서버를 구성하세요:

설정 방법은 MCP 서버 통합 가이드를 참조하세요.

기여를 환영합니다! Gemini CLI는 완전한 오픈 소스(Apache 2.0)이며, 커뮤니티가 다음 활동을 할 것을 장려합니다:
- 버그 보고 및 기능 제안.
- 문서 개선.
- 코드 개선 제출.
- MCP 서버 및 확장 기능을 공유.

개발 환경 설정, 코딩 표준, 풀 리퀘스트 제출 방법은 기여 가이드(Contributing Guide)를 참고하세요.

계획된 기능과 우선순위는 공식 로드맵(Official Roadmap)을 확인하세요.

**무료 강좌(Free Course)** - 기본 사용법을 배웁니다.**공식 로드맵(Official Roadmap)** - 다음에 무엇이 올지 확인합니다.**변경 로그(Changelog)** - 최근 주목할 만한 업데이트를 확인합니다.**NPM 패키지(NPM Package)** - 패키지 레지스트리입니다.**GitHub 이슈(GitHub Issues)** - 버그 보고 또는 기능 요청을 합니다.**보안 권고(Security Advisories)** - 보안 업데이트 정보를 제공합니다.

제거 방법은 제거 가이드(Uninstall Guide)를 참조하세요.

**라이선스**: Apache License 2.0
**서비스 약관**: 이용약관 및 개인정보 보호정책
**보안**: 보안 정책

Google과 오픈 소스 커뮤니티가 애정을 담아 제작했습니다 ❤️