Agent Flow: Claude Code 실행 흐름을 실시간으로 시각화하는 도구
Agent Flow: A beautiful way to visualize what Claude Code does
TL;DR Highlight
Claude Code는 도구 호출 체인·시간 분포·서브에이전트 조율을 실시간 시각화해 디버깅과 프롬프트 개선을 가능하게 한다.
Who Should Read
Claude Code를 사용해 에이전트를 구축하거나 제품에 통합하는 개발자
Core Mechanics
- 에이전트 행동 이해: Claude가 문제를 어떻게 분해하는지, 어떤 도구를 선택하는지, 서브에이전트가 어떻게 협력하는지 시각적 확인
- 디버깅 지원: 실패 시 도구 호출 시퀀스와 결정 지점을 역추적 가능
- 프롬프트 학습: Claude가 프롬프트를 어떻게 해석하고 실행하는지 관찰해 더 나은 프롬프트 작성 능력 향상
- 제품 개발 지원: 에이전트를 자체 제품에 통합할 때 실제 동작 시각화로 빠른 반복 가능
Evidence
- 개발자가 매일 사용하며 프롬프트·도구 설계·오케스트레이션 로직 반복 개선에 활용
How to Apply
- Claude Code 에이전트 디버깅 시 Agent Flow로 도구 호출 체인을 시각화해 비효율적 분기나 중복 작업 식별
- 새로운 에이전트 프롬프트 작성 전 기존 프롬프트의 실행 패턴을 관찰해 Claude가 의도를 어떻게 해석하는지 파악
관련 논문
OpenKnowledge – Obsidian/Notion의 오픈소스 AI-first 대안
Git 기반 동기화와 Claude/Codex/Cursor 연동을 내장한 로컬 우선 마크다운 에디터로, AI 에이전트의 두 번째 뇌(LLM Wiki)로 활용할 수 있는 오픈소스 도구다.
Unfireable Safety Kernel: AI 에이전트를 위한 Execution-Time AI Alignment
AI 에이전트가 자신의 안전장치를 우회할 수 없도록, 에이전트 프로세스 바깥에 수학적으로 증명된 강제 통제 게이트를 배치하는 아키텍처
RubyLLM: 주요 AI 프로바이더를 모두 지원하는 Ruby 프레임워크
OpenAI, Claude, Gemini 등 주요 AI 프로바이더를 단일 인터페이스로 통합한 Ruby 프레임워크로, Rails 통합과 에이전트 기능까지 지원해 Ruby 개발자가 AI 기능을 빠르게 붙일 수 있다.
Qwen-AgentWorld: 범용 에이전트를 위한 Language World Model
Alibaba Qwen 팀이 AI 에이전트가 행동 결과를 미리 시뮬레이션할 수 있는 'Language World Model'을 공개했다. 에이전트 훈련과 실행 경로 검증에 새로운 패러다임을 제시하는 연구다.
SHERLOC: Code Repair Agent를 위한 구조화된 Diagnostic Localization 프레임워크
버그 위치만 알려주는 게 아니라 '왜, 어떻게 고쳐야 하는지'까지 진단 리포트를 생성해서 코드 수정 에이전트의 성능을 높이는 training-free 프레임워크
peerd – 브라우저에서 완전히 실행되는 AI Agent Harness
백엔드 서버 없이 Chrome/Firefox 확장 프로그램으로만 동작하는 AI 에이전트 실행 환경으로, 브라우저 탭을 직접 조작하고 WASM Linux VM까지 구동할 수 있어 프라이버시와 보안을 동시에 챙길 수 있다.