Claude Code 서브에이전트는 .claude/agents/*.md에 정의된 전문 서브에이전트로, 자체 격리된 컨텍스트에서 실행되며 좁고 잘 정의된 작업을 위임합니다. AgentsRoom은 터미널 저글링 없이 수십 개의 Claude Code 서브에이전트를 모든 프로젝트 전반에서 병렬로 실행할 수 있게 해주는 비주얼 커맨드 센터, 멀티 에이전트 대시보드 및 서브에이전트 매니저입니다.
서브에이전트는 컨텍스트 비대와 역할 전문화에 대한 Anthropic의 답변입니다. AgentsRoom은 그 위의 비주얼 계층입니다: 단일 터미널에서 서브에이전트가 스크롤되는 것을 지켜보는 대신, 모든 Claude Code 서브에이전트, 모든 세션, 모든 프로젝트가 한눈에 보이는 실시간 대시보드를 얻습니다. 집중을 위한 서브에이전트, 오케스트레이션을 위한 AgentsRoom.
Claude Code 서브에이전트(때로는 sub-agents로 표기됨)는 부모 Claude Code 세션이 작업을 위임할 수 있는 전문 AI 에이전트입니다. 각 서브에이전트는 .claude/agents/(프로젝트 수준) 또는 ~/.claude/agents/(사용자 수준) 내의 Markdown 파일로 정의되며, 자체 이름, 설명, 시스템 프롬프트 및 허용된 도구를 가집니다. 부모 에이전트가 좁은 작업(코드 리뷰, 보안 감사, 리팩터링, 테스트 실행)을 완료해야 할 때 적절한 서브에이전트를 호출하며, 이는 격리된 컨텍스트 창에서 실행되어 결과를 반환합니다.
핵심 설계 결정은 컨텍스트 격리입니다. 서브에이전트는 깨끗한 상태로 시작하여 좁은 작업에 완전히 집중합니다. 부모의 컨텍스트를 탐색 노이즈로 오염시키지 않고, 관련 없는 접선으로 집중을 잃지 않습니다. 이것이 Claude Code 서브에이전트가 단일 장시간 대화를 넘어 Claude Code를 확장하는 권장 방법인 이유입니다: 큰 문제를 역할 기반 전문 서브에이전트로 분할하고 Claude Code가 이를 오케스트레이션하도록 합니다.
서브에이전트는 또한 진정한 멀티 에이전트 워크플로우를 가능하게 합니다. 단일 Claude Code 세션은 여러 서브에이전트로 팬아웃할 수 있으며, 각각 작업의 일부를 실행하고, 각각 자체 도구, 자체 컨텍스트, 자체 전문화를 가집니다. 이것은 멀티 에이전트 코딩에 대한 Anthropic의 기본 프리미티브이며, AgentsRoom은 많은 Claude Code 세션(각각 자체 서브에이전트 구성을 가짐)을 병렬로 플릿 규모에서 실행할 수 있게 하여 이를 다음 수준으로 끌어올리는 비주얼 커맨드 센터입니다.
서브에이전트는 프로젝트 수준, 사용자 수준에 있거나 AgentsRoom과 같은 도구를 통해 세션 전반에서 오케스트레이션될 수 있습니다.
저장소 내부의 .claude/agents/에 Markdown 파일을 놓으면 해당 프로젝트에 대해 실행되는 모든 Claude Code 세션이 사용자 정의 서브에이전트에 자동으로 접근할 수 있습니다. 폴더가 git에 커밋되기 때문에 팀 전체가 동일한 전문 서브에이전트를 상속받습니다. 이것은 프로젝트별 서브에이전트에 적합한 계층입니다: 귀하의 규약을 아는 리뷰어, 귀하의 테스트 프레임워크를 아는 테스터, 귀하의 위협 모델을 아는 보안 감사자.
사용자 홈 디렉토리에 정의된 서브에이전트는 Claude Code가 실행되는 저장소에 관계없이 모든 프로젝트에서 사용할 수 있습니다. 이것은 개인 생산성 서브에이전트에 적합한 계층입니다: 프롬프트 포매터, 커밋 메시지 작성자, 코드 설명자, TypeScript 엄격성 시행자 또는 모든 세션에서 원하는 다른 범용 도우미.
AgentsRoom은 .claude/agents 서브에이전트를 대체하지 않습니다 — 진짜 Claude Code CLI를 실행하므로 정의한 모든 서브에이전트 파일이 정확히 동일하게 작동합니다. AgentsRoom이 추가하는 것은 세 번째 계층입니다: 플릿 수준 오케스트레이션. 많은 Claude Code 세션을 병렬로 실행할 수 있으며, 각각 자체 서브에이전트를 가지고, 각각 AgentsRoom의 14개 내장 에이전트 역할(Frontend, Backend, QA, DevOps, Security, Architect...) 중 하나에 할당되며, 여러 프로젝트에 걸쳐 한 번에 실행됩니다. 세션 안의 서브에이전트, 멀티 에이전트 대시보드 안의 세션.
서브에이전트는 컨텍스트에 빠지지 않고 AI 코딩을 확장하려는 팀에게 가장 중요한 Claude Code 기능입니다.
각 Claude Code 서브에이전트는 좁은 작업 전용의 깨끗하고 최소한의 컨텍스트로 시작합니다. 관련 없는 탐색 없음, 오래된 컨텍스트 없음, 집중력 상실 없음. 서브에이전트는 작업에 집중을 유지합니다. 왜냐하면 작업이 문자 그대로 그들이 아는 전부이기 때문입니다.
부모 Claude Code 세션은 독립적으로 실행되는 여러 서브에이전트를 디스패치할 수 있습니다. AgentsRoom이 많은 Claude Code 세션을 병렬로 시작할 수 있는 능력과 결합하면 진정한 멀티 에이전트, 멀티 서브에이전트 코딩을 얻을 수 있습니다: 수십 명의 전문 AI 작업자가 각자 자체 문제의 일부에 집중합니다.
서브에이전트는 .claude/agents의 단순한 Markdown 파일이기 때문에 쉽게 재사용할 수 있고, git으로 버전 관리되며, 팀 전체와 공유할 수 있습니다. 서브에이전트를 한 번 작성하고 커밋하면 프로젝트의 모든 개발자가 동일한 전문 서브에이전트를 상속받습니다. 이것은 코드로서의 멀티 에이전트 AI 인프라입니다.
큰 코드베이스는 단일 컨텍스트 창에 맞추기가 불가능합니다. Claude Code 서브에이전트는 작업을 좁은 컨텍스트 전문가로 분할하여 이를 해결합니다. AgentsRoom은 접근 방식을 더욱 확장합니다: 큰 코드베이스가 많은 Claude Code 세션이 되며, 각각 서브에이전트 기반 워크플로우를 실행하고, 각각 멀티 에이전트 대시보드에서 볼 수 있습니다.
비주얼 계층이 없으면 서브에이전트는 블랙박스처럼 느껴질 수 있습니다: 시작되어 무언가를 수행하고 결과를 반환합니다. AgentsRoom은 Claude Code가 스트리밍하는 모든 것 — SubagentStop 이벤트, 도구 호출 및 상태 변경 포함 — 을 실시간으로, 에이전트별, 프로젝트별로 표시합니다. 서브에이전트 실행이 완전히 관측 가능해집니다.
Claude Code 서브에이전트는 Claude Code hooks(PreToolUse, PostToolUse, SubagentStop) 및 MCP 서버와 아름답게 결합됩니다. 서브에이전트는 프로젝트 전체 훅을 존중하고, 프로젝트 전체 MCP 서버를 사용하며, AgentsRoom이 관리하는 세션 내에서 실행될 수 있습니다 — 모두 특별한 구성 없이. 이것은 Anthropic의 기본 스택이며 완전히 존중됩니다.
AgentsRoom은 Claude Code를 위한 비주얼 커맨드 센터입니다. 완전한 xterm.js 터미널 내에서 진짜 claude CLI 프로세스를 생성하므로 .claude/agents/*.md 또는 ~/.claude/agents/*.md에 정의한 모든 서브에이전트가 Anthropic이 설계한 대로 정확하게 자동으로 사용 가능합니다. 재구현 없음, 파싱 없음, 충실도 손실 없음.
기본 서브에이전트 지원 외에도 AgentsRoom은 플릿 수준 오케스트레이션을 제공합니다: 세션에 할당할 수 있는 14개 내장 에이전트 역할, 비주얼 멀티 에이전트 대시보드, 에이전트별 알림, 모바일 컴패니언, 드래그 앤 드롭 프로젝트 매니저 및 칸반 카드에서 Claude Code 에이전트를 생성하는 백로그 태스크 보드. 제정신을 잃지 않고 서브에이전트 기반 Claude Code 에이전트의 작은 군대를 실행하고 지켜보는 유일한 방법입니다.
모든 AgentsRoom 에이전트는 진짜 claude 프로세스입니다. 당신의 .claude/agents/*.md 서브에이전트, 사용자 수준 ~/.claude/agents/*.md 서브에이전트, 훅, CLAUDE.md, 설정 — 모두 손대지 않고, 모두 존중되며, 모두 Anthropic이 의도한 대로 실행됩니다.
각 AgentsRoom 세션을 14개의 전문 역할 중 하나에 할당하세요: DevOps, Fullstack, Frontend, Backend, Architect, QA, Marketing, PM, Security, Mobile, Git, SEO, i18n 또는 Custom. 역할 프롬프트는 세션 내 Claude Code 서브에이전트와 깔끔하게 결합되어 두 계층의 전문화를 제공합니다.
AgentsRoom은 많은 Claude Code 세션을 별도의 프로세스로 병렬로 실행합니다. 각 세션은 자체 서브에이전트를 디스패치할 수 있습니다. 이것은 시뮬레이션된 동시성이 아닌 진정한 병렬성입니다: 귀하의 멀티 에이전트 Claude Code 워크플로우는 귀하의 머신과 API 쿼터가 허용하는 만큼 확장됩니다.
프로젝트 간을 이동하고 어떤 서브에이전트가 실행 중인지, 어떤 것이 입력에서 차단되어 있는지, 어떤 것이 방금 완료되었는지 즉시 확인하세요. 사이드바는 모든 프로젝트의 상태를 집계하고, 대시보드는 에이전트별 활동을 표시합니다. 서브에이전트가 보이고, 측정 가능하며, 관리 가능해집니다.
AgentsRoom을 다운로드하고 하나의 비주얼 대시보드로 모든 프로젝트 전반에서 Claude Code 서브에이전트 플릿을 실행하세요. 기본 .claude/agents 지원, 제로 구성.
컴패니언 앱: 이동 중에도 에이전트를 모니터링
Claude, Codex, OpenCode, Gemini CLI, Aider와 호환