클로드 코드(Claude Code)를 처음 쓰다 보면 메인 대화창이 점점 길어지고 컨텍스트가 뒤섞이는 문제를 마주하게 됩니다. 이때 가장 효율적인 해법이 바로 서브에이전트(subagent)를 정의하고 관리하는 /agents 화면, 그리고 여러 백그라운드 세션을 한눈에 보는 에이전트 뷰(agent view)입니다. 이 글에서는 두 화면을 언제, 어떻게 써야 하는지 공식 문서 기준으로 정리합니다.
목차
1. /agents와 에이전트 뷰는 서로 다른 화면입니다
많은 분이 헷갈리시는데, 두 개념은 별개의 인터페이스입니다.
| 구분 | 실행 방법 | 역할 |
|---|---|---|
| /agents | 대화창에서 /agents 입력 | 서브에이전트(에이전트 정의 파일) 생성·편집·삭제 |
| 에이전트 뷰 | 터미널에서 claude agents 또는 빈 프롬프트에서 ← 키 | 백그라운드로 돌고 있는 여러 세션을 한 화면에서 모니터링 |
정리하면 /agents는 “어떤 일꾼을 만들지 정의하는 메뉴”이고, 에이전트 뷰는 “지금 일하고 있는 일꾼들의 작업 현황판”입니다.
2. 서브에이전트가 왜 필요한가
클로드 코드의 메인 대화는 컨텍스트 윈도우를 공유합니다. 코드베이스 탐색, 테스트 실행, 파일 검색 같은 부수 작업까지 메인 대화에서 처리하면 정작 중요한 구현 단계에서 컨텍스트가 부족해지는 경우가 잦습니다. 서브에이전트를 쓰면 다음 이점이 있습니다.
- 컨텍스트 보존: 탐색·검증 같은 부수 작업을 별도 컨텍스트로 분리합니다.
- 도구 권한 제한: 특정 서브에이전트에는 읽기 전용 도구만 부여하는 식으로 작업 범위를 통제합니다.
- 모델 비용 최적화: 단순 탐색은 Haiku 같은 저렴한 모델로 라우팅합니다.
- 병렬 실행: 독립적인 서브에이전트 여러 개를 동시에 돌려 시간을 단축합니다.
- 구성 재사용: 한 번 만든 정의 파일을 여러 프로젝트에서 재사용합니다.
3. 빌트인 서브에이전트는 이미 준비돼 있습니다
별도로 만들지 않아도 클로드 코드에 기본 탑재된 서브에이전트가 있습니다.
- Explore: Haiku 모델 기반, 읽기 전용. 코드베이스 검색·심볼 위치 파악에 특화돼 있습니다. 키워드로 정의 위치를 찾거나 특정 패턴을 광범위하게 탐색할 때 메인 대화 대신 호출합니다.
- Plan: 구현 전 단계의 설계·계획 수립용. 파일 단위 단계 계획을 짜고 의존성을 분석합니다.
- general-purpose: 모든 도구를 쓸 수 있는 범용 일꾼. 검색·실행·수정이 모두 필요한 복합 작업에 적합합니다.
“이 파일이 어디서 호출되지?” 같은 단순 질문은 메인 대화 대신 Explore에 위임하는 습관만 들여도 컨텍스트가 훨씬 깔끔해집니다.
4. 사용자 정의 서브에이전트 만들기
반복되는 작업이 있다면 /agents로 직접 만드는 게 좋습니다. 메뉴 안에서 공식 가이드가 안내하는 순서를 따라가시면 됩니다.
- 클로드 코드 대화창에서
/agents입력 - Create new agent 선택
- 범위 선택: Project(현 프로젝트 한정,
.claude/agents/에 저장) 또는 Personal(전역,~/.claude/agents/에 저장) - 생성 방식 선택: Generate with Claude(설명만 입력하면 클로드가 정의서를 작성) 또는 Manual configuration(직접 작성)
- 이름, 설명, 사용 도구, 모델, 시스템 프롬프트를 채워 저장
저장된 파일은 YAML frontmatter가 붙은 마크다운 형식입니다. 주요 필드는 아래와 같습니다.
| 필드 | 필수 | 설명 |
|---|---|---|
| name | 필수 | 에이전트 이름 (Task 호출 시 식별자) |
| description | 필수 | 언제 이 에이전트를 호출해야 하는지 설명 |
| tools | 선택 | 사용 허용할 도구 목록 (예: Read, Grep, Bash) |
| disallowedTools | 선택 | 차단할 도구 목록 |
| model | 선택 | haiku, sonnet, opus 중 선택 |
| permissionMode | 선택 | plan, acceptEdits 등 권한 모드 |
5. 에이전트 뷰: 백그라운드 세션 현황판
에이전트 뷰는 최근 릴리스에 추가된 화면으로, tmux 같은 멀티플렉서 없이도 여러 세션을 병렬로 굴릴 수 있게 해줍니다.
여는 방법
- 터미널에서
claude agents명령 실행 - 또는 진행 중인 대화창에서 빈 프롬프트 상태로 왼쪽 화살표 키(←) 누르기 → 현재 세션이 자동으로 백그라운드화되고 뷰가 열립니다
뷰 안에서 할 수 있는 일
| 키 | 동작 |
|---|---|
| ↑/↓ | 세션 목록 이동 |
| Space | 선택한 세션의 현재 상태·입력 대기 여부 확인 |
| Enter 또는 → | 선택한 세션의 전체 대화로 진입 |
| Alt+1 ~ Alt+9 | N번째 세션으로 바로 어태치 |
| 입력 후 Enter | 새 백그라운드 세션 생성 |
새 백그라운드 세션을 직접 만드는 방법
셸에서 바로 띄우려면 다음 명령을 씁니다.
claude --bg "테스트 케이스 작성해줘"
이미 진행 중인 대화를 백그라운드로 보낼 때는 그 대화창에서 /bg 명령을 입력하면 됩니다.
6. 언제 어떤 화면을 써야 하나
실전에서는 두 화면의 역할이 달라서 트리거 시점이 명확합니다.
- /agents가 필요한 순간: 같은 패턴의 작업을 반복하고 있을 때(코드 리뷰, 테스트 실행, 문서 생성). 일회성 작업에는 굳이 만들 필요가 없습니다.
- 에이전트 뷰가 필요한 순간: 빌드·테스트처럼 시간이 오래 걸리는 작업을 띄워두고 그 사이에 다른 코드 작업을 하고 싶을 때. 또는 여러 폴더에서 독립적인 작업을 병렬로 굴려야 할 때.
- 둘 다 안 써도 되는 경우: 짧고 단일한 질의응답, 코드 한두 줄 수정. 오히려 오버헤드만 늘어납니다.
7. 자주 묻는 질문
Q1. /agents에서 만든 에이전트는 다른 컴퓨터에서도 쓸 수 있나요?
저장 위치에 따라 다릅니다. Personal로 저장하면 ~/.claude/agents/에 들어가서 모든 프로젝트에서 동작하지만, 다른 컴퓨터에는 따로 복사해야 합니다. Project로 저장한 경우 .claude/agents/가 git에 함께 추적돼 팀원과 공유할 수 있습니다.
Q2. 에이전트 뷰가 안 보이는데요?
에이전트 뷰는 비교적 최신 버전(Research Preview 단계)에서 추가된 기능입니다. 터미널에서 claude --version으로 버전을 확인한 뒤 npm i -g @anthropic-ai/claude-code로 업데이트해 보세요. 그래도 ← 키가 작동하지 않으면 입력창에 포커스가 있는 상태일 수 있는데, 이때는 Ctrl+Z를 누르면 즉시 뷰로 전환됩니다.
Q3. 서브에이전트와 에이전트 팀(team)은 무엇이 다른가요?
서브에이전트는 단일 세션 안에서 메인 에이전트에 보고하는 구조입니다. 반면 에이전트 팀은 독립적인 클로드 코드 세션 여러 개가 서로 메시지를 주고받으며 협업하는 상위 개념입니다. 일반적인 개발 작업에는 서브에이전트만으로 충분합니다.
Q4. 모델 비용을 줄이려면 어떤 모델을 골라야 하나요?
코드 탐색·요약 같은 단순 작업은 haiku, 설계·구현은 sonnet, 까다로운 리팩토링이나 아키텍처 결정은 opus가 일반적인 권장 조합입니다. 빌트인 Explore가 Haiku 기반인 것도 같은 맥락입니다.
마무리
/agents로 작업 패턴을 일꾼으로 정형화하고, 에이전트 뷰로 여러 일꾼이 동시에 돌게 만드는 것이 클로드 코드를 제대로 쓰는 핵심입니다. 처음에는 빌트인 Explore부터 적극 활용하고, 같은 작업을 두 번 이상 반복하게 될 때 비로소 사용자 정의 에이전트를 만드는 순서로 접근하시면 학습 곡선이 가장 부드럽습니다. 더 자세한 옵션은 Anthropic 공식 문서에서 확인하실 수 있습니다.