본문으로 건너뛰기
claudemods

Agent Tree: 상자로 그린 Claude Code 서브에이전트 트리

서브에이전트를 상자로 그리는 사이드 패널. 메인 세션, 어드바이저, 세션 로그도 함께 보여 줍니다.

권한

  • 도구 호출 가로채기Claude가 하는 모든 도구 호출을 볼 수 있고(tool.call / tool.check), 이를 차단하거나 변경할 수 있습니다.
  • 프롬프트 읽기입력한 내용과 대화 기록을 볼 수 있습니다(prompt.* / session.append / session.messages).
  • UI 변경Claude Code 화면에 밴드, 패널, 상태 텍스트, 토스트를 그립니다(ui.render / $.ui.*).
  • 명령어/도구 추가사용자나 Claude가 호출할 수 있는 새 슬래시 명령어나 도구를 등록합니다($.command.register / $.tool.register).
테스트 버전
v2.1.310
마지막 테스트
필요 버전
Claude Code ≥ 2.1.287
표시 위치
패널, 상태 표시줄

Claude Code 안에서 설치:

/plugin install agent-tree --marketplace MikeGT4/agent-tree
모든 설치 방법 ↓

이 모드는 무엇을 하나요?

Agent Tree는 Mike Pollow, Digitalroots(MikeGT4)가 만든 커뮤니티 모드입니다. Claude Code 서브에이전트 트리를 사이드 패널에 상자로 그려 줍니다. 맨 위에는 메인 세션이 있고 모델, effort 수준, 컨텍스트 사용량, 라운드 번호가 표시됩니다. 그 아래에는 서브에이전트마다 상자가 하나씩 있으며 유형, 모델, 설명, 마지막 도구, 상태 줄, 타임라인 막대를 보여 줍니다. 마지막 상자는 메인 세션으로 돌아가는 길이며 반환된 답변 수를 표시합니다.

트리 옆의 어드바이저 열은 어드바이저 모델이 설정되어 있는지, 메인 세션과 서브에이전트에서 각각 몇 번 문의했는지, 마지막 시각이 언제인지 보여 줍니다. 맨 아래의 세션 로그에는 라운드, 에이전트의 시작과 종료, 어드바이저 호출, 사용자가 한 선택이 나열됩니다. 에이전트가 많으면 패널이 간결한 행 표시로 바뀌고, 에이전트가 많은 워크플로는 상자 하나로 접힙니다.

패널은 조작 화면이기도 합니다. 에이전트의 유형을 클릭하면 작업, 최근 도구, 최신 답변을 보고 그곳에서 중지할 수 있습니다. 새 서브에이전트나 실행 중인 에이전트 하나에 모델 계열을 고를 수도 있습니다. 모드가 Claude Code의 동작을 바꾸는 경우는 이때뿐입니다. 상태 줄에는 Sub-agents [1/1] · $0.00 같은 짧은 요약도 표시됩니다. 작성자는 Claude Code 2.1.296과 2.1.307~2.1.310에서 테스트했습니다.

데모

녹화에서는 작은 데모 프로젝트에서 모드를 로드한 Claude Code를 시작하고 /agent-tree로 패널을 엽니다. 메인 세션은 유휴 상태이고 서브에이전트는 아직 없으며 세션 로그도 비어 있습니다. 그다음 서브에이전트로 src/login.js를 읽고 한 문장으로 설명해 달라고 요청합니다. 패널이 '작업 중'으로 바뀌고, 로그에 'Round 1' 줄이 생기며, general-purpose 서브에이전트가 실행 중으로 나타납니다. 메인 세션은 '서브에이전트 대기 중'이 되고 컨텍스트 수치가 채워집니다. 에이전트가 끝나면 그 답변이 '메인 세션으로 돌아가기' 상자에 집계됩니다.

설치

설치 블록의 어떤 방법이든 사용할 수 있으며, 작성자 본인의 마켓플레이스에서 바로 설치됩니다. 이후 /agent-tree로 패널을 엽니다.

$ install agent-tree

Claude Code 2.1.287 이상 필요

작성자의 마켓플레이스에서 설치: MikeGT4/agent-tree

  1. 1.Claude Code 안에서 한 줄로

    /plugin install agent-tree --marketplace MikeGT4/agent-tree

    실행 중인 세션(v2.1.275 이상)에 붙여 넣으세요. Claude Code가 먼저 마켓플레이스 추가 여부를 묻습니다.

  2. 2.셸에서 설치

    claude plugin marketplace add MikeGT4/agent-tree
    claude plugin install agent-tree@agent-tree

    그런 다음 이미 열려 있는 세션에서 /reload-plugins를 실행하세요.

  3. 3.설치하지 않고 사용해 보기

    git clone https://github.com/MikeGT4/agent-tree
    claude --plugin-dir ./agent-tree

    한 세션에서만 모드를 불러옵니다. 설정에는 아무것도 추가되지 않습니다.

작동 방식

모드는 트리 전체를 하나의 상태 아톰에 보관하고 에이전트 이벤트를 수신합니다. agent.spawn은 노드를 추가하고, tool.call은 도구를 세고, turn.step은 모델, effort, 어드바이저 사용을 기록하며, turn.complete는 에이전트를 완료, 실패, 중지로 표시합니다. ui.render가 이 상태로 패널을 그립니다. 250ms 타이머는 에이전트가 실행되는 동안에만 스피너를 움직입니다. 도구 호출을 막는 부분은 중지 기능이며, hooks/register.tsx의 코드는 다음과 같습니다.

if (stoppingIds.has(agentId)) {
  if (e.tool !== HANDBACK) {
    const current = await read($, tree)
    return { deny: wordsFor(lang).stopAnswer(current.agents.find(n => n.id === agentId)?.toolCount ?? 0) }
  }

중지하라고 지시한 에이전트만 영향을 받습니다. 세션에서 온 텍스트(작업, 답변, 도구 라벨)는 그리기 전에 정리됩니다. 터미널 이스케이프와 제어 문자는 제거하고, 토큰, 비밀번호, KEY=value처럼 보이는 문자열은 •••로 바꿉니다. 도구 라벨에는 전체 명령이 아니라 파일 이름, 프로그램 이름, 호스트만 표시됩니다.

사용자 지정

/config에는 다섯 가지 옵션이 있습니다. 도킹된 패널의 너비(기본 90열, 40140), 트리가 유지하는 서브에이전트 수(기본 30), 시작 시 열기(기본 꺼짐), 모션(스피너와 흐름 애니메이션, 기본 켜짐), 언어(auto, de, en)입니다. 직접 끌어서 정한 너비가 우선합니다. 패널 안의 키는 m으로 모델 선택, 04로 선택, x로 닫기, 세부 정보에서 s로 중지, ctrl+x tab으로 패널에 포커스입니다.

권한 및 안전

플러그인이 실행할 수 있는 모든 파일을 읽었습니다. hooks/hooks.json, register.tsx, model.ts, view.tsx, words.ts, 타입 선언, 테스트, README, PRIVACY.md입니다. package.json, 설치 스크립트, 바이너리, 번들된 코드는 없습니다. 텍스트가 아닌 파일은 PNG 아이콘 하나뿐입니다.

  • 네트워크, 프로세스, 파일, 데몬, 비밀 정보: 모두 없습니다. 네트워크 호출, 셸 명령, 파일 쓰기, 환경 변수, 자격 증명 접근을 찾지 못했고, Claude Code가 종료된 뒤에 계속 실행되는 것도 없습니다. 바쁜 에이전트가 없으면 타이머가 멈춥니다.
  • 읽는 것: 에이전트 목록과 서브에이전트 메시지(세부 보기용), language와 advisorModel 설정, 컨텍스트와 비용 수치입니다.
  • 텔레메트리: 없음.
  • 게이팅 훅: agent.spawn은 모델을 지정하지 않은 새 서브에이전트에 사용자가 고른 모델을 붙이고, turn.step은 실행 중인 에이전트의 다음 단계를 고른 모델로 바꾸거나 중지를 눌렀을 때 짧은 보고로 대체하며, tool.call은 중지된 에이전트의 이후 도구 호출을 거부합니다. 세 가지 모두 패널에서 조작한 뒤에만 작동하며 README와 PRIVACY.md의 설명과 일치합니다. 중지 보고는 무작위 id를 가진 SubagentHandback 도구 호출을 포함하는 합성 어시스턴트 메시지입니다.
  • 프롬프트 인젝션: 발견하지 못했습니다. 모드는 프롬프트에 텍스트를 추가하지 않으며 숨겨진 유니코드도 없습니다.
  • 라이선스: MIT, LICENSE 파일 있음.

claude plugin validate는 오류도 경고도 보고하지 않았습니다. 플러그인 디렉터리에는 hooks 모듈에 대한 별도 규칙이 있으며 validate는 이를 적용하지 않는다는 안내가 나옵니다. 작성자의 테스트 63개는 Claude Code 2.1.310에서 모두 통과했습니다.

도구 호출 가로채기
Claude가 하는 모든 도구 호출을 볼 수 있고(tool.call / tool.check), 이를 차단하거나 변경할 수 있습니다.
프롬프트 읽기
입력한 내용과 대화 기록을 볼 수 있습니다(prompt.* / session.append / session.messages).
UI 변경
Claude Code 화면에 밴드, 패널, 상태 텍스트, 토스트를 그립니다(ui.render / $.ui.*).
명령어/도구 추가
사용자나 Claude가 호출할 수 있는 새 슬래시 명령어나 도구를 등록합니다($.command.register / $.tool.register).

호환성 및 문제 해결

macOS의 Claude Code 2.1.310에서 확인했습니다(validate, 테스트, 녹화). 모드 인터페이스가 필요합니다. 패널이 나타나지 않으면 다음을 확인하세요.

  • claude --version이 2.1.287 이상입니다.
  • /agent-tree를 실행했습니다. 패널은 기본적으로 열리지 않습니다. 성공하면 "Agent Tree opened"가 출력됩니다.
  • 터미널이 충분히 넓습니다. 84열 미만이면 어드바이저 열이 트리 위에 쌓이고, 패널 너비가 40열 미만이면 레이아웃이 답답해집니다.
  • 모드가 로드되기 전에 시작된 에이전트는 패널을 열 때 에이전트 목록에서 가져옵니다.
  • 일반 세션에서는 아무것도 표시되지 않습니다. 서브에이전트가 없으면 "no sub-agents yet"이라고 나옵니다.

자주 묻는 질문

Agent Tree는 데이터를 보내거나 네트워크 요청을 하나요?
아니요. 코드에 네트워크 호출이 없고, 작성자의 PRIVACY.md도 어떤 데이터도 기기 밖으로 나가지 않는다고 밝힙니다. 실행 중인 세션의 트리를 메모리에만 보관하며 파일을 쓰지 않습니다.
패널에서 실행 중인 서브에이전트를 멈출 수 있나요?
네. 에이전트의 유형을 클릭해 세부 정보를 열고 중지(또는 s 키)를 누르세요. 그 에이전트의 이후 도구 호출은 거부되고, 다음 단계에서 '사용자가 중지함'이라는 짧은 보고가 반환됩니다.
서브에이전트의 모델을 바꿀 수 있나요?
네. '모델' 버튼은 새 서브에이전트의 모델 계열(Haiku, Sonnet, Opus, Fable)을 정하고, 실행 중인 에이전트 상자의 버튼은 다음 단계의 모델을 바꿉니다. 호출 자체가 모델을 지정했다면 건드리지 않습니다.
패널이 항상 열려 있나요?
기본값은 아닙니다. /agent-tree로 열고, /agent-tree stop으로 닫고, /agent-tree clear로 트리를 처음부터 다시 시작합니다. '시작 시 열기' 설정을 켜면 세션마다 열립니다.
라벨은 영어인가요?
기본적으로 언어 설정을 따라 독일어 또는 영어로 표시됩니다. Language 옵션으로 de나 en으로 고정할 수 있습니다. 로그의 시각은 24시간제입니다.
Claude Code에서 실행 중인 Agent Radar추천

Agent Radar

실행 중인 서브에이전트마다 프롬프트 위에 한 줄씩: 경과 시간, 도구 수, 현재 작업. /radar 패널도 제공합니다.

  • 프롬프트 위
  • 패널
  • 토스트
  • 도구 호출 가로채기
  • 프롬프트 읽기
  • UI 변경
  • 명령어/도구 추가

v2.1.291에서 테스트됨

Claude Code에서 실행 중인 Agent Profiler추천

Agent Profiler

Claude Code 세션의 시간이 모델 대기, 도구, 서브에이전트 중 어디에 쓰였는지 상태 표시줄에 실시간으로 보여 주고 OTLP 트레이스도 내보냅니다.

  • 상태 표시줄
  • 패널
  • 토스트
  • 파일 쓰기
  • 네트워크
  • 도구 호출 가로채기
  • UI 변경
  • 명령어/도구 추가

v2.1.303에서 테스트됨

더 보기: 패널 및 대시보드, 타이머, 할 일, 스탠드업.