Google Agents CLI — 코딩 에이전트를 에이전트 빌더로 만드는 메타 도구

Google이 Cloud Next에서 공개한 agents-cli는 Gemini CLI, Claude Code, Codex 같은 코딩 에이전트에게 Google Cloud 기반 AI 에이전트를 설계하고 배포하는 전문 역량을 주입하는 CLI 도구입니다. 에이전트 그 자체가 아니라, 에이전트를 만드는 에이전트의 실력을 끌어올리는 레이어에 해당합니다. Google의 ADK(Agent Development Kit, 에이전트 개발 프레임워크)를 기반으로 하며, 프로젝트 생성부터 평가, 배포, 엔터프라이즈 등록까지 에이전트 개발의 전체 생명주기를 하나의 CLI로 다룹니다. 이 도구가 겨냥하는 지점은 SDK 코드 작성이 아닙니다. 수십 가지 컴포넌트 중 어떤 것을, 어떤 순서로, 어떤 설정으로 조합해야 하는지 판단하는 일이 실제 병목이라는 인식에서 출발합니다. 범용 코딩 에이전트는 이 조합을 추측하지만, Agents CLI는 숙련된 플랫폼 엔지니어 수준의 판단을 코딩 에이전트에 내재화하는 방식을 택하고 있습니다. "무엇을 했는지"뿐 아니라 "왜 그렇게 결정했는지"를 코딩 에이전트가 함께 설명하도록 설계되어, 팀원의 플랫폼 이해도도 함께 올라가는 구조를 지향합니다. MCP 문서, ADK 문서, gcloud 문서, Runtime 문서 등 네 곳 이상에 흩어진 정보를 하나의 도구로 수렴시켜 탐색 비용을 줄이겠다는 의도도 읽힙니다.

핵심 구조

• 설치는 uvx google-agents-cli setup 한 줄이면 됩니다. Python 3.11 이상, uv(Python 패키지 매니저), Node.js가 필요합니다
• 7종의 "스킬"을 코딩 에이전트에 주입하는 방식으로 동작합니다. 워크플로우 설계, ADK 코드 작성, 프로젝트 스캐폴딩(뼈대 자동 생성), 평가(LLM-as-judge 방식 포함), 배포(Agent Runtime, Cloud Run, GKE), Gemini Enterprise 퍼블리싱, 관측성(Observability, 로그와 트레이스로 시스템 상태를 파악하는 체계)을 각각 담당합니다
• 도구 연결(Tool Wiring)에서 MCP(Model Context Protocol, 모델이 외부 도구를 호출하는 표준), A2A(Agent-to-Agent, 에이전트 간 통신 프로토콜), 커넥터를 지원합니다
• 로컬 개발은 AI Studio API 키만으로 가능하고, 클라우드 배포 시에만 Google Cloud 계정이 필요합니다
• 기존 에이전트 프로젝트에도 scaffold enhance 명령으로 배포 설정과 CI/CD 파이프라인(코드 변경을 자동으로 테스트·배포하는 체계)을 사후 추가할 수 있습니다
• 코딩 에이전트 없이 터미널에서 독립 실행도 가능합니다

차별점

• 특정 코딩 에이전트에 종속되지 않습니다. Gemini CLI, Claude Code, Codex, Antigravity 어디든 스킬만 주입하면 동작하므로, 개발자의 도구 선택권을 침해하지 않습니다
• ADK라는 프레임워크, Agent Runtime이라는 실행 환경, Agent Sandbox라는 격리 계층, Gemini Enterprise라는 배포 채널을 하나의 명령어 체계로 엮었다는 점에서, 단순 CLI를 넘어 Google Cloud 에이전트 스택 전체의 프론트도어 역할을 합니다
• 블랙박스식 자동화가 아닌 의사결정 근거를 함께 노출하는 "discovery-first"(발견 우선) 설계를 택하고 있습니다

시사점

• "코딩 에이전트가 에이전트를 만든다"는 구조는 개발자 워크플로우가 에이전트 중심으로 이동하고 있음을 보여주는 사례입니다. 다만 현재 Pre-GA(정식 출시 전) 단계이며, 소스코드가 아닌 사전 빌드된 .whl 파일(Python 패키지 배포 형식)로만 배포되고 있어, 오픈소스 커뮤니티의 직접적인 코드 기여는 제한됩니다
• Google Cloud 에이전트 생태계에 대한 진입 장벽을 낮추는 데 초점이 맞춰져 있으므로, 멀티클라우드 환경이나 비-Google 스택을 주로 사용하는 팀에게는 적용 범위가 제한될 수 있습니다
• 흩어진 문서와 도구를 하나로 수렴시키려는 시도 자체는 의미가 있으나, 그만큼 이 도구 하나에 대한 의존도가 높아질 수 있다는 점은 엔지니어링 조직 차원에서 고려할 부분입니다