Google agents-cli v0.6.1, 에이전트 수명주기를 상태 머신으로 표준화하다

Google이 2026년 4월 21일 배포한 agents-cli는 71일 만에 13회 업데이트를 거쳐 v0.6.1(2026년 6월 28일)에 이르렀다. 평균 5.5일마다 새 버전이 나온 셈인데, 각 릴리즈는 마이너 버그 픽스보다 신규 인터그레이션과 아키텍처 개선에 집중됐다. 이번 버전은 Agent Development Kit(ADK) 2.3.0을 번들링하면서 Claude Code, Antigravity 2.0과의 에이전트 수명주기 통합을 공식 지원하기 시작했다. 에이전트 시작·모니터링·종료로 이어지는 수명주기 관리가 멀티에이전트 시스템 운영의 핵심 역량으로 떠오른 지금, 이 정도 업데이트 케이던스는 Google이 agents-cli를 단순한 개발자 도구가 아니라 전략적 플랫폼으로 밀고 있다는 신호로 읽힌다.

v0.6.1의 변화

agents-cli는 원래 Google Cloud의 Vertex AI 에이전트 생태계와 로컬 개발 환경을 잇는 CLI 도구였다. v0.6.1에서 달라진 지점은 크게 두 가지다. 먼저 ADK 2.3.0을 내장 번들로 패키징해 별도 SDK 설치 없이 에이전트 개발 환경을 완성할 수 있게 됐다. 그리고 Claude Code·Antigravity 2.0에 대한 에이전트 수명주기 통합 API를 공식 지원해, Google 생태계 밖에서 동작하는 에이전트와도 크로스플랫폼으로 연동할 수 있게 됐다.

ADK 2.3.0의 핵심은 에이전트 수명주기 관리 API를 통째로 다시 짠 것이다. 기존 ADK에서 에이전트의 시작·종료는 단순한 프로세스 호출에 가까웠지만, 2.3.0부터는 상태 머신(State Machine) 기반 모델이 들어왔다. 에이전트는 INITIALIZING, READY, RUNNING, SUSPENDED, TERMINATING, TERMINATED 6단계 상태를 명시적으로 거치며, 각 전환 구간에 이벤트 훅(event hook)을 걸 수 있다.

READY와 RUNNING을 오가는 상태 머신

ADK 2.3.0의 수명주기는 이벤트 기반 오케스트레이션 패턴을 따른다. 오케스트레이터가 에이전트의 상태 전환을 중앙에서 관리하고, 각 에이전트는 자신의 상태를 헬스체크 엔드포인트로 노출한다.

⤢✕

핵심은 READY와 RUNNING 사이의 순환이다. 에이전트는 작업을 끝내도 바로 종료되지 않고 READY로 돌아가 다음 작업을 기다린다. 프로세스 콜드 스타트 비용을 없애고, 멀티에이전트 시스템에서 태스크를 빠르게 재할당하기 위한 설계다.

헬스체크는 세 계층으로 나뉜다. 프로세스가 살아있는지 보는 생존 확인(liveness check), 실제로 작업을 수행할 수 있는 상태인지 보는 준비 상태 확인(readiness check), 토큰 처리량·평균 응답 시간·오류율을 실시간 수집하는 성능 지표(performance metrics)다. agents-cli monitor 명령은 이 세 계층 데이터를 통합해 터미널 대시보드로 보여준다.

Claude Code·Antigravity와 이어지는 길

v0.6.1에서 가장 눈에 띄는 기능은 Claude Code와 Antigravity 2.0에 대한 에이전트 수명주기 통합이다. 예전에는 Google ADK 에이전트와 타사 AI 에이전트를 함께 운용하려면 별도의 브릿지 레이어를 직접 만들어야 했지만, 이제는 agents-cli가 이를 내장 지원한다.

연동은 Agent Communication Protocol(ACP) 위에 세워진다. ACP는 에이전트 간 메시지 포맷과 수명주기 이벤트 교환 방식을 표준화한 프로토콜로, Google이 2026년 초 Anthropic·OpenAI와 함께 초안을 작성했다. agents-cli v0.6.1은 ACP v1.2를 구현하며, Claude Code의 MCP(Model Context Protocol) 레이어와 Antigravity 2.0의 멀티에이전트 워크스페이스 API를 ACP 어댑터로 노출한다.

실제 흐름은 이렇다. agents-cli connect --platform claude-code --session <session-id> 명령을 실행하면 Claude Code 세션에 ACP 어댑터가 바인딩되고, 이후 ADK 오케스트레이터는 Claude Code 에이전트를 마치 내부 ADK 에이전트처럼 수명주기를 관리할 수 있다. 태스크 할당, 상태 모니터링, 정상 종료(graceful shutdown)가 하나의 제어 평면(control plane)에서 이뤄진다. Antigravity 2.0과의 연동은 여기에 멀티에이전트 병렬 워크스페이스 기능이 더해지는데, Antigravity의 레인(lane) 개념이 ADK의 에이전트 풀(agent pool)에 매핑되어 여러 에이전트가 독립 워크스페이스에서 병렬로 작업하는 동안 agents-cli가 전체 수명주기를 중앙에서 조율한다.

도입 절차와 CI/CD 파이프라인

agents-cli v0.6.1을 들여올 때 가장 먼저 해야 할 일은 ADK 2.3.0 업그레이드 호환성 검증이다. ADK 2.2.x에서 2.3.0으로 넘어가면 에이전트 상태 모델 자체가 바뀌므로, 기존 에이전트 코드의 수명주기 이벤트 핸들러를 새 API에 맞춰 마이그레이션해야 한다. agents-cli migrate --dry-run 서브커맨드가 실제 변경 전에 호환성 문제를 미리 짚어준다.

개발·배포·모니터링을 아우르는 CI/CD 파이프라인은 네 단계로 짜인다. 개발 단계에서는 agents-cli dev 모드로 로컬에서 수명주기를 시뮬레이션하는데, 실제 Vertex AI 연결 없이 상태 전환과 이벤트 처리를 테스트할 수 있는 인메모리 오케스트레이터가 딸려온다. 빌드 단계에서는 agents-cli build --validate 플래그로 에이전트 명세의 구조적 유효성을 검증하고 의존 패키지 취약점을 스캔한다.

배포 단계는 블루-그린 전략이 권장된다. agents-cli deploy --strategy blue-green --health-threshold 95 형태로 실행하면 신규 버전 에이전트가 트래픽의 10%부터 점진적으로 받으면서, 헬스체크 기준(95% 이상)을 충족할 때만 트래픽 비율을 높인다. 기준 미충족 시에는 자동 롤백이 걸린다. 모니터링 단계에서는 agents-cli monitor --export prometheus 옵션으로 Prometheus 메트릭을 노출해 Grafana 대시보드와 연동하며, 에이전트 상태별 체류 시간(state dwell time), 태스크 완료율, P95 응답 지연이 핵심 모니터링 지표다.

Claude Code와 Codex CLI를 함께 운용하는 구성에서는 역할 분리가 관건이다. Claude Code는 코드 생성·리뷰·리팩토링에, Codex CLI는 코드 실행·테스트·환경 조작에 특화 배치한다. agents-cli는 태스크 성격에 따라 적절한 에이전트로 자동 라우팅하는 정책 엔진을 내장하고 있어, agents-cli policy set --rule "code_review -> claude-code" --rule "test_execution -> codex" 형태로 라우팅 규칙을 선언적으로 정의할 수 있다.

플랫폼별 수명주기 관리, 나란히 놓고 보면

항목	Google agents-cli v0.6.1	Anthropic Claude Code	OpenAI Codex CLI
상태 모델	6단계 명시적 상태 머신	세션 기반 암묵적 상태	태스크 기반 단순 상태
헬스체크	3계층 (생존/준비/성능)	세션 상태 + 토큰 한도	프로세스 생존 확인
크로스플랫폼 연동	ACP v1.2 공식 지원	MCP 기반 제한적 연동	REST API 직접 연동
오케스트레이션	중앙 집중형 오케스트레이터	에이전트 자율 조율	단일 에이전트 중심
CI/CD 통합	블루-그린 내장 지원	외부 도구 의존	외부 도구 의존
모니터링 내보내기	Prometheus/OpenTelemetry	로그 기반	로그 기반
릴리즈 케이던스	5.5일/릴리즈 (71일 13회)	격주 정기 릴리즈	월간 릴리즈

Google agents-cli는 엔터프라이즈급 수명주기 관리에서 가장 성숙한 기능 집합을 갖췄다. 특히 6단계 상태 머신과 3계층 헬스체크는 대규모 멀티에이전트 운영에서 장애를 격리하고 빠르게 복구하는 데 유리하다.

Claude Code는 에이전트 자율성과 유연성이 강점이다. 스스로 서브태스크를 쪼개고 병렬 서브에이전트를 만드는 패턴은 탐색적 코드 작업에 특히 잘 맞는다. 다만 중앙 집중형 수명주기 관리 기능이 없다 보니, 에이전트 수십 개를 동시에 굴리는 시나리오에서는 운영 복잡도가 급격히 올라간다.

Codex CLI는 코드 실행·환경 조작에 특화된 단일 에이전트 모델이다. 수명주기 관리 기능은 가장 단순하지만, 단순한 코드 생성·실행 파이프라인에서는 이 단순함이 오히려 운영 오버헤드를 낮춰준다. 멀티에이전트 시나리오라면 agents-cli의 라우팅 정책으로 Codex CLI를 특화 서브에이전트로 편입하는 패턴이 권장된다.

세 플랫폼을 함께 굴리는 실용적인 구성은 agents-cli를 오케스트레이션 레이어로, Claude Code와 Codex CLI를 특화 실행 레이어로 두는 계층 구조다. 여기서 agents-cli는 태스크 라우팅·수명주기 관리·통합 모니터링을, Claude Code는 자연어 이해와 코드 생성·리뷰를, Codex CLI는 격리된 코드 실행 환경을 담당한다.

크로스플랫폼 연동에서 보안이 놓치기 쉬운 지점

에이전트 수명주기를 여러 플랫폼에 걸쳐 통합 운영하면, 각 플랫폼의 인증 컨텍스트가 뒤섞이기 쉽다. 그래서 에이전트 간 통신에는 최소 권한 원칙(principle of least privilege)이 반드시 적용돼야 한다. agents-cli v0.6.1은 에이전트별 서비스 계정 바인딩을 지원하고, ACP 채널 암호화에 mTLS를 쓴다.

운영 환경에서 흔히 겪는 문제는 SUSPENDED 상태의 에이전트가 장기간 메모리를 붙잡고 있는 경우다. agents-cli gc --max-suspend-time 3600 명령으로 일정 시간 이상 SUSPENDED를 유지한 에이전트를 자동 종료하는 가비지 컬렉션 정책을 걸 수 있다. 로그 중앙화도 중요한데, 각 플랫폼이 독립된 로그 형식을 쓰다 보니 OpenTelemetry 기반 통합 로그 수집 파이프라인을 구성해 분산 추적이 가능하도록 설계해야 한다. agents-cli monitor --otel-endpoint <collector-url> 옵션으로 OpenTelemetry Collector에 메트릭과 트레이스를 바로 보낼 수 있다.

Google agents-cli v0.6.1은 에이전트 수명주기 관리를 멀티에이전트 시스템의 일급 시민으로 끌어올린 전환점이다. 6단계 상태 머신, 3계층 헬스체크, ACP v1.2 기반 크로스플랫폼 연동은 기업 환경이 요구하는 수준의 운영 가시성과 제어력을 제공한다. Claude Code·Codex CLI와의 통합 아키텍처로 각 플랫폼의 강점을 조합한 계층형 멀티에이전트 시스템을 짤 수 있게 된 만큼, 이제는 에이전트 수명주기 설계 역량 자체가 AI 엔지니어링 팀의 핵심 기술 스택으로 자리잡아야 할 시점이다.