Gemini CLI: 터미널용 오픈소스 AI 에이전트 > AI 툴킷 | AI 창작자를 위한 바이브 코딩 커뮤니티

Gemini 명령줄 인터페이스(CLI)는 Gemini의 강력한 기능을 터미널에서 직접 사용할 수 있도록 설계된 오픈소스 AI 에이전트입니다.

개발자를 위한 CLI는 단순한 도구가 아니라, 효율성, 보편성, 휴대성으로 인해 작업을 수행하는 데 필수적인 "집"과 같습니다.

Gemini CLI는 이유 및 행동(ReAct) 루프를 사용하여 내장 도구 및 로컬 또는 원격 MCP(모델 컨텍스트 프로토콜) 서버와 결합하여 버그 수정, 새로운 기능 생성, 테스트 커버리지 개선과 같은 복잡한 사용 사례를 완료합니다.

코딩에 탁월하지만, 콘텐츠 생성, 문제 해결부터 심층 연구 및 작업 관리에 이르기까지 광범위한 작업을 수행할 수 있는 다목적 로컬 유틸리티이기도 합니다.

Gemini CLI는 Gemini Code Assist의 개인용, Standard, Enterprise 에디션에서 모두 사용할 수 있습니다. 쿼터는 Gemini CLI와 Gemini Code Assist 에이전트 모드 간에 공유됩니다.

대규모 코드베이스 쿼리 및 편집: Gemini의 100만 토큰 컨텍스트 창 안팎에서 대규모 코드베이스를 쿼리하고 편집할 수 있습니다.
멀티모달 기능: Gemini의 멀티모달 기능을 활용하여 PDF나 스케치로부터 새로운 애플리케이션을 생성할 수 있습니다.
작업 자동화: 풀 리퀘스트 쿼리 또는 복잡한 리베이스 처리와 같은 운영 작업을 자동화합니다.
확장 가능한 도구 통합: MCP 서버를 포함한 다양한 도구를 사용하여 Imagen, Veo, Lyria와 같은 미디어 생성 기능을 포함한 새로운 기능을 연결할 수 있습니다.
Google Search 연동: 내장된 Google Search 도구를 사용하여 쿼리에 대한 실시간 외부 컨텍스트를 제공하고 응답의 신뢰도를 높일 수 있습니다.
사용자 지정 컨텍스트: GEMINI.md 컨텍스트 파일을 사용하여 Gemini CLI에 사용자 지정 컨텍스트(페르소나, 빌드 프로세스, 스타일 가이드 규칙 등)를 전달할 수 있습니다.
셸 모드: ! 명령어를 통해 셸 모드를 활성화하여 터미널 명령을 직접 실행할 수 있습니다.

설치:다음 방법 중 하나를 선택하여 Gemini CLI를 설치합니다.

# npx를 사용하여 직접 실행 (설치 없이)
npx https://github.com/google-gemini/gemini-cli

# 또는 전역으로 설치 (권장)
npm install -g @google/gemini-cli

인증: CLI를 처음 실행할 때 프롬프트가 표시되면 개인 Google 계정으로 로그인하십시오. 이를 통해 무료 Gemini Code Assist 라이선스로 Gemini 2.5 Pro에 접근할 수 있으며, 분당 최대 60개의 모델 요청과 하루 1,000개의 모델 요청을 사용할 수 있습니다.
CLI 실행: 터미널에서 gemini명령어를 실행하여 상호 작용을 시작합니다.
```
gemini
```

특정 모델을 사용하거나 더 높은 요청 용량이 필요한 경우, Google AI Studio에서 API 키를 생성하여 환경 변수로 설정할 수 있습니다.

export GEMINI_API_KEY="YOUR_API_KEY"

YOUR_API_KEY를 발급받은 실제 API 키로 교체하십시오.

새 프로젝트 시작:새로운 디렉토리에서 작업을 시작하고 Gemini에게 코드를 생성하도록 요청할 수 있습니다.
```
$ cd my-new-project/
$ gemini > FAQ.md 파일을 사용하여 질문에 답변하는 Gemini 디스코드 봇을 작성해줘.
```

기존 프로젝트 작업:기존 코드베이스 내에서 작업을 수행할 수도 있습니다.

$ cd my-existing-project/
$ gemini > 이 프로젝트에서 발생하는 빌드 오류를 수정하는 데 도움을 줘.

Gemini CLI는 다양한 내장 명령어를 제공합니다. 몇 가지 예시는 다음과 같습니다:

/memory: 컨텍스트 파일을 포함한 현재 모델 컨텍스트를 표시합니다.
/stats: 사용 통계를 표시합니다.
/tools: 사용 가능한 내장 도구 목록을 표시합니다 (예: grep, terminal, file read, file write, web-fetch, edit 등).
/mcp: 연결된 MCP 서버 목록을 표시합니다.
!: 셸 모드를 활성화하여 터미널 명령을 직접 실행합니다.
!q: 애플리케이션을 종료합니다.
!help: 시스템 명령어 지침을 표시합니다.