Gemini CLI, 드디어 "팀"을 만들다 — 서브에이전트 기능 출시 총정리

혼자 일하던 AI가 팀을 꾸렸습니다

2026년 4월 15일, Google이 공식 개발자 블로그를 통해 Gemini CLI에 서브에이전트(Subagent) 기능을 도입했다고 발표했습니다.

"Subagents allow Gemini CLI to delegate complex, repetitive, or high-volume tasks to specialized expert agents."

— Google Developers Blog, "Subagents have arrived in Gemini CLI" (2026.4.15)

이 기능은 이튿날인 4월 16일 릴리스된 Gemini CLI v0.38.1에 공식 포함되었습니다.

지금까지 Gemini CLI는 하나의 AI가 모든 질문과 작업을 혼자 처리하는 구조였습니다. 코드를 짜다가 문서를 검색하고, 테스트를 돌리고, 다시 코드를 수정하는 과정이 전부 하나의 대화창 안에서 일어났습니다. 대화가 길어질수록 AI가 앞에서 한 이야기를 잊거나, 엉뚱한 맥락을 끌어오는 문제가 생겼습니다.

서브에이전트는 이 문제를 구조적으로 해결합니다. 메인 AI가 팀장 역할을 맡고, 전문 분야별 팀원(서브에이전트)에게 일을 나눠주는 방식입니다.

---

요약: 핵심만 빠르게

1. 서브에이전트가 뭔가요?

메인 Gemini CLI 세션 안에서 동작하는 전문가 AI입니다. 공식 문서의 표현을 빌리면 "메인 에이전트가 특정 업무를 위해 고용하는 전문가(specialists that the main Gemini agent can hire for a specific job)"입니다.

출처: Gemini CLI 공식 문서 — Subagents

2. 왜 필요한가요?

Google Developers Blog에서 밝힌 세 가지 핵심 이점은 다음과 같습니다.

첫째, 메인 AI가 전체 방향과 판단에 집중할 수 있습니다.
둘째, 여러 전문가가 동시에 일하니 속도가 빨라집니다.
셋째, 중간 과정의 잡다한 정보가 메인 대화를 오염시키지 않습니다.

3. 기본으로 뭐가 들어있나요?

GitHub 릴리스 노트에 따르면, @cli_help, @codebase_investigator, @generalist 3종이 기본 탑재되어 있습니다. 공식 문서에는 실험적 기능인 browser_agent(웹 브라우저 자동화)도 포함되어 총 4종입니다.

에이전트	역할
@generalist	모든 도구 사용 가능한 범용 에이전트. 대량 리팩토링, 다수 파일 수정에 적합
@cli_help	Gemini CLI 자체 기능/문서에 특화된 도움말 에이전트
@codebase_investigator	코드베이스 탐색, 아키텍처 매핑, 버그 원인 분석 전문
@browser_agent (실험적)	Chrome 브라우저 직접 조작 — 웹 탐색, 폼 작성, 정보 추출

출처: GitHub Discussions #25562, Gemini CLI 공식 문서 — Browser Agent

4. 나만의 전문가도 만들 수 있나요?

네. 마크다운 파일 하나만 작성하면 됩니다.

이름, 역할 설명, 사용 가능한 도구, 성격(시스템 프롬프트)을 정의하면 Gemini CLI가 즉시 새로운 팀원으로 인식합니다.

5. 어떻게 일을 시키나요?

@에이전트이름으로 직접 지목하거나, 그냥 자연어로 요청하면 메인 AI가 가장 적합한 서브에이전트를 자동으로 골라서 위임합니다.

6. 동시에 여러 명한테 시킬 수 있나요?

네. 병렬 실행을 지원합니다. 다만 공식 블로그는 주의사항도 함께 안내합니다.

---

v0.38.1에서 함께 추가된 주요 기능

서브에이전트 외에도 이번 릴리스에는 주목할 만한 변경사항이 함께 포함되었습니다.

기능	설명
컨텍스트 압축 서비스	긴 세션에서 대화 이력을 효율적으로 압축하여 토큰을 절약하고 집중도를 유지합니다.
역할별 사용량 통계	/stats 명령어가 메인 에이전트, 서브에이전트, 유틸리티 함수별로 요청 수를 구분하여 보여줍니다.
입력 단축키 변경	기본 상호작용 단축키가 ctrl-x에서 ctrl+g로 변경되었습니다.
UI 깜빡임 개선	도구가 빠르게 업데이트될 때 발생하던 화면 깜빡임을 완화하는 "Terminal Buffer" 모드가 도입되었습니다.
새 확장 기능	Elastic(Elasticsearch 데이터 검색/분석), Auth0(인증 관리) 확장이 추가되었습니다.

출처: GitHub Discussions #25562, Gemini CLI Changelog

---

7. 누가 쓸 수 있나요?

Gemini CLI의 가격 및 사용량 정책에 따르면, 무료 티어에서도 서브에이전트 기능을 사용할 수 있습니다.

인증 방식	티어	하루 최대 요청 수
Google 계정 로그인	Gemini Code Assist (Individual)	1,000건 (무료)
Google 계정 로그인	Google AI Pro ($25/월)	1,500건
Google 계정 로그인	Google AI Ultra	2,000건
Gemini API Key	무료 (미결제)	250건
Gemini API Key	종량제 (결제)	유동적

서브에이전트가 내부적으로 도구를 호출할 때마다 요청이 소모되므로, 병렬 실행 시에는 사용량 모니터링이 중요합니다. /stats model 명령어로 실시간 확인할 수 있습니다.

출처: Gemini CLI — Quotas and Pricing

공식 참고 자료 모음

자료	링크
Google Developers Blog — 공식 발표	developers.googleblog.com
Gemini CLI 공식 문서 — Subagents	geminicli.com/docs/core/subagents
Gemini CLI v0.38.1 릴리스 노트	GitHub Discussions #25562
Gemini CLI Changelog (Latest Stable)	geminicli.com/docs/changelogs/latest
Gemini CLI 가격 및 사용량	geminicli.com/docs/resources/quota-and-pricing
GitHub 리포지토리	github.com/google-gemini/gemini-cli
Google Cloud Medium 튜토리얼	Part 1 · Part 2 · Part 3
Reddit 커뮤니티 반응	r/GeminiCLI