<img src="/data/froala/25.06/bcf7124732f6b98d4ad0d2b1e69f3c863cc822bf.png"> <a href="https://github.com/google-gemini/gemini-cli">https://github.com/google-gemini/gemini-cli</a> <br> Gemini 명령줄 인터페이스(CLI)는 Gemini의 강력한 기능을 터미널에서 직접 사용할 수 있도록 설계된 오픈소스 AI 에이전트입니다.  개발자를 위한 CLI는 단순한 도구가 아니라, 효율성, 보편성, 휴대성으로 인해 작업을 수행하는 데 필수적인 "집"과 같습니다.  Gemini CLI는 <strong>이유 및 행동(ReAct) 루프</strong>를 사용하여 내장 도구 및 로컬 또는 원격 MCP(모델 컨텍스트 프로토콜) 서버와 결합하여 버그 수정, 새로운 기능 생성, 테스트 커버리지 개선과 같은 복잡한 사용 사례를 완료합니다.  코딩에 탁월하지만, 콘텐츠 생성, 문제 해결부터 심층 연구 및 작업 관리에 이르기까지 광범위한 작업을 수행할 수 있는 다목적 로컬 유틸리티이기도 합니다. Gemini CLI는 Gemini Code Assist의 개인용, Standard, Enterprise 에디션에서 모두 사용할 수 있습니다. 쿼터는 Gemini CLI와 Gemini Code Assist 에이전트 모드 간에 공유됩니다. <h3><strong><span style="color: rgb(226, 80, 65);" data-raw-html="span">주요 특징</span></strong></h3><ul><li><strong>대규모 코드베이스 쿼리 및 편집:</strong> Gemini의 100만 토큰 컨텍스트 창 안팎에서 대규모 코드베이스를 쿼리하고 편집할 수 있습니다.</li><li><strong>멀티모달 기능:</strong> Gemini의 멀티모달 기능을 활용하여 PDF나 스케치로부터 새로운 애플리케이션을 생성할 수 있습니다.</li><li><strong>작업 자동화:</strong> 풀 리퀘스트 쿼리 또는 복잡한 리베이스 처리와 같은 운영 작업을 자동화합니다.</li><li><strong>확장 가능한 도구 통합:</strong> MCP 서버를 포함한 다양한 도구를 사용하여 Imagen, Veo, Lyria와 같은 미디어 생성 기능을 포함한 새로운 기능을 연결할 수 있습니다.</li><li><strong>Google Search 연동:</strong> 내장된 Google Search 도구를 사용하여 쿼리에 대한 실시간 외부 컨텍스트를 제공하고 응답의 신뢰도를 높일 수 있습니다.</li><li><strong>사용자 지정 컨텍스트:</strong> <code>GEMINI.md</code> 컨텍스트 파일을 사용하여 Gemini CLI에 사용자 지정 컨텍스트(페르소나, 빌드 프로세스, 스타일 가이드 규칙 등)를 전달할 수 있습니다.</li><li><strong>셸 모드:</strong> <code>!</code> 명령어를 통해 셸 모드를 활성화하여 터미널 명령을 직접 실행할 수 있습니다.</li></ul> <h3></h3><h3><strong><span style="color: rgb(226, 80, 65);" data-raw-html="span">시작하기</span></strong></h3><ol><li><strong>필수 조건:</strong> Node.js 버전 18 이상이 설치되어 있는지 확인하십시오.</li><li><strong>설치:</strong>다음 방법 중 하나를 선택하여 Gemini CLI를 설치합니다.<pre>\# npx를 사용하여 직접 실행 \(설치 없이\) npx https://github.com/google-gemini/gemini-cli</pre><pre>\# 또는 전역으로 설치 \(권장\) npm install -g @google/gemini-cli</pre></li><li><strong>인증:</strong> CLI를 처음 실행할 때 프롬프트가 표시되면 개인 Google 계정으로 로그인하십시오. 이를 통해 무료 Gemini Code Assist 라이선스로 Gemini 2.5 Pro에 접근할 수 있으며, 분당 최대 60개의 모델 요청과 하루 1,000개의 모델 요청을 사용할 수 있습니다.</li><li><strong>CLI 실행:</strong> 터미널에서 <code>gemini</code>명령어를 실행하여 상호 작용을 시작합니다.<pre>gemini</pre></li></ol> <h3></h3><h3><strong><span style="color: rgb(226, 80, 65);" data-raw-html="span">API 키 구성 (더 높은 용량을 위해)</span></strong></h3>특정 모델을 사용하거나 더 높은 요청 용량이 필요한 경우, Google AI Studio에서 API 키를 생성하여 환경 변수로 설정할 수 있습니다. <pre>export GEMINI\_API\_KEY="YOUR\_API\_KEY"</pre><code>YOUR_API_KEY</code>를 발급받은 실제 API 키로 교체하십시오. <h3></h3><h3>예시 사용법</h3><ul><li><strong>새 프로젝트 시작:</strong>새로운 디렉토리에서 작업을 시작하고 Gemini에게 코드를 생성하도록 요청할 수 있습니다.<pre>$ cd my-new-project/ $ gemini > FAQ.md 파일을 사용하여 질문에 답변하는 Gemini 디스코드 봇을 작성해줘.</pre></li><li><strong>기존 프로젝트 작업:</strong>기존 코드베이스 내에서 작업을 수행할 수도 있습니다.<pre>$ cd my-existing-project/ $ gemini > 이 프로젝트에서 발생하는 빌드 오류를 수정하는 데 도움을 줘.</pre></li></ul> <h3></h3><h3><strong><span style="color: rgb(226, 80, 65);" data-raw-html="span">사용 가능한 CLI 명령어</span></strong></h3>Gemini CLI는 다양한 내장 명령어를 제공합니다. 몇 가지 예시는 다음과 같습니다:<ul><li><code>/memory</code>: 컨텍스트 파일을 포함한 현재 모델 컨텍스트를 표시합니다.</li><li><code>/stats</code>: 사용 통계를 표시합니다.</li><li><code>/tools</code>: 사용 가능한 내장 도구 목록을 표시합니다 (예: <code>grep</code>, <code>terminal</code>, <code>file read</code>, <code>file write</code>, <code>web-fetch</code>, <code>edit</code> 등).</li><li><code>/mcp</code>: 연결된 MCP 서버 목록을 표시합니다.</li><li><code>!</code>: 셸 모드를 활성화하여 터미널 명령을 직접 실행합니다.</li><li><code>!q</code>: 애플리케이션을 종료합니다.</li><li><code>!help</code>: 시스템 명령어 지침을 표시합니다.</li></ul> <h3></h3><h3></h3>Gemini CLI에 대해 더 자세히 알아보거나 프로젝트에 기여하려면 다음 자료를 참조하십시오:<ul><li>소스 코드 기여 또는 직접 빌드하는 방법 배우기.</li><li>사용 가능한 모든 <a href="https://developers.google.com/gemini-code-assist/docs/gemini-cli/commands">CLI 명령어</a> 탐색.</li><li>문제 발생 시 <a href="https://developers.google.com/gemini-code-assist/docs/gemini-cli/troubleshooting">문제 해결 가이드</a> 검토.</li><li>더욱 포괄적인 정보는 <a href="https://developers.google.com/gemini-code-assist/docs/gemini-cli">전체 문서</a> 참조.</li><li>영감을 얻기 위한 <a href="https://developers.google.com/gemini-code-assist/docs/gemini-cli/tasks">인기 작업</a> 살펴보기.</li><li>이 프로젝트는 <a href="https://ai.google.dev/api/generate-content">Gemini API</a>를 활용하여 AI 기능을 제공합니다.</li></ul> <h3></h3>