Gemini CLI에 서브 에이전트가 드디어 찾아왔어요!

2026년 4월 15일

서브 에이전트는 Gemini CLI가 복잡하고 반복적이거나 대량의 작업을 전문 에이전트에게 위임할 수 있게 해주는 기능이에요. 각 서브 에이전트는 고유의 분리된 컨텍스트 윈도우, 맞춤형 시스템 지침, 그리고 선별된 도구 세트 안에서 작동해요. 덕분에 중간 단계 작업들은 서브 에이전트 팀에 맡겨지면서도, 여러분의 주 세션은 빠르고, 가볍고, 큰 그림에 집중할 수 있게 된답니다.

서브 에이전트가 뭐예요?

서브 에이전트는 주 Gemini CLI 세션과 함께 작동하는 전문화된 에이전트예요. Gemini CLI에 광범위하거나 복잡한 작업을 주면, Gemini CLI는 전략적 오케스트레이터 역할을 하면서 특정 하위 작업을 가장 관련성이 높은 서브 에이전트에게 위임하죠.

서브 에이전트는 각각 고유한 도구, MCP 서버, 시스템 지침, 그리고 _컨텍스트 윈도우_를 가지고 독립적으로 작동해요. 수십 개의 도구 호출, 파일 검색, 또는 테스트 실행이 포함될 수 있는 전체 실행 과정이 단일 응답으로 통합되어 주 에이전트에게 돌아와요. 이렇게 하면 주 컨텍스트 윈도우가 가득 차는 것을 막고, 이후 상호작용을 빠르고 비용 효율적으로 유지할 수 있어요.

서브 에이전트의 주요 장점:

• 주 에이전트가 전반적인 목표, 의사 결정, 그리고 _최종 응답_에 집중하도록 도와줘요.
• 연구, 코드 탐색, 분석, 테스트 등을 위해 전문 서브 에이전트를 병렬로 실행해서 작업 속도를 높여줘요.
• 서브 에이전트가 요약이나 형식화된 응답을 반환하기 때문에 주 에이전트 세션에서 컨텍스트 부패나 컨텍스트 오염을 피할 수 있어요.

맞춤형 서브 에이전트로 나만의 전문가를 만들어 보세요

여러분은 특정 워크플로우를 자동화하거나, 코딩 표준을 적용하거나, 프로젝트에 맞춰 특정 페르소나를 가진 나만의 전문 팀원(서브 에이전트)을 만들 수 있어요.

맞춤형 서브 에이전트는 YAML 프런트매터를 포함한 간단한 마크다운 파일(.md)을 사용해서 정의할 수 있어요. 개인 워크플로우를 위해 전역적으로 ~/.gemini/agents에 정의하거나, 팀과 공유하기 위해 프로젝트 수준에서 .gemini/agents에 저장소에 커밋할 수도 있어요.

서브 에이전트는 에이전트 정의 마크다운 파일(.md)을 확장 프로그램의 agents/ 디렉토리에 제공함으로써 Gemini CLI 확장 프로그램의 일부로 묶을 수도 있답니다.

여기 맞춤형 _프론트엔드 전문가 에이전트_를 만드는 예시를 보여드릴게요:

---
name: frontend-specialist
description: Frontend specialist in building high-performance, accessible, and
  scalable web applications using modern frameworks and standards.
tools:
  - read_file
  - grep_search
  - glob
  - list_directory
  - web_fetch
  - google_web_search
model: inherit
---

You are a Senior Frontend Specialist and UI/UX Architect. Your goal is to design
and implement exceptional, production-grade user interfaces that are both
beautiful and functionally robust. You prioritize modern best practices,
system-level architecture, and distinctive aesthetics.

### Core Principles:
- Architecture & Scalability: Design modular, maintainable, and scalable
  frontend architectures. Expert in component-driven development, state
  management patterns, and micro-frontends.
- Performance & Optimization: Prioritize speed and responsiveness. Deep
  knowledge of Core Web Vitals, rendering strategies (SSR, SSG, ISR, Hydration),
  bundle optimization, and caching.
- Accessibility (A11y): Ensure all interfaces are inclusive by default
  (WCAG 2.1+ compliance, semantic HTML, robust ARIA implementation, keyboard-
  first navigation).

### Guidelines:
- Browser-First Thinking: Understand and leverage native browser APIs
  (Intersection Observer, Resize Observer, Web Workers, Storage APIs) before
  reaching for libraries.
- Atomic Principles: Build small, reusable, and composable components that
  follow the Single Responsibility Principle.
- Visual Feedback: Always provide clear states (loading, skeleton screens,
  error, empty, success) and interactive feedback.
- Progressive Enhancement: Ensure core functionality works everywhere,
  while providing an enhanced experience for modern browsers.
- Maintenance-Driven Design: Write code that is easy to delete, refactor,
  and test. Document architectural decisions and complex logic clearly.
  
Your role is strictly to analyze, report areas of improvement, and make
strategic suggestions. Do not fix it yourself, just make suggestions.

이 파일을 .gemini/agents/frontend-specialist.md에 배치하면, Gemini CLI는 즉시 호출할 수 있는 새로운 전문가를 갖게 돼요.

다양한 구성 옵션을 보려면, 서브 에이전트 문서를 참고해 주세요.

병렬 실행

한 명의 전문가보다 더 좋은 건 뭘까요? 동시에 작업하는 전문가 팀 전체죠! Gemini CLI는 병렬 서브 에이전트를 지원해서, 동시에 여러 서브 에이전트 또는 동일한 서브 에이전트의 여러 인스턴스를 실행할 수 있게 해줘요.

만약 다섯 가지 다른 주제를 조사하거나 여러 개의 고유한 구성 요소를 리팩토링해야 한다면, Gemini CLI는 여러 에이전트를 병렬로 파견하여 작업을 완료하는 데 걸리는 총 시간을 획기적으로 줄여줄 수 있어요.

명시적으로 요청하려면, **"프론트엔드 전문가를 각 패키지에서 병렬로 실행해 줘."**라고 말하면 된답니다.

참고: 코드를 많이 편집해야 하는 작업의 경우 병렬 서브 에이전트 사용에 주의하세요. 여러 에이전트가 동시에 코드를 편집하면 충돌이 발생하거나 서로 덮어쓸 수 있거든요. 병렬 서브 에이전트를 사용하면 에이전트 간에 요청이 병렬로 전송되므로 사용량 제한에 더 빨리 도달할 수도 있어요.

서브 에이전트 시작하기

Gemini CLI에는 바로 사용할 수 있는 몇 가지 내장 서브 에이전트가 포함되어 있어요:

• generalist: 모든 도구에 접근할 수 있는 범용 에이전트예요. 일괄 리팩토링이나 대량 출력이 있는 명령 실행과 같이 턴이 많이 필요한 작업에 완벽하죠. (제너럴리스트는 기본적으로 일반 Gemini CLI 에이전트의 복사본을 서브 에이전트로 사용하는 거랑 비슷해요.)
• cli_help: Gemini CLI 자체에 대한 전문가예요. Gemini CLI 문서에 직접 접근해서 기능에 대한 질문(예: “Gemini CLI에서 서브 에이전트는 어떻게 작동해요?”)에 답할 준비가 되어 있답니다.
• codebase_investigator: 코드베이스 탐색, 아키텍처 매핑, 버그 원인 분석, 시스템 전체 종속성 이해를 위한 전문 에이전트예요.

Gemini CLI는 서브 에이전트의 설명을 기반으로 가장 효율적인 경로라고 판단되면 자동으로 작업을 해당 서브 에이전트에게 라우팅해요. 하지만 @agent 구문을 사용하여 프롬프트에서 서브 에이전트를 언급하면 명시적으로 작업을 위임할 수도 있어요. 예를 들면:

• "@frontend-specialist 저희 앱을 검토하고 개선할 만한 부분을 알려줄 수 있나요?"
• "@generalist 전체 프로젝트의 라이선스 헤더를 업데이트해 줘."
• "@codebase_investigator 인증 흐름을 매핑해 줘."

@ 기호 뒤에 서브 에이전트 이름을 붙여서 사용하면, Gemini CLI에게 어떤 전문가를 고용해야 할지 명시적으로 알려주는 거예요. 이렇게 하면 해당 에이전트의 격리된 컨텍스트 윈도우 안에서 작업이 처리되도록 보장할 수 있어요.

현재 구성된 모든 서브 에이전트를 보려면 Gemini CLI 내에서 /agents를 실행하기만 하면 돼요.

서브 에이전트 구성, 도구 제한, 설명 최적화에 대해 더 자세히 알아보려면 문서를 확인해 보세요.

• 서브 에이전트 문서
• GitHub 저장소

최신 뉴스와 발표 소식을 받아보려면 X에서 Gemini CLI를 팔로우할 수도 있어요.

이전 게시물

다음 게시물