"Gemini CLI vs Claude Code" AI 서브에이전트, 어떤 게 더 나을까?

by 황금의도시 엘도라도 4월 22, 2026

지난 포스팅에서 Gemini CLI 서브에이전트의 출시 소식과 상세 기능을 살펴봤습니다. 하지만 AI 코딩 도구를 선택할 때 빠질 수 없는 질문이 있죠 — "그래서 Claude Code랑 비교하면 어때?"

이번 편에서는 두 도구의 멀티에이전트(서브에이전트) 기능을 중심으로, 구조·기능·가격·코드 품질까지 모두 비교합니다. 개발자가 아니어도 이해할 수 있도록 최대한 쉽게 설명하겠습니다.

1. 한눈에 보는 핵심 비교표

먼저 전체 그림을 봅시다. 세부 내용은 아래에서 하나씩 풀어드립니다.

비교 항목 Gemini CLI Claude Code
가격 무료 (하루 1,000회) / Pro $19.99·Ultra $249.99 무료 없음 / Pro $20·Max $100~$200
컨텍스트 윈도우 1M 토큰 1M 토큰 (Max 이상)
서브에이전트 정식 지원 (v0.38.1~) 정식 지원 (2025.07~)
에이전트 팀 (팀원끼리 대화) 미지원 실험적 지원 (Agent Teams)
통신 구조 Hub-and-Spoke (메인 AI만 경유) 서브에이전트: Hub-and-Spoke / Agent Teams: 팀원 간 직접 대화
에이전트 정의 방식 Markdown + YAML 프론트매터 Markdown + YAML 프론트매터
기본 내장 에이전트 generalist, cli_help, codebase_investigator, browser_agent(실험) Explore, Plan, general-purpose, Claude Code Guide
도구 제한 tools 허용 목록 + 와일드카드(*, mcp_*) tools 허용 + disallowedTools 거부 목록
모델 선택 model 필드 (Gemini 3 Flash/Pro 등) 또는 inherit model 필드 (sonnet, opus, haiku, 전체 모델 ID) 또는 inherit
temperature 설정 지원 (0.0~2.0, 기본 1) 미지원 (프론트매터에 없음)
메모리 (학습 유지) 미지원 지원 (user / project / local 스코프)
훅 (자동화 규칙) Policy Engine (.toml) 정책 PreToolUse / PostToolUse / Stop 훅 + SubagentStart/Stop
백그라운드 실행 미지원 (포그라운드만) 지원 (background: true, Ctrl+B)
MCP 서버 격리 mcpServers 필드로 에이전트별 서버 할당 mcpServers 필드로 인라인/참조 방식 지원
원격 에이전트 Agent-to-Agent (A2A) 프로토콜 현재 미지원 (로컬만)
브라우저 자동화 browser_agent (Chrome 144+, 실험) MCP 플러그인으로 가능 (Playwright 등)
오픈소스 예 (Apache 2.0) 아니오 (Proprietary)
SWE-bench Verified Gemini 3.1 Pro: ~80.6% Claude Opus 4.6: ~80.8%

2. 구조가 다르다 — "팀장 혼자 관리" vs "팀원끼리 대화"

Gemini CLI: Hub-and-Spoke 구조

Gemini CLI의 서브에이전트는 허브 앤 스포크(Hub-and-Spoke) 구조입니다. 쉽게 말해, 팀장(메인 AI)만 팀원(서브에이전트)에게 일을 시키고, 팀원끼리는 서로 대화할 수 없습니다.

비유: 회사 대표가 개발팀장·마케팅팀장·CS팀장에게 각각 업무를 지시합니다. 각 팀장은 자기 방에서 일한 뒤, 결과 보고서만 대표에게 올립니다. 팀장끼리 직접 회의하는 일은 없습니다.

이 구조의 장점은 단순하고 깔끔하다는 것입니다. 각 서브에이전트의 작업 결과는 요약되어 메인 AI에게만 돌아오기 때문에, 메인 대화가 지저분해지지 않습니다. 또한 서브에이전트가 다른 서브에이전트를 호출할 수 없어서(재귀 방지) 무한 루프에 빠질 위험도 없습니다.

Claude Code: 서브에이전트 + Agent Teams (2단 구조)

Claude Code는 두 가지 모드를 제공합니다.

① 서브에이전트 모드 — Gemini CLI와 동일한 Hub-and-Spoke 구조입니다. 메인 AI가 서브에이전트에게 일을 시키고, 결과만 돌려받습니다. 2025년 7월부터 정식 지원되었습니다.

② Agent Teams 모드 (실험적) — 여기서 차이가 생깁니다. Agent Teams에서는 팀원(Teammate)끼리 직접 메시지를 주고받을 수 있습니다. 공유 작업 목록(Task List)도 있어서, 팀원이 스스로 다음 할 일을 가져가기도 합니다.

비유: 서브에이전트 모드는 "대표 → 팀장 → 보고서" 구조지만, Agent Teams 모드는 "대표 + 팀장들이 같은 회의실에서 실시간 토론"하는 구조입니다. 보안 담당자가 "이 코드 위험해요"라고 말하면, 개발 담당자가 바로 "그럼 이렇게 수정할게요"라고 응답할 수 있습니다.

다만 Agent Teams는 아직 실험 단계(Experimental)이며, 환경변수 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1을 설정해야 사용할 수 있습니다. 토큰 사용량도 서브에이전트 대비 훨씬 높아서(팀원 수에 비례), 비용에 주의해야 합니다.

구분 Gemini CLI Claude Code 서브에이전트 Claude Code Agent Teams
팀원 간 대화 불가 불가 가능
공유 작업 목록 없음 없음 있음
토큰 비용 낮음 낮음 높음 (팀원 수 × 별도 컨텍스트)
상태 정식 정식 실험적

3. 기본으로 탑재된 에이전트 비교

두 도구 모두 별도 설정 없이 바로 쓸 수 있는 내장 에이전트를 제공합니다. 하지만 이름과 역할이 조금 다릅니다.

역할 Gemini CLI Claude Code
범용 작업 generalist — 메인 AI와 동일한 도구·권한을 가진 분신. 대규모 멀티스텝 작업에 사용. general-purpose — 모든 도구를 상속받은 범용 에이전트. 복합 리서치와 코드 수정에 사용.
코드 분석 codebase_investigator — 코드 구조 분석, 의존성 추적, 아키텍처 매핑. Explore — 읽기 전용, Haiku 모델 사용, 빠른 코드 탐색·검색.
도움말 cli_help — Gemini CLI 명령어와 설정에 관한 질문 답변. Claude Code Guide — Claude Code 기능·사용법에 관한 질문 답변 (Haiku 모델).
계획 수립 별도 에이전트 없음 (/plan 명령으로 대체) Plan — 읽기 전용으로 코드를 조사한 뒤 계획서 작성. plan 모드에서 자동 호출.
브라우저 browser_agent (실험) — Chrome 자동화. 폼 작성, 버튼 클릭, 데이터 추출. 내장 없음 — MCP 서버로 Playwright 등을 연결하면 가능.
핵심 차이: Gemini CLI는 브라우저 자동화 에이전트가 기본 내장되어 있고, Claude Code는 Plan 에이전트와 Explore 에이전트로 "읽기 전용 분석"에 특화된 에이전트를 기본 제공합니다. 용도에 따라 출발선이 다릅니다.

4. 나만의 에이전트 만들기 — 정의 방식 비교

두 도구 모두 Markdown 파일 + YAML 프론트매터로 커스텀 에이전트를 만듭니다. 형태가 매우 비슷하지만, 세부 설정 항목에서 차이가 있습니다.

Gemini CLI 커스텀 에이전트 예시

# 파일: .gemini/agents/marketing-writer.md

---
name: marketing-writer
description: 블로그·SNS·뉴스레터 콘텐츠 작성 전문가. SEO 최적화와 톤앤매너 유지.
kind: local
tools:
  - read_file
  - write_file
  - google_web_search
model: gemini-3-flash-preview
temperature: 0.7
max_turns: 20
timeout_mins: 15
---

당신은 시니어 콘텐츠 마케터입니다.
항상 SEO 키워드를 고려하고, 독자가 3초 안에 흥미를 느낄 수 있는
제목과 도입부를 작성하세요.

Claude Code 커스텀 에이전트 예시

# 파일: .claude/agents/marketing-writer.md

---
name: marketing-writer
description: 블로그·SNS·뉴스레터 콘텐츠 작성 전문가. SEO 최적화와 톤앤매너 유지.
tools: Read, Write, Grep, Glob, Bash
model: sonnet
permissionMode: acceptEdits
maxTurns: 25
memory: project
background: false
color: orange
skills:
  - seo-guidelines
  - brand-voice
hooks:
  PostToolUse:
    - matcher: "Write"
      hooks:
        - type: command
          command: "./scripts/check-seo.sh"
---

당신은 시니어 콘텐츠 마케터입니다.
항상 SEO 키워드를 고려하고, 독자가 3초 안에 흥미를 느낄 수 있는
제목과 도입부를 작성하세요.
작업을 마치면 메모리에 학습한 패턴을 저장하세요.

설정 항목 비교표

설정 항목 Gemini CLI Claude Code 설명
name / description 필수 필수 에이전트 이름과 역할 설명
tools 지원 (와일드카드 *, mcp_*) 지원 (허용 목록) 사용 가능한 도구 제한
disallowedTools 미지원 지원 특정 도구만 차단 (나머지는 허용)
model 지원 (gemini-3-flash 등) 지원 (sonnet, opus, haiku 등) 에이전트별 다른 AI 모델 사용
temperature 지원 (0.0~2.0) 미지원 응답 창의성 조절
max_turns / maxTurns 지원 (기본 30) 지원 최대 대화 턴 수
timeout_mins 지원 (기본 10분) 미지원 시간 초과 자동 종료
permissionMode 미지원 지원 (default, auto, plan 등 6종) 권한 확인 방식 설정
memory 미지원 지원 (user/project/local) 세션 간 학습 내용 유지
hooks Policy Engine (.toml)로 간접 지원 프론트매터에 직접 정의 (PreToolUse 등) 도구 실행 전후 자동화 규칙
background 미지원 지원 (true/false) 백그라운드 동시 실행
skills 미지원 (GitHub Issue로 요청 중) 지원 사전 지식 주입
isolation 기본 격리 (자체 컨텍스트) 기본 격리 + worktree 옵션 Git worktree로 완전 격리된 복사본 실행
color 미지원 지원 (8색) 작업 목록에서 시각 구분
mcpServers 지원 (인라인 정의) 지원 (인라인 + 참조) 에이전트 전용 외부 서버 연결
원격 에이전트 A2A 프로토콜 지원 미지원 외부 서버의 에이전트 호출
요약: Gemini CLI는 temperature와 timeout_mins로 응답 스타일과 시간을 세밀하게 제어할 수 있고, 원격 에이전트(A2A)도 지원합니다. Claude Code는 memory, hooks, background, skills, permissionMode 등 고급 자동화·학습·보안 기능이 훨씬 풍부합니다.

5. 사용 방법 비교 — 호출·관리·병렬 실행

에이전트 호출

방법 Gemini CLI Claude Code
자동 위임 description 기반으로 메인 AI가 자동 선택 description 기반으로 메인 AI가 자동 선택
수동 지정 @codebase_investigator 코드 분석해줘 @"code-reviewer (agent)" 코드 리뷰해줘
세션 전체 적용 미지원 claude --agent code-reviewer (세션 전체를 해당 에이전트로 실행)

두 도구 모두 @에이전트이름으로 특정 에이전트에게 직접 일을 시킬 수 있습니다. 차이점은 Claude Code에서 --agent 플래그를 사용하면 세션 자체를 특정 에이전트로 시작할 수 있다는 점입니다. 예를 들어 claude --agent security-auditor로 시작하면, 그 세션의 모든 대화가 보안 감사 에이전트의 시스템 프롬프트와 도구 제한을 따릅니다.

에이전트 관리

기능 Gemini CLI Claude Code
목록 보기 /agents 또는 /agents list /agents (탭 UI: Running / Library)
활성화/비활성화 /agents enable/disable 또는 settings.json /agents UI 또는 settings.json의 permissions.deny
전체 비활성화 "experimental": {"enableAgents": false} 개별 deny 또는 --disallowedTools "Agent(이름)"
설정 덮어쓰기 settings.json → agents.overrides settings.json → permissions.deny + 프론트매터

병렬 실행

Gemini CLI에서는 메인 AI에게 "이 4가지 작업을 동시에 해줘"라고 하면, 메인 AI가 여러 서브에이전트를 병렬로 호출합니다. 다만 모두 포그라운드에서 실행되며, 별도의 백그라운드 모드는 없습니다.

Claude Code에서는 서브에이전트를 포그라운드(대화 차단)와 백그라운드(동시 작업) 중 선택할 수 있습니다. background: true를 설정하거나 실행 중 Ctrl+B를 누르면 백그라운드로 전환됩니다. Agent Teams 모드에서는 팀원 각자가 독립된 Claude Code 세션이므로 당연히 병렬 작업이 가능합니다.

6. 가격 비교 — "무료"냐 "유료"냐

많은 분이 가장 궁금해하는 부분입니다.

구분 Gemini CLI Claude Code
무료 티어 Google 계정 로그인 → 하루 1,000회 요청 (Flash 모델) 승 없음
기본 유료 Google AI Pro: $19.99/월 → 1,500회/일 Claude Pro: $20/월 (Sonnet 4.6)
파워 유저 Google AI Ultra: $249.99/월 → 2,000회/일 Claude Max 5x: $100/월 / Max 20x: $200/월
팀/기업 Google Workspace · Vertex AI 연동 Team Premium: $150/사용자/월
API 종량제 Gemini API 키 (무료 250회/일, 유료 변동) Anthropic API (입력 $3/M, 출력 $15/M 토큰 기준 Sonnet)
핵심: 일단 써보고 싶다면 Gemini CLI가 압도적으로 유리합니다. 무료로 하루 1,000회나 쓸 수 있습니다. 신용카드도 필요 없습니다. Claude Code는 최소 월 $20부터 시작이며, 서브에이전트를 많이 쓰면 토큰을 빠르게 소모합니다.
주의: 서브에이전트를 사용하면 일반 대화보다 요청 횟수/토큰을 더 빠르게 소모합니다. Gemini CLI에서는 /stats model로, Claude Code에서는 /cost로 수시로 확인하세요.

7. 코드 품질 — 누가 더 잘 짜나?

SWE-bench Verified는 AI가 실제 GitHub 이슈를 얼마나 잘 해결하는지 측정하는 대표적인 벤치마크입니다. 2026년 4월 기준 주요 점수는 다음과 같습니다.

모델 SWE-bench Verified 점수
Claude Opus 4.6 ~80.8%
Gemini 3.1 Pro ~80.6%
Claude Sonnet 4.6 ~79.6%
Gemini 3 Flash ~75.8%

최상위 모델 간 점수 차이는 0.2%p 수준으로 거의 무의미합니다. 다만 실제 사용 환경에서 체감되는 차이는 있습니다.

Gemini CLI는 응답 속도가 빠르고, 프로토타입이나 단일 파일 작업에서 효율적입니다. 반면 복잡한 멀티파일 리팩토링에서는 도구 호출 오류나 파일 덮어쓰기 문제가 커뮤니티에서 보고되고 있습니다.

Claude Code는 기존 프로젝트의 코딩 스타일을 더 잘 따르고, 여러 파일에 걸친 의존성 추적·리팩토링에서 일관성이 높다는 평가를 받습니다. 다만 응답이 느리고, 매번 권한 확인을 요구하는 점이 작업 흐름을 끊을 수 있습니다.

정리: 벤치마크 점수는 사실상 동급입니다. 빠른 프로토타입 → Gemini CLI, 복잡한 대규모 코드 작업 → Claude Code가 현 시점의 현실적인 선택입니다.

8. 각자만의 고유 장점

Gemini CLI만의 장점

① 무료 티어: 하루 1,000회 요청을 신용카드 없이 무료로 사용할 수 있습니다. 서브에이전트 기능도 무료 티어에서 사용 가능합니다.

② 오픈소스 (Apache 2.0): 소스 코드를 직접 읽고, 수정하고, 기업 내부에서 포크할 수 있습니다. 커뮤니티 기여도 활발합니다.

③ 브라우저 에이전트: Chrome을 직접 제어하는 browser_agent가 기본 내장되어 있어, 웹 폼 자동 입력·데이터 스크래핑 같은 작업을 별도 설치 없이 수행할 수 있습니다.

④ temperature 제어: 에이전트별로 창의성(temperature)을 0.0~2.0 범위에서 설정할 수 있어, 개발 에이전트는 정확하게(0.2), 마케팅 에이전트는 창의적으로(0.7) 조절이 가능합니다.

⑤ 원격 에이전트 (A2A): Agent-to-Agent 프로토콜을 통해 외부 서버에 있는 에이전트를 호출할 수 있어, 확장성이 뛰어납니다.

⑥ Google Cloud 통합: BigQuery, Cloud Run, Vertex AI 등 Google 서비스와 자연스럽게 연동됩니다.

Claude Code만의 장점

① Agent Teams (팀원 간 직접 대화): 팀원끼리 메시지를 주고받고, 서로의 이론을 검증하며, 공유 작업 목록에서 자율적으로 업무를 가져갈 수 있는 유일한 도구입니다.

② 메모리 (persistent memory): 서브에이전트가 세션이 끝나도 학습한 내용을 기억합니다. "이 프로젝트의 코딩 컨벤션"이나 "반복되는 버그 패턴"을 다음 세션에서도 활용할 수 있습니다.

③ Hooks (자동화 규칙): 도구 실행 전(PreToolUse)·후(PostToolUse)에 커스텀 스크립트를 자동 실행할 수 있습니다. 예를 들어 "파일을 수정할 때마다 린터 자동 실행"이 가능합니다.

④ 백그라운드 실행: 서브에이전트를 백그라운드에서 돌리면서 메인 대화를 계속할 수 있습니다. Gemini CLI에서는 불가능한 기능입니다.

⑤ 세밀한 권한 제어: permissionMode 6가지 + disallowedTools 거부 목록 + isolation: worktree로 Git 저장소의 완전한 복사본에서 작업시키는 등, 보안과 안전에 훨씬 세밀합니다.

⑥ Skills 주입: 미리 작성해둔 도메인 지식(Skills)을 에이전트 시작 시 컨텍스트에 바로 주입할 수 있습니다.

9. 솔직한 한계점

Gemini CLI 한계 Claude Code 한계
팀원 간 직접 대화 기능 없음 (Hub-and-Spoke만) 무료 티어 없음 — 최소 월 $20
메모리(세션 간 학습) 미지원 Agent Teams는 실험 단계, 세션 재개 시 팀원 복구 안 됨
훅(Hooks)이 프론트매터 아닌 별도 .toml 파일로만 설정 토큰 사용량이 높음 (특히 Agent Teams)
백그라운드 실행 미지원 Anthropic 모델만 사용 가능 (외부 모델 연결 불가)
복잡한 멀티파일 작업에서 안정성 이슈 보고 권한 확인 반복 → 작업 흐름 방해 (auto 모드로 일부 개선)
무료 티어는 Flash 모델만 → 복잡한 추론에 약함 오픈소스가 아님 → 기업 커스터마이징 불가
disallowedTools(거부 목록) 미지원 원격 에이전트(A2A) 미지원

10. 그래서 나한테 맞는 건?

Gemini CLI를 추천하는 경우:

✅ 돈을 쓰기 전에 무료로 서브에이전트를 체험하고 싶다
✅ 빠른 프로토타입, 간단한 스크립트 작성이 주 작업이다
✅ Google Cloud(BigQuery, Cloud Run 등)를 자주 쓴다
✅ 브라우저 자동화(웹 스크래핑, 폼 입력)가 필요하다
✅ 에이전트마다 temperature를 다르게 설정하고 싶다
✅ 오픈소스라서 직접 수정하거나 회사 내부에 배포하고 싶다

Claude Code를 추천하는 경우:

✅ 복잡한 코드베이스의 멀티파일 리팩토링이 주 작업이다
✅ 에이전트가 세션 간에도 학습을 유지(메모리)하길 원한다
✅ 여러 에이전트가 서로 대화하며 협업(Agent Teams)하길 원한다
✅ 파일 수정 전후에 자동화 스크립트(훅)를 걸고 싶다
✅ 에이전트를 백그라운드에서 실행하며 메인 작업을 계속하고 싶다
✅ 팀 단위로 작업하며, 체계적인 권한 관리가 필요하다

둘 다 쓰는 전략 (실제로 많은 개발자가 사용):

Gemini CLI로 빠른 아이디어 검증·프로토타입을 만들고, Claude Code로 최종 코드를 다듬고 리팩토링하는 조합입니다. Gemini CLI는 무료이니 비용 부담 없이 탐색에 활용하고, Claude Code는 품질이 중요한 최종 단계에 집중 투입하는 방식입니다.

Tags
황금의도시 엘도라도

작성자: 황금의도시 엘도라도

댓글 쓰기

0 댓글