Gemini CLI
| 개발자(팀) | Gemini CLI Team |
|---|---|
| 초기 릴리즈 | 2024년 |
| 플랫폼 | 크로스플랫폼 (Node.js 기반) |
| 운영체제 | Windows, macOS, Linux |
| 종류 | AI 에이전트, 명령줄 도구 |
| 라이센스 | MIT |
| 홈페이지 | https://geminicli.com/ |
Gemini CLI는 구글의 Gemini 모델을 기반으로 하는 대화형 명령줄 인터페이스(CLI) 에이전트다. 사용자의 로컬 환경에서 직접 실행되며, 파일 시스템 접근, 쉘 명령 실행, 웹 검색 등 다양한 도구를 활용하여 복잡한 소프트웨어 엔지니어링 작업을 수행할 수 있다.
주요 기능
- 파일 시스템 조작: 파일을 읽고 쓰고 수정하며, 디렉토리 구조를 탐색할 수 있다.
- 쉘 명령 실행: 터미널 명령을 직접 실행하여 빌드, 테스트, 배포 등의 작업을 수행한다.
- 코드베이스 분석: 프로젝트 전체의 구조를 파악하고 코드 간의 의존성을 분석하는 전용 에이전트(`codebase_investigator`)를 포함하고 있다.
- 웹 검색 및 데이터 추출: 실시간 구글 검색 및 웹 페이지 내용 추출 기능을 통해 최신 정보를 활용한다.
- 멀티미디어 처리: 텍스트뿐만 아니라 이미지, 오디오, PDF 파일 등을 읽고 분석할 수 있다.
설치 및 실행
Gemini CLI는 Node.js 환경에서 동작하며, npm을 통해 전역으로 설치하여 사용할 수 있다.
설치
npm install -g @google/gemini-cli
실행
설치가 완료되면 터미널에서 다음 명령어를 입력하여 실행한다.
gemini
실행 시 Google AI Studio에서 발급받은 API 키 설정이 필요할 수 있다.
사용법 및 팁
대화형 모드
실행 후 터미널에 직접 자연어로 명령을 입력하면 된다. 에이전트는 상황에 따라 적절한 도구를 자동으로 호출한다.
코드 수정 및 리팩토링
특정 기능의 구현이나 버그 수정을 요청하면, 에이전트가 관련 파일을 찾아 분석한 뒤 `replace` 툴 등을 사용하여 코드를 안전하게 수정한다. 수정 전후로 테스트를 실행하도록 요청하면 더욱 안전한 작업이 가능하다.
코드베이스 조사
프로젝트에 처음 합류하거나 대규모 리팩토링이 필요할 때 다음과 같이 요청할 수 있다.
- "이 프로젝트의 전반적인 아키텍처를 설명해줘."
- "특정 기능이 구현된 위치와 관련 로직을 찾아줘."
효율적인 활용 팁
- 구체적인 지시: "코드를 고쳐줘"보다는 "A 함수의 입출력 타입을 B로 변경하고 관련 테스트 코드를 업데이트해줘"와 같이 구체적으로 지시할 때 더 정확한 결과를 얻을 수 있다.
- 병렬 작업: 여러 파일을 읽거나 검색할 때 에이전트가 도구를 병렬로 호출하여 시간을 단축한다.
- 컨텍스트 유지: 대화 흐름을 통해 이전 작업 내용을 기억하므로, 단계별로 복잡한 작업을 지시할 수 있다.