Claude Code Agents 기능 완전 가이드 — 서브에이전트부터 Agent View까지 (2026)

Claude Code Agents 기능 완전 가이드 — 서브에이전트부터 Agent View까지 (2026)

Anthropic의 Claude Code가 단순 코딩 보조 도구를 넘어 멀티에이전트 개발 플랫폼으로 진화하고 있습니다. 서브에이전트, Agent View, Agent Teams까지 — Claude Code의 에이전트 기능을 체계적으로 정리합니다.

---

기본 정보

항목	내용
개발사	Anthropic
도구명	Claude Code
최소 버전	v2.1.139 이상 (Agent View 기준)
가격	Pro($20/월), Max($100·$200/월), Team, Enterprise, API 플랜
공식 문서	code.claude.com/docs
카테고리	AI 코딩 에이전트 / 멀티에이전트 오케스트레이션

---

Claude Code 에이전트 기능 전체 구조

Claude Code의 에이전트 시스템은 크게 세 가지 계층으로 나뉩니다.

1단계: 서브에이전트(Subagents) — 단일 세션 내에서 특정 작업을 위임하는 하위 에이전트입니다. 메인 대화의 컨텍스트를 보호하면서 탐색·분석·리뷰 등 집중 작업을 처리합니다.

 

2단계: Agent View — 여러 백그라운드 세션을 하나의 대시보드에서 관리하는 통합 인터페이스입니다. 2026년 5월 11일 리서치 프리뷰로 출시되었습니다.

 

3단계: Agent Teams — 여러 Claude Code 인스턴스가 팀처럼 협업하는 실험적 기능입니다. 공유 태스크 리스트와 에이전트 간 직접 메시징을 지원합니다.

---

1. 서브에이전트(Subagents) — 작업 위임의 기본 단위

서브에이전트란?

서브에이전트는 메인 Claude Code 세션에서 분리된 별도의 컨텍스트 윈도우에서 작업을 수행하는 특화 에이전트입니다. 공식 문서에 따르면, 서브에이전트는 자체 시스템 프롬프트, 도구 권한, 컨텍스트를 갖고 작동합니다. 작업 결과만 메인 세션으로 돌아오기 때문에 컨텍스트 오염을 방지할 수 있습니다.

 

내장 서브에이전트

Claude Code에는 기본 제공되는 서브에이전트가 있습니다.

• Explore: 코드베이스 검색·분석 전용의 읽기 전용 에이전트입니다. 파일 탐색, 코드 검색, 구조 파악에 최적화되어 있으며, 빠른 검색(quick)부터 심층 분석(very thorough)까지 단계를 지정할 수 있습니다.
• Plan: 계획 모드에서 코드베이스 조사를 수행하는 리서치 에이전트입니다. 하위 에이전트가 또 다른 하위 에이전트를 생성하는 무한 중첩을 방지하면서 필요한 컨텍스트를 수집합니다.
• General-purpose: 탐색과 실행 모두 가능한 범용 에이전트로, 복잡한 다단계 작업에 활용됩니다.

 

커스텀 서브에이전트 만들기

/agents 명령어로 직접 서브에이전트를 생성할 수 있습니다. 공식 문서 기준 절차는 다음과 같습니다.

Step 1. Claude Code에서 /agents를 입력합니다.

Step 2. Library 탭에서 "Create new agent"를 선택하고, Personal(사용자 전역) 또는 Project(프로젝트 전용)를 선택합니다.

Step 3. "Generate with Claude"를 선택한 뒤, 에이전트의 목적을 자연어로 설명합니다. 예: "코드 품질, 보안, 유지보수성을 검토하는 코드 리뷰 에이전트"

Step 4. 도구 접근 권한을 설정합니다. 읽기 전용(Read, Grep, Glob)만 허용하거나, 실행(Bash) 포함 여부를 선택할 수 있습니다.

Step 5. 배경 색상을 지정하여 시각적으로 구분합니다.

생성된 에이전트는 마크다운 파일(YAML 프론트매터 + 시스템 프롬프트)로 저장됩니다.

• 사용자 전역: ~/.claude/agents/
• 프로젝트 전용: .claude/agents/

서브에이전트 설정 파일 구조

---
name: code-reviewer
description: 코드 작성·수정 후 자동으로 품질, 보안, 유지보수성을 검토합니다.
tools: Read, Grep, Glob, Bash
model: inherit
---
당신은 코드 품질과 보안을 보장하는 시니어 코드 리뷰어입니다.
(이하 시스템 프롬프트)

핵심 설정 항목은 다음과 같습니다.

• name: 에이전트 이름 (Claude가 위임 판단 시 참조)
• description: Claude가 언제 이 에이전트를 호출할지 결정하는 기준
• tools: 사용 가능한 도구 목록 (생략 시 전체 도구 상속)
• model: sonnet, opus, haiku 중 선택 (비용·성능 조절)

서브에이전트 활용 팁

• 자동 위임: Claude가 description을 기반으로 적절한 서브에이전트를 자동 선택합니다. 따라서 description을 구체적이고 행동 중심으로 작성하는 것이 중요합니다.
• 수동 호출: @code-reviewer 형태로 명시적 호출도 가능합니다.
• 세션 전체를 에이전트로 실행: claude --agent code-reviewer로 특정 에이전트 모드로 시작할 수도 있습니다.
• 포크 모드: CLAUDE_CODE_FORK_SUBAGENT=1 환경변수를 설정하면 서브에이전트가 포크 방식으로 실행됩니다.

서브에이전트 추천 활용 사례

• 코드베이스 탐색: 낯선 프로젝트 구조 파악 시 explore 에이전트가 진입점, 데이터 흐름, 컨벤션을 조사하여 요약을 반환합니다.
• 코드 리뷰: 읽기 전용 도구만 허용한 리뷰어 에이전트로 품질·보안 점검을 수행합니다.
• 문서 조사: 공식 문서, 체인지로그를 수집하고 요약하는 전담 에이전트를 운영합니다.
• 테스트 실행·로그 분석: 스택 트레이스를 분석하고 실패 원인과 해결 방향을 요약하여 반환합니다.

---

2. Agent View — 멀티세션 통합 대시보드

Agent View란?

2026년 5월 11일 리서치 프리뷰로 출시된 Agent View는 여러 Claude Code 백그라운드 세션을 하나의 터미널 화면에서 관리할 수 있는 통합 대시보드입니다. Claude Code v2.1.139 이상에서 사용 가능합니다.

열기 방법

• 터미널에서 claude agents 명령어 실행
• 기존 세션에서 왼쪽 화살표(←) 키를 누르면 Agent View로 전환

핵심 기능

세션 상태 한눈에 파악: 각 행(row)에 세션 ID, 현재 상태(작업 중 / 입력 대기 / 완료), 마지막 응답 내용, 마지막 상호작용 시간이 표시됩니다.

Peek(미리보기): 행을 선택하고 Space 키를 누르면 해당 세션의 마지막 턴을 전체 세션에 들어가지 않고도 확인할 수 있습니다. 에이전트가 결정을 기다리고 있다면 인라인으로 바로 응답을 보낼 수 있습니다.

Attach(연결): Enter 키로 세션의 전체 대화 내용을 열어 심층 확인합니다.

백그라운드 세션 관리: 두 가지 방법으로 백그라운드 작업을 실행할 수 있습니다.

• 기존 세션에서 /bg 입력: 현재 세션을 백그라운드로 전환
• claude --bg "작업 설명": 처음부터 백그라운드 세션으로 실행

Agent View 워크플로우 예시

1. claude agents로 Agent View를 엽니다.
2. 하단 입력란에 "결제 모듈 리팩토링" 등 작업을 입력하고 Enter를 누릅니다.
3. 추가 작업("인증 버그 수정", "테스트 커버리지 확장")도 같은 방식으로 병렬 실행합니다.
4. 각 세션이 행으로 표시되며 상태가 실시간으로 업데이트됩니다.
5. 입력이 필요한 세션이 있으면 Peek으로 확인 후 인라인 응답합니다.
6. Esc를 눌러 Agent View를 닫아도 세션은 계속 실행됩니다.

/goal 명령어

같은 v2.1.139 업데이트로 함께 출시된 /goal 명령어는 완료 조건을 설정하면 Claude가 자율적으로 여러 턴에 걸쳐 작업을 수행합니다. /goal로 자율 실행 → /bg로 백그라운드 전환 → Agent View로 모니터링하는 조합이 핵심 워크플로우입니다.

주의할 점

• 토큰 소비: 병렬 세션은 각각 독립적으로 구독 쿼터를 사용합니다. 5개 세션을 동시에 실행하면 쿼터 소비 속도가 5배가 됩니다.
• 로컬 실행: 세션은 로컬 머신에서 실행되므로, 노트북이 절전 모드에 들어가면 세션이 중단됩니다. 장시간 작업에는 VPS(가상 서버)를 통한 SSH 연결이 권장됩니다.
• 가용 플랜: Pro, Max, Team, Enterprise, API 플랜에서 사용 가능하며 일반 사용량 제한이 적용됩니다.

---

3. Agent Teams — 에이전트 간 협업 (실험적 기능)

Agent Teams란?

Agent Teams는 여러 Claude Code 인스턴스가 하나의 프로젝트에서 팀처럼 협업하는 기능입니다. 현재 실험적(Experimental) 기능으로, 기본 비활성화 상태입니다.

서브에이전트와의 차이

서브에이전트는 단일 세션 내에서 작동하며 결과만 메인 에이전트에 보고합니다. 서로 간 통신이 불가능합니다. 반면 Agent Teams의 팀원(teammate)들은 서로 직접 메시지를 주고받고, 공유 태스크 리스트에서 작업을 할당·추적하며, 리드(lead) 에이전트 없이도 협업할 수 있습니다.

활성화 방법

환경변수 또는 settings.json에 다음을 추가합니다.

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

v2.1.32 이상에서 사용 가능합니다.

작동 방식

1. Claude에게 병렬 작업이 필요한 태스크를 설명하고 "에이전트 팀을 만들어줘"라고 요청합니다.
2. Claude가 팀 리드 역할을 하며, 요청에 따라 팀원(teammate)을 생성합니다.
3. 각 팀원은 독립된 컨텍스트 윈도우에서 작업하며, 공유 태스크 리스트와 메시지 시스템으로 협업합니다.

Agent Teams 추천 활용 사례

• 리서치·리뷰: 여러 팀원이 문제의 다른 측면을 동시에 조사한 뒤 결과를 공유하고 검증합니다.
• 신규 모듈·기능 개발: 프론트엔드, 백엔드, 테스트를 각 팀원이 분담합니다.
• 디버깅: 서로 다른 가설을 병렬로 검증하고 결과를 비교하여 빠르게 원인을 파악합니다.
• 크로스 레이어 변경: 프론트엔드·백엔드·DB 마이그레이션처럼 여러 계층에 걸친 변경을 조율합니다.

현재 한계

• 세션 재개(resume), 태스크 조율, 종료 동작에 알려진 제한이 있습니다.
• 순차적 작업, 같은 파일 편집, 의존성이 많은 작업에는 단일 세션이나 서브에이전트가 더 효과적입니다.
• 토큰 소비가 단일 세션 대비 크게 증가합니다.

---

각 기능 비교 요약

항목	서브에이전트	Agent View	Agent Teams
핵심 용도	단일 작업 위임	다중 세션 모니터링	에이전트 간 협업
컨텍스트	메인 세션 내 분리	독립 세션 병렬 관리	독립 세션 + 상호 통신
에이전트 간 통신	불가 (결과만 반환)	불가 (독립 실행)	직접 메시징 가능
안정성	안정(정식 기능)	리서치 프리뷰	실험적(기본 비활성)
최소 버전	v1.0.60+	v2.1.139+	v2.1.32+
적합한 작업	탐색, 리뷰, 조사	독립 태스크 병렬 처리	복잡한 크로스 기능 개발

---

경쟁 도구 비교

항목	Claude Code Agents	GitHub Copilot Coding Agent	OpenAI Codex
실행 환경	로컬 터미널(CLI)	클라우드(GitHub)	클라우드
멀티에이전트	서브에이전트 + Agent Teams	PR 단위 병렬	병렬 태스크 지원
세션 관리	Agent View 대시보드	GitHub UI	웹 대시보드
커스터마이징	마크다운 파일 기반 에이전트 정의	제한적	제한적
오프라인 실행	가능(로컬)	불가(클라우드 필수)	불가(클라우드 필수)
한국어 지원	프롬프트 입력 지원	프롬프트 입력 지원	프롬프트 입력 지원

---

총평

Claude Code의 에이전트 기능은 단순한 코드 자동 완성 도구와 근본적으로 다른 방향을 제시합니다. 서브에이전트로 작업을 분리·위임하고, Agent View로 여러 작업을 병렬 관리하며, Agent Teams로 에이전트 간 협업까지 가능한 구조는 현재 AI 코딩 도구 중 가장 체계적인 멀티에이전트 아키텍처입니다.

 

다만 Agent View는 리서치 프리뷰, Agent Teams는 실험적 기능이라 아직 안정성 면에서 주의가 필요합니다. 또한 병렬 실행 시 토큰 소비가 급격히 늘어나는 점은 Pro 플랜 사용자에게는 실질적인 제약입니다. 현재 시점에서는 서브에이전트를 중심으로 익숙해진 뒤, Agent View로 확장하는 단계적 접근이 가장 현실적입니다.

평점: ⭐⭐⭐⭐☆ (4/5)
— 기능 설계와 확장성은 최고 수준이나, 아직 실험 단계 기능이 많고 비용 효율성에서 개선 여지가 있습니다.