[늦게 확인] Gemini API CLI 베타: 코딩 에이전트가 셸 한 줄로 Gemini를 부르게
무엇인가요
gemini-api는 상태를 남기지 않고 의존성도 없는 명령줄 클라이언트예요. Claude Code·Codex·Cursor 같은 코딩 에이전트나 CI 안에서 이미지 생성, 파일 분석, Gemini 관리형 에이전트 실행을 셸 명령으로 할 수 있어요. 대화형 코딩 에이전트인 @google/gemini-cli와는 다른 도구예요.
curl -fsSL https://raw.githubusercontent.com/google-gemini/gemini-api-cli/main/scripts/install.sh | bash
export GEMINI_API_KEY="YOUR_API_KEY"
gemini-api analyze -i ./report.pdf "핵심 세 가지만 요약해 줘"왜 중요한가요
에이전트가 REST를 직접 부르면 base64 미디어가 컨텍스트를 채우거나 대화형 프롬프트에서 멈추곤 해요. 이 CLI는 결과 파일을 디스크에 쓰고 경로만 출력하고 --dry-run·-o json·--agent-mode로 기계가 읽기 좋은 출력과 오류를 줘요. 프로젝트에 SDK를 넣지 않고 에이전트에게 Gemini 이미지·리서치 기능을 붙이고 싶을 때 쓸 만해요.
완성도
Beta 베타오픈소스 베타예요. 문서가 마이너 버전 사이에도 호환이 깨질 수 있다고 밝혀서 자동화 환경에서는 버전을 고정하라고 권해요.
앞으로 이렇게 지켜보세요
- 버전: google-gemini/gemini-api-cli GitHub 릴리스에서 1.0과 호환성 변경을 보세요.
- 연동: Gemini 문서의 코딩 에이전트 설정 가이드에 CLI 사용 규칙이 추가되는지 확인하세요.