구글 Android CLI 1.0 공개, 에이전트 개발 판도는 바뀌나
GUI를 열지 않아도 Gradle 빌드, Compose 프리뷰, UI 테스트가 터미널에서 이어진다면 개발자와 에이전트의 역할은 어디까지 바뀔까요?
이 아티클의 핵심 내용 요약과 글로벌 검색·AI 엔진을 위한 테이크어웨이입니다.
✦ KR 주제: 구글의 에이전트 전용 CLI 확산
✦ KR 핵심 요약: 구글은 Android CLI 1.0과 Agents CLI를 통해 GUI 중심 개발을 터미널·에이전트 중심으로 옮기고 있다. 확인된 범위에서는 안드로이드 빌드·배포·프리뷰·UI 테스트와 Cloud 에이전트 배포·인증이 핵심이다. Threads가 말한 gemini-api CLI의 미디어 생성 기능은 보강 자료에서 확인되지 않아 별도 검증이 필요하다.
🌐 Global Takeaway: Google is moving agent workflows from GUI apps toward terminal CLIs: Android CLI 1.0 exposes build, deploy, preview, and headless UI testing, while Agents CLI deploys agents to Agent Runtime with managed identity. Treat media-generation CLI claims as unverified until official docs confirm them.
아래 그림은 Android CLI 1.0이 프로젝트 생성부터 기기 배포까지 이어지는 흐름을 보여줍니다.
1. 현상과 확인 범위
구글이 에이전트 전용 개발 도구를 잇달아 내놓으면서, “AI가 코드를 쓰는 시대”의 다음 질문은 ‘코드를 어디서 실행하고 검증할 것인가’로 옮겨가고 있다. 이번에 확인 가능한 핵심은 두 개다. 첫째, 안드로이드 개발을 GUI 없이 터미널에서 수행하게 하는 Android CLI 1.0이다. 둘째, Google Cloud의 Agent Platform에서 에이전트를 만들고 배포하는 Agents CLI, 즉 google-agents-cli다.
다만 수집 소스인 Threads 글은 ‘gemini-api’라는 이름의 CLI가 이미지·영상·음성·음악 생성과 미디어 분석까지 담당한다고 주장한다. 이 내용은 흥미롭지만, 제공된 보강 자료에는 해당 이름과 기능 목록이 직접 확인되지 않는다. 따라서 이 글에서는 공식 근거가 있는 Android CLI 1.0과 Agents CLI를 중심으로 해석한다.
1-1. 확인된 사실
| 항목 | 내용 |
|---|---|
| Android CLI 1.0 | 안드로이드 스튜디오 GUI 없이 터미널에서 프로젝트 생성, 빌드, 배포, UI 테스트를 수행 |
| 스캐폴딩 | Gradle 설정, 매니페스트, Compose 보일러플레이트를 포함한 신규 프로젝트 생성 |
| 빌드·배포 | Gradle 빌드로 APK/AAB를 만들고 에뮬레이터 또는 실제 기기에 배포 |
| 프리뷰 | Jetpack Compose UI의 시각적 프리뷰를 헤드리스로 렌더링 |
| UI 테스트 | Espresso와 Compose UI Test를 GUI 없이 실행 |
| Agents CLI | google-agents-cli와 ADK로 Agent Runtime에 에이전트 빌드·테스트·배포 |
| 인증 | Agent Identity를 통해 관리형 ID로 Google Cloud 서비스 인증 |
프리뷰·GA 이전 기능은 ‘있는 그대로’ 제공될 수 있고 지원이 제한될 수 있다는 점이 공식 문서의 공통 주의다. 실험적 도구일수록 명령 성공과 프로덕션 안정성을 분리해서 봐야 한다.
2. 왜 GUI를 빼는가
Android CLI 1.0의 의미는 단순히 명령어를 추가한 데 있지 않다. 안드로이드 스튜디오의 무거운 IDE 화면을 열지 않아도, 에이전트가 필요한 정적 분석 엔진, Compose 렌더러, 의존성 해결 도구를 표준 셸 명령으로 호출할 수 있게 만든 점이 핵심이다. 즉 GUI는 사람의 진입점이었지만, 에이전트에게는 오히려 호출 비용과 상태 확인 비용이 큰 계층이었다.
이 변화는 개발 자동화의 기준을 바꾼다. 사람이 메뉴를 클릭하고 로그를 눈으로 찾던 루프 대신, 에이전트가 명령을 실행하고 결과를 파일·로그·테스트 리포트로 받아 다음 행동을 정할 수 있다. 특히 Compose 프리뷰 렌더링이 들어가면 ‘코드만 보고 UI를 상상하는’ 단계가 줄어든다. 에이전트가 레이아웃을 직접 확인하고 수정 후보를 다시 만들 수 있기 때문이다.
3. Android CLI 1.0의 작업 범위
3-1. 스캐폴딩부터 배포까지
Android CLI 1.0은 프로젝트 생성, 빌드, 배포를 하나의 라이프사이클로 묶는다. 신규 프로젝트는 Gradle 설정과 매니페스트, Compose 보일러플레이트를 포함해 터미널에서 바로 시작할 수 있다. 이후 Gradle 빌드가 APK 또는 AAB를 만들고, 연결된 에뮬레이터나 실제 기기에 배포한다. 이 흐름은 ‘에이전트가 코드를 쓴 뒤 사람이 IDE를 열어 빌드 버튼을 누른다’는 기존 루프를 대체하는 방향이다.
3-2. 프리뷰와 UI 테스트의 역할
더 중요한 차이는 검증 단계다. Android Studio를 열지 않고 Jetpack Compose UI의 시각적 프리뷰를 생성하면, 에이전트는 레이아웃이 깨졌는지, 컴포넌트가 예상 위치에 있는지를 코드 문자열이 아니라 렌더 결과로 확인할 수 있다. 이어서 Espresso와 Compose UI Test를 헤드리스로 실행하면 사용자 관점의 클릭·입력·전환 시나리오를 자동으로 검증할 수 있다.
이 두 기능이 결합되면 반복 속도가 달라진다. 코드 변경 → Compose 프리뷰 확인 → UI 테스트 → 실패 지점 수정의 순환이 IDE 실행 시간 없이 짧아질 수 있다. 다만 프리뷰 렌더링과 헤드리스 테스트가 실제 기기 환경의 모든 변수, 특히 성능·센서·권한·네트워크 상태를 완전히 대체하지는 않는다. 그래서 실제 기기 배포 단계는 여전히 필요하다.
4. Agents CLI와 Cloud 배포
4-1. 설치와 프로토타입 생성
Android CLI가 ‘앱을 만드는 손’이라면, Agents CLI는 ‘에이전트를 운영 환경에 올리는 손’에 가깝다. 공식 문서와 Codelab 기준으로 google-agents-cli는 Agent Development Kit(ADK)과 함께 Gemini Enterprise Agent Platform의 Agent Runtime에서 에이전트를 빌드, 테스트, 배포하는 데 사용된다. 설치와 프로젝트 생성은 uv와 uvx 명령으로 안내된다.
pip install uv
uvx google-agents-cli setup
uvx google-agents-cli create AGENT_PROJECT --prototype --yes
Codelab은 도구 설치부터 Google Cloud 에이전트 런타임에서 라이브 에이전트를 갖추기까지 1시간 이내를 목표로 안내한다. 다만 이는 학습용 가이드의 완주 시간이지, 모든 기업 환경의 배포 SLA는 아니다.
4-2. 필요한 API와 인증 경계
에이전트를 배포하려면 Agent Identity API, Agent Platform API, Agent Registry API, App Hub API가 필요할 수 있다. 문서상 API 사용 설정에는 serviceusage.services.enable 권한이 필요하고, 프로젝트 소유자는 roles/owner로 이미 가질 수 있지만 그렇지 않으면 serviceusage.serviceUsageAdmin 같은 역할 부여가 필요하다. 배포 후에는 roles/aiplatform.user 같은 Agent Platform 사용자 역할도 확인 대상이다.
인증 측면에서 Agent Identity의 가치는 크다. 배포된 에이전트가 수동 사용자 인증 정보 관리 없이 관리형 ID로 Google Cloud 서비스에 인증할 수 있기 때문이다. 다만 ‘관리형 ID’가 곧 ‘권한 제한 없음’을 뜻하지는 않는다. 어떤 리소스에 접근할 수 있는지는 IAM 설계와 에이전트 아이덴티티 정책에 달려 있다.
5. 수치와 비교로 보는 의미
자료에서 확인되는 숫자는 크지 않지만 방향은 분명하다. Android CLI 1.0은 안정화 버전으로 소개됐고, Agents CLI Codelab은 1시간 이내 배포를 안내한다. 반대로 Threads의 gemini-api CLI는 프리뷰라고만 표현됐고, 보강 자료에는 미디어 생성 기능을 확인할 수 있는 공식 문서가 없다. 따라서 ‘구글이 모든 생성을 한 CLI로 묶었다’는 서술은 아직 과도하다.
비교하면 기존 방식은 모델 이름을 찾고, 일회용 스크립트를 짜고, curl로 API를 붙잡는 수작업이 많았다. 확인된 CLI 방식은 명령 단위로 개발·배포·테스트를 표준화한다. 다만 자동화가 늘어날수록 실패 원인 추적, 권한 범위, 로그 보존, 롤백 기준이 더 중요해진다.
| 구분 | 기존 GUI·수동 방식 | 확인된 CLI 방식 |
|---|---|---|
| 진입점 | IDE 메뉴·수동 명령 | 터미널·에이전트 명령 |
| 빌드 | 사람이 Gradle 또는 IDE 실행 | 에이전트가 CLI로 실행 |
| UI 확인 | 스튜디오 프리뷰 또는 실기기 | Compose 프리뷰 렌더링 |
| 테스트 | IDE 또는 별도 설정 | Espresso·Compose UI Test 헤드리스 |
| 배포 | 수동 전송·설정 | 에뮬레이터·실기기에 직접 배포 |
| 리스크 | 사람의 클릭 실수 | 권한·로그·롤백 설계 필요 |
6. 도입 순서와 주의점
실무 도입은 한 번에 모든 것을 바꾸기보다 단계적으로 가는 편이 안전하다. 먼저 Agents CLI로 로컬 프로토타입을 만들고, 작은 범위의 도구 호출과 평가를 확인한 뒤 Agent Runtime 배포로 넘어간다. 안드로이드 쪽은 새 프로젝트 하나를 스캐폴딩하고, Gradle 빌드와 에뮬레이터 배포를 통과시킨 다음 Compose 프리뷰와 UI 테스트를 붙인다. 실제 기기 단계는 권한·성능·네트워크 변수를 포함해 별도로 검증한다.
6-1. 첫 주에 확인할 것
- 프로젝트 생성 명령이 기대한 디렉터리 구조를 만드는지 확인한다
- 빌드 산출물이 APK인지 AAB인지 배포 대상에 맞는지 확인한다
- Compose 프리뷰가 실제 화면 의도와 얼마나 가까운지 샘플 화면으로 검증한다
- UI 테스트 실패 시 로그가 에이전트가 다음 수정을 할 만큼 구체적인지 본다
- 배포 전후 IAM 권한과 비용 발생 지점을 문서화한다
6-2. 하지 말아야 할 가정
프리뷰 렌더링이 모든 UI 결함을 잡는다고 가정하면 안 된다. 헤드리스 테스트가 실제 사용자 환경의 지연, 배터리, 알림, 접근성 문제를 모두 재현하지도 않는다. 또 Agents CLI가 에이전트의 ‘품질’을 자동 보장하지는 않는다. 좋은 프롬프트, 도구 권한 최소화, 평가 지표, 사람의 승인 지점이 함께 있어야 한다.
7. 요약
구글의 이번 움직임은 AI 에이전트를 ‘코드 생성기’에서 ‘실행 가능한 개발 파이프라인 참가자’로 끌어올리는 신호다. Android CLI 1.0은 안드로이드 개발의 생성·빌드·프리뷰·테스트·배포를 터미널 명령으로 묶고, Agents CLI는 Cloud Agent Runtime에서 에이전트를 배포하고 관리형 인증으로 연결한다. 반면 Threads가 언급한 gemini-api CLI의 미디어 생성 기능은 아직 공식 근거가 부족하므로, 확인 전에는 ‘소문’과 ‘문서화된 기능’을 분리해 봐야 한다.
결국 중요한 것은 명령어가 많아졌느냐가 아니라, 에이전트가 만든 결과를 어떤 렌더·테스트·권한·로그로 검증하느냐다. CLI가 표준화되면 개발자는 더 적은 클릭을 하지만, 더 정확한 검증 설계와 운영 책임을 떠안게 된다.
자주 묻는 질문
Q. Android CLI 1.0은 무엇을 하나요?
A. 안드로이드 스튜디오 GUI 없이 터미널에서 프로젝트 생성, Gradle 빌드, APK/AAB 생성, 에뮬레이터·실기기 배포, Compose 프리뷰, Espresso·Compose UI Test 실행을 가능하게 합니다.
Q. Agents CLI와 Android CLI는 같은 도구인가요?
A. 아닙니다. Android CLI 1.0은 안드로이드 앱 개발 라이프사이클을 다루고, Agents CLI(google-agents-cli)는 Google Cloud Agent Platform에서 에이전트를 만들고 배포하는 데 초점이 맞춰져 있습니다.
Q. gemini-api CLI는 공식적으로 확인됐나요?
A. Threads 소스는 gemini-api라는 CLI의 이미지·영상·음성 생성 등을 주장하지만, 제공된 보강 자료에서는 해당 이름과 기능을 확인할 수 없습니다. 공식 문서 확인 전까지는 미검증 주장으로 보는 것이 안전합니다.
Q. 바로 프로덕션에 써도 되나요?
A. 바로 단정하기 어렵습니다. 공식 문서는 GA 이전 기능이 ‘있는 그대로’ 제공되고 지원이 제한될 수 있다고 안내합니다. 소규모 프로젝트, 권한 최소화, 테스트·로그·롤백 기준을 먼저 갖춘 뒤 단계적으로 확대하는 편이 좋습니다.
원본
https://www.threads.com/@escape.salary/post/De0K9diE4LS
https://github.com/roomedia/ax-trend/issues/630
https://codelabs.developers.google.com/agents-cli-agent-platform/agents-cli-agent-platform?hl=ko



댓글 0개