Google Agents CLI 완전 정리 — AI 에이전트를 20분 만에 Google Cloud에 배포하는 법
Google Agents CLI 완전 정리 — AI 에이전트를 20분 만에 Google Cloud에 배포하는 법
2026년 4월 22일, Google Cloud Next '26에서 조용히 공개된 CLI 도구가 있었습니다.
발표 48시간 만에 GitHub 스타 1,000개를 넘어섰고, 글로벌 개발자 커뮤니티에서 "에이전트 빌드·배포·관리 방식이 완전히 바뀌었다"는 반응이 이어지고 있습니다.
이름은 Google Agents CLI (google/agents-cli, Apache 2.0).
이 글에서는 Google Agents CLI가 무엇인지, 어떻게 작동하는지, 그리고 1인 기업/소규모 팀이 실제로 활용할 수 있는 시나리오까지 정리합니다.
Google Agents CLI란? — 코딩 에이전트의 협력자
Google Agents CLI를 한 문장으로 정의하면 이렇습니다.
"어떤 AI 코딩 에이전트(Claude Code, Gemini CLI, Cursor 등)에도 ADK 에이전트를 Google Cloud에 scaffold·eval·deploy·publish하는 전문 능력을 부여하는 CLI + Skills 패키지"
중요한 점은 경쟁 도구가 아니라는 것입니다.
Claude Code, Gemini CLI, Cursor가 코딩 에이전트 자체라면, Google Agents CLI는 그 에이전트들을 사용자로 상정하고 Google Cloud ADK 배포 전문 능력을 Skills 형태로 주입합니다.
비유하자면, Claude Code가 개발자라면 Google Agents CLI는 Google Cloud 배포 가이드북을 AI가 읽을 수 있는 형태로 제공하는 것과 같습니다.
기본 정보
| 항목 | 내용 |
|---|---|
| 공식 GitHub | github.com/google/agents-cli |
| 발표일 | 2026년 4월 22일 (Google Cloud Next '26) |
| 라이선스 | Apache 2.0 (코드) / CC BY 4.0 (문서) |
| 지원 OS | macOS, Linux (Windows: WSL 2 필요) |
| 설치 | uvx google-agents-cli (pip 설치 불필요) |
핵심 기능 5가지 상세 분석
1. Scaffold — 에이전트 프로젝트 뼈대를 한 줄로
ADK 표준 프로젝트 구조를 단 한 줄로 생성합니다. CI/CD 파이프라인과 IaC(Infrastructure as Code)가 자동으로 주입됩니다.
# 새 에이전트 프로젝트 생성
agents-cli scaffold create my-agent
# 프로토타입 모드 (빠른 시작)
agents-cli scaffold create my-agent --prototype --yes
# 기존 프로젝트에 배포 타깃 추가
agents-cli scaffold enhance
# 최신 버전으로 업그레이드
agents-cli scaffold upgrade
기존에 ADK 에이전트를 처음부터 구성하려면 프로젝트 구조, CI/CD 설정, IaC 코드를 직접 작성해야 했습니다. Scaffold 명령 하나로 이 과정이 자동화됩니다.
2. Eval — 배포 전 동작 검증
로컬 환경에서 평가 파이프라인을 실행하고, 여러 실행 결과를 데이터셋과 비교 검증합니다.
# 로컬 평가 실행
agents-cli eval run
# 두 평가 결과 JSON 비교
agents-cli eval compare result_v1.json result_v2.json
이 기능은 경쟁 도구(Claude Code, GitHub Copilot CLI, Cursor)에는 없는 Google Agents CLI만의 고유 기능입니다. 에이전트를 배포하기 전에 로컬에서 품질을 검증할 수 있어, 프로덕션 환경에서의 예상치 못한 실패를 줄여줍니다.
3. Deploy — Google Cloud 원클릭 배포
Agent Runtime, Cloud Run, GKE로 직접 배포합니다. IaC 설정이 자동으로 처리됩니다.
agents-cli deploy
단 한 줄입니다.
4. Publish — Gemini Enterprise에 에이전트 등록
배포된 에이전트를 Gemini Enterprise Agent Platform에 등록하여 팀이나 기업 전체에 배포합니다.
agents-cli publish gemini-enterprise
5. Skills — 코딩 에이전트에 ADK 전문 지식 주입
이 기능이 Google Agents CLI의 가장 독특한 포인트입니다.
기존 AI 코딩 에이전트(Claude Code, Gemini CLI, Cursor 등)에 ADK 전문 지식을 담은 Skills를 설치하면, 해당 에이전트가 스스로 ADK에 맞는 올바른 판단을 내립니다.
# Claude Code에 ADK 전문 능력 주입
npx skills install github.com/google/agents-cli
설치 후 Claude Code에서 자연어로 ADK 에이전트를 정의·테스트·배포할 수 있습니다.
설치 및 빠른 시작
사전 요건
| 패키지 | 역할 | 버전 |
|---|---|---|
| Python | ADK 에이전트 백엔드 | 3.11 이상 |
| Node.js + npm | CLI 인터페이스 및 배포 | 최신 LTS |
| uv | Python 패키지 관리 (Agents CLI 내부 사용) | 최신 |
설치
# 방법 1: uvx로 즉시 실행 (설치 불필요)
uvx google-agents-cli --help
# 방법 2: pip 설치
pip install google-agents-cli
Hello World — 첫 에이전트 배포까지 4단계
# 1단계: 새 에이전트 프로젝트 생성 (1분)
agents-cli scaffold create my-first-agent --prototype --yes
# 2단계: 개발 플레이그라운드 실행 (1분)
cd my-first-agent
agents-cli dev
# 3단계: 로컬 평가 실행 (10분)
agents-cli eval run
# 4단계: Google Cloud 배포 (5분)
agents-cli deploy
인증 설정
# Google Cloud 인증
gcloud auth login
# Gemini Enterprise Agent Platform API 활성화
gcloud services enable gemini-enterprise-agent-platform.googleapis.com
경쟁 도구 비교 — Google Agents CLI의 포지션
Google Agents CLI가 다른 도구들과 어떻게 다른지 비교해봤습니다.
| 항목 | Google Agents CLI | Claude Code | Gemini CLI | GitHub Copilot CLI | Cursor |
|---|---|---|---|---|---|
| 주요 목적 | ADK scaffold/eval/deploy | 범용 AI 코딩 | 터미널 AI | Git 작업 자동화 | IDE AI 보조 |
| 배포 대상 | Google Cloud | 로컬/직접 | 로컬 터미널 | 로컬 | 로컬 IDE |
| Eval 기능 | 내장 | 별도 구성 | 미지원 | 미지원 | 미지원 |
| Skills 시스템 | 공식 저장소 보유 | Skills API 지원 | MCP 연동 | 없음 | 없음 |
| 라이선스 | Apache 2.0 (무료) | $20/월~ | 무료 | GitHub Copilot 유료 | $20/월~ |
| 멀티 에이전트 | 네이티브 지원 | 조건부 | 조건부 | 미지원 | 미지원 |
결론: Google Agents CLI는 Google Cloud ADK 배포에 특화된 도구입니다. 다른 코딩 에이전트를 대체하는 것이 아니라, 그 위에 얹어서 사용하는 구조입니다.
1인 기업/소규모 팀을 위한 실전 활용 시나리오
시나리오 1: 고객 CS 자동화 에이전트 배포
기존 방식으로 ADK 에이전트를 Google Cloud에 배포하려면 배포 설정 수작업에 수 시간에서 수 일이 걸렸습니다.
Google Agents CLI를 활용하면 이렇게 됩니다.
1. Claude Code에 ADK Skills 설치 — 1분
2. 자연어: "고객 CS 에이전트 만들어줘" — 5분 (scaffold)
3. 로컬 eval로 동작 검증 — 10분
4. agents-cli deploy → Google Cloud — 5분
─────────────────────────────────────────
총 소요 시간: 약 20분 (기존 대비 약 80% 단축)
DEV Community 튜토리얼(출처 10)에서 30분 이내 프로토타입→프로덕션 워크플로우가 검증된 패턴입니다.
시나리오 2: 기존 콘텐츠 자동화 파이프라인의 Google Cloud 이식
현재 로컬이나 별도 서버에서 실행하는 자동화 파이프라인을 Google Cloud ADK 에이전트로 이식하고, agents-cli publish gemini-enterprise로 팀 내 공유 에이전트화할 수 있습니다.
시나리오 3: Claude Code + Google Agents CLI 하이브리드
- Claude Code: 비즈니스 로직 구현 (강점)
- Google Agents CLI: Google Cloud 배포 자동화 (강점)
두 도구의 강점을 조합하면, 30분 내 프로토타입→프로덕션 워크플로우가 가능합니다.
주의사항 — 균형 잡힌 시각으로
Google Agents CLI를 도입하기 전에 반드시 확인해야 할 점들입니다.
비용 구조
- Google Agents CLI 자체는 무료(Apache 2.0)
- 그러나 배포 대상인 Google Cloud 서비스(Agent Runtime, Cloud Run, GKE)는 사용량에 따라 비용 발생
- 소규모 프로젝트는 Google Cloud 프리 티어로 시작 가능하나, 프로덕션 트래픽은 비용 설계 필수
Google Cloud lock-in 리스크
- Google Cloud에 특화된 도구인 만큼, 향후 다른 클라우드(AWS, Azure)로 이전 시 재작업 필요
- ADK 에이전트 자체는 Python 표준이므로 일부 이식성은 유지됨
학습 곡선
- ADK(Agent Development Kit) 개념 이해 필요
- A2A(Agent-to-Agent) 통신, 멀티 에이전트 아키텍처에 대한 기초 학습 권장
OS 제한
- Windows 네이티브 미지원
- Windows 사용자는 WSL 2 환경에서만 사용 가능
결론 — 언제 써야 할까?
Google Agents CLI는 다음 상황에 적합한 도구입니다.
써야 할 때
- Google Cloud를 주 배포 환경으로 사용하는 경우
- ADK 기반 AI 에이전트를 반복적으로 빌드·배포해야 하는 경우
- Claude Code 또는 Gemini CLI와 함께 AI 에이전트 워크플로우를 구성하려는 경우
- 배포 자동화와 eval 파이프라인이 필요한 경우
신중히 검토할 때
- Google Cloud 외 클라우드(AWS, Azure)를 주로 사용하는 경우
- ADK를 처음 접하는 경우 (학습 비용 고려)
- 프로덕션 트래픽 규모가 큰 경우 (비용 설계 선행 필요)
2026년 현재 AI 에이전트 개발이 빠르게 주류화되는 시점에서, Google Agents CLI는 Google Cloud 생태계 안에서 에이전트를 빠르게 프로덕션화하려는 개발자와 1인 기업에게 가치 있는 도구입니다.
공식 GitHub: github.com/google/agents-cli 공식 문서: google.github.io/agents-cli
참고 자료
- Google Agents CLI — GitHub 공식 저장소 (Tier 0, 2026-05-08)
- Google Agents CLI — 공식 문서 (Tier 0, 2026-05-08)
- Google Developers Blog — Create to Production in One CLI (Tier 0, 2026-05-08)
- Google Cloud Docs — ADK Quickstart (Tier 0, 2026-05-08)
- InfoQ — Google Agents CLI 분석 (Tier 1, 2026-05-08)
- DEV Community — Claude Code + agents-cli 30분 튜토리얼 (Tier 2, 2026-05-08)
