Claude Code 및 AI 에이전트 세션 모니터링을 위한 로컬 도구 Anjor 공개

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Claude Code와 같은 AI 에이전트의 토큰 사용량, 도구 호출 지연 시간, 컨텍스트 증가량을 로컬에서 실시간 모니터링하는 오픈소스 도구 Anjor가 공개됐다.

배경

Claude Code 사용 중 발생하는 과도한 토큰 소비와 도구 호출 실패를 추적하기 위해 개발자가 직접 로컬 모니터링 도구인 Anjor를 제작하여 공유했다.

의미 / 영향

AI 에이전트 개발 트렌드가 단순 실행을 넘어 비용과 성능의 가시성을 확보하는 운영 단계로 진화하고 있다. 특히 클라우드 기반 모니터링보다 보안과 지연 시간 측면에서 유리한 로컬 전용 도구에 대한 수요가 확인됐다.

커뮤니티 반응

작성자가 직접 개발한 도구에 대해 긍정적인 반응이 예상되며, 특히 Claude Code를 집중적으로 사용하는 개발자들의 피드백을 요청하고 있다.

주요 논점

01찬성다수

에이전트의 내부 작동 과정을 가시화하여 비용 최적화와 디버깅 효율을 높일 수 있다.

합의점 vs 논쟁점

합의점

AI 에이전트 운영 시 실시간 토큰 사용량과 도구 호출 상태를 확인하는 피드백 루프가 필수적이다.
민감한 코드와 API 키를 다루는 만큼 모니터링 도구의 로컬 실행 방식이 선호된다.

실용적 조언

Claude Code 세션의 비용이 걱정된다면 anjor start --watch-transcripts 명령어로 실시간 모니터링을 시작하라.
커스텀 에이전트를 개발 중이라면 anjor.patch()를 사용하여 별도의 로깅 로직 없이도 모든 API 호출을 기록할 수 있다.

언급된 도구

Anjor추천링크

AI 에이전트 세션 및 토큰 사용량 로컬 모니터링

pipx추천

파이썬 애플리케이션의 격리된 설치 및 실행

섹션별 상세

AI 에이전트 세션 중 발생하는 불투명한 비용과 성능 저하 문제를 해결하기 위해 로컬 대시보드를 구축했다. Anjor는 로컬 호스트 7843 포트에서 실행되며 Claude Code, Gemini CLI, Codex의 세션 트랜스크립트를 자동으로 감지하여 시각화한다. 별도의 계정 생성이나 클라우드 동기화 없이 사용자의 머신에서만 데이터가 처리되어 보안성을 확보했다.

bash

pipx install "anjor[mcp]"
anjor start --watch-transcripts

pipx를 사용하여 Anjor를 설치하고 세션 트랜스크립트 감시 모드로 실행하는 명령어

도구 호출의 지연 시간과 페이로드를 상세히 분석하여 에이전트의 병목 현상을 파악할 수 있다. 각 모델과 도구별로 세분화된 토큰 사용량을 보여주며, 세션 진행에 따른 컨텍스트 윈도우의 팽창 속도를 실시간으로 추적한다. 이를 통해 월말 청구서가 나오기 전에 비용 발생 원인을 즉각적으로 인지할 수 있는 피드백 루프를 제공한다.

python

import anjor
anjor.patch()

커스텀 에이전트 개발 시 httpx를 패치하여 API 호출을 캡처하는 코드

커스텀 에이전트 개발자를 위해 한 줄의 코드로 통합 가능한 계측 기능을 지원한다. anjor.patch() 함수를 호출하면 httpx 라이브러리를 패치하여 Anthropic, OpenAI, Gemini로 향하는 모든 API 요청을 캡처한다. 도구의 출력 스키마가 호출 간에 변경되거나 특정 입력값에서 도구들이 집단으로 실패하는 패턴을 분석하는 기능을 포함한다.

실무 Takeaway

Claude Code와 같은 코딩 에이전트 사용 시 발생하는 토큰 낭비와 도구 실패를 로컬 환경에서 실시간으로 추적할 수 있다.
Anjor는 별도의 설정 없이도 주요 CLI 에이전트의 트랜스크립트를 감지하며, 커스텀 에이전트에는 단 한 줄의 패치 코드로 적용 가능하다.
API 키나 프롬프트 데이터가 외부로 유출되지 않는 로컬 전용 구조를 채택하여 기업용 개발 환경에서도 보안 우려 없이 사용 가능하다.

언급된 리소스

GitHubAnjor GitHub Repository