Ai 마법서

Claude-SubAgent , Agent

6 min read

SubAgent , Agent 를 먼저 핵심만 추려서

Created: 3/19/2026 8:48:36
Updated: 3/19/2026 8:50:03
Exported: 3/26/2026 13:25:16
Link: https://claude.ai/chat/dca2468d-a9d7-41da-a181-d6aac1673880

Agent / SubAgent 핵심 개념

Agent는 단순 질답을 넘어 파일 읽기·수정·명령어 실행 등 도구(tool)를 자율적으로 사용해 복잡한 작업을 완수하는 AI 인스턴스다. SubAgent는 메인 에이전트가 특정 작업을 위임하기 위해 생성하는 전문화된 하위 에이전트로, 독립적인 컨텍스트 창을 가지며 최종 결과만 부모에게 반환한다.

핵심 구조는 간단하다.

Tool: show_widget

SubAgent의 핵심 가치는 세 가지다. 자체 컨텍스트 창에서 실행되어 탐색이나 구현 작업이 메인 대화를 오염시키지 않도록 보존하며, 특정 도구만 허용하는 권한 제어, 프로젝트 전반에 걸친 설정 재사용이 가능하다.

플랫폼별 비교

Claude Code

SubAgent는 YAML 프론트매터가 포함된 Markdown 파일로 정의되며, .claude/agents/ 디렉토리에 저장된다. Claude는 SubAgent의 description 필드를 읽고 작업에 적합한 에이전트를 자동으로 선택하거나 명시적으로 호출할 수 있다.

내장 SubAgent로는

  1. 코드베이스 탐색에 최적화된 읽기 전용 Explore 에이전트,
  2. 플랜 모드에서 컨텍스트 수집을 담당하는 Plan 에이전트,
  3. 복잡한 멀티스텝 작업을 처리하는 General-purpose 에이전트 가 기본 제공된다.

주요 특징:

  • /agents 명령어로 대화 중 직접 생성·관리
  • 에이전트별 모델 지정 가능 (비용 최적화)
  • SubAgent는 다른 SubAgent를 생성할 수 없어 무한 중첩을 방지한다
  • hooks 시스템으로 에이전트 간 파이프라인 자동화 (예: pm-spec → architect-review → implementer-tester)

Gemini CLI

Gemini CLI의 메인 에이전트는 작업이 전문 에이전트의 전문성과 일치하면 SubAgent를 자동으로 호출하도록 설계되어 있다. @에이전트명 문법으로 특정 SubAgent를 직접 지정할 수도 있다.

커스텀 에이전트는 YAML 프론트매터를 포함한 Markdown 파일로 정의하며, 프로젝트 레벨 .gemini/agents/*.md 또는 사용자 레벨 ~/.gemini/agents/*.md에 배치한다.

주요 특징:

  • 내장 codebase_investigator, 브라우저 자동화 에이전트 등 실험적 기본 SubAgent 제공
  • Agent-to-Agent(A2A) 프로토콜로 원격 SubAgent에 작업 위임 가능 (실험적)
  • Apache 2.0 오픈소스, 1M 토큰 컨텍스트, 무료 60 req/min
  • GEMINI.md 파일로 프로젝트 수준 에이전트 지침 관리

OpenAI Codex

Codex는 병렬 SubAgent 워크플로우를 지원한다. SubAgent 생성, 후속 지시 라우팅, 결과 수집, 에이전트 스레드 종료까지 오케스트레이션 전체를 처리한다. 여러 에이전트가 동시에 실행되는 경우 모든 결과가 나올 때까지 기다린 후 통합 응답을 반환한다.

Codex는 사용자가 명시적으로 요청할 때만 SubAgent를 생성한다. 각 SubAgent는 독립적인 모델 작업과 도구 사용을 수행하기 때문에 단일 에이전트 실행보다 더 많은 토큰을 소비한다.

주요 특징:

  • AGENTS.md 파일로 전역·프로젝트·디렉토리별 에이전트 지침을 계층적으로 관리
  • CLI에서 /agent 명령으로 활성 에이전트 스레드 전환 및 실행 중인 SubAgent 제어 가능
  • Rust로 빌드된 CLI, ChatGPT Plus 이상 구독 필요

3자 비교 요약

Claude CodeGemini CLIOpenAI Codex
설정 파일.claude/agents/*.md.gemini/agents/*.mdAGENTS.md + config.toml
자동 위임description 기반 자동 선택description 기반 자동 선택명시적 요청 시만
병렬 실행가능가능가능
모델 분리에이전트별 지정 가능설정 가능에이전트별 설정 가능
중첩 금지SubAgent 내 SubAgent 불가제한적직접 중첩 없음
원격 에이전트MCP 통합A2A 프로토콜 (실험)MCP 서버로 노출 가능
오픈소스아니오예 (Apache 2.0)예 (MIT)
비용Claude 구독 필요무료 티어 있음ChatGPT Plus+ 필요

세 툴 모두 구조는 동일하다 — 메인 에이전트가 전문화된 SubAgent에게 작업을 위임하고 결과만 수집하는 패턴. 차이는 얼마나 자동으로 위임하느냐 (Claude/Gemini는 자동, Codex는 명시적)와 생태계 연동 방식에 있다.

Powered by Claude Exporter

Graph View