AgentValley로 Mac에서 Claude Code 모니터링

AgentValley는 무엇을 하는 앱인가요?

AgentValley는 로컬 Claude Code 세션을 MacBook 노치 아래 패널에 모아 보여 주는 무료 오픈 소스 앱입니다. 쉽게 말해 AI 작업을 살펴보는 작은 상황판입니다. 다른 앱에서 일하면서 어떤 에이전트가 실행 중이고 어떤 에이전트가 답변을 기다리는지 확인할 수 있습니다. 세션이 시작한 하위 에이전트도 각각 행과 픽셀 캐릭터를 갖습니다. Claude Code와 macOS 15 이상이 필요합니다.

설치부터 세션으로 이동하기까지

1. 공식 DMG를 내려받아 AgentValley를 응용 프로그램으로 옮긴 뒤 실행합니다. Homebrew에서는 brew install --cask morsechimwai/tap/agent-valley를 사용합니다.
2. Claude Code 세션을 시작하고 노치에 포인터를 대어 프로젝트와 최근 동작이 맞는지 확인합니다.
3. 다른 앱에서 Control–Option–Command–A로 패널을 열고 방향키로 행을 고른 뒤 Return으로 세션에 이동합니다.
4. 패널에서 권한 요청에 답하려면 “Answer from the notch”을 켜고 설정에 표시된 플러그인 명령을 실행한 다음 Claude Code를 다시 시작합니다. 요청을 읽은 뒤 “Allow once”나 “Deny”를 직접 선택합니다.

응답 플러그인은 별도로 수동 설치하는 선택 기능입니다.

응답이 필요한 세션과 하위 에이전트 찾기

세션은 프로젝트별로 묶이고 worktree도 해당 프로젝트로 정리됩니다. 세션 카드에는 작업, 모델, 최근 단계가 나오며 하위 에이전트에는 단계 수도 표시됩니다. 주 작업과 위임한 탐색 작업을 구분할 때 유용합니다.

질문이나 권한 요청이 생기면 노치 옆에 빨간 숫자가 나타납니다. 패널에서 내용을 읽고 관련 앱으로 이동할 수 있습니다. “Go to the session’s tab”을 켜면 Terminal과 iTerm2에서 해당 탭을 찾습니다. Ghostty는 같은 폴더에서 두 세션을 실행하면 탭 구분이 모호할 수 있습니다. 기본으로 켜진 소리는 끄거나 간단한 알림음으로 바꿀 수 있습니다.

비용 추정치와 사용량 한도 읽기

그래프 버튼으로 History를 열어 일·주·월을 선택한 후 시간대나 프로젝트별 세션을 살펴볼 수 있습니다. 금액은 API 가격을 적용한 추정치이므로 사용량 비교에 활용해야 합니다. 구독 청구액이나 실제 결제 예정 금액과 같다고 보면 안 됩니다. 전체 프로젝트 또는 한 프로젝트의 PDF 보고서를 만들 수 있고, Claude Code가 오래된 파일을 지워도 기록은 Mac에 남습니다.

최근 5시간과 오늘의 토큰, 12시간 그래프도 제공합니다. “Plan limits”는 기본적으로 꺼져 있으며 켜면 5시간 및 주간 한도와 초기화 시간을 보여 줍니다. 2026년 10월 25일 확인 기준 앱은 무료이고 후원은 선택 사항입니다. Claude Code 접근 조건은 별도입니다.

로컬 데이터와 선택 기능의 접근 범위

공개 설명에 따르면 ~/.claude/projects, ~/.claude/sessions, 프로세스와 프로젝트 Git 정보를 읽습니다. 앱 데이터는 ~/Library/Application Support/AgentValley에 저장됩니다. “Plan limits”를 켠 경우에만 키체인의 Claude Code 로그인 정보를 읽어 api.anthropic.com으로 보냅니다. GitHub의 새 버전을 매일 확인하는 기능은 끌 수 있습니다.

선택적인 터미널 상태 줄은 ~/.claude/settings.json을 수정하고 글꼴을 설치하며 필요하면 Ghostty 설정에 한 줄을 추가합니다. 제거 명령으로 되돌릴 수 있습니다. 로컬 파일 중심으로 동작한다는 설명이 모든 설정에서 네트워크 통신이 없다는 뜻은 아닙니다.

어떤 개발자에게 적합한가요?

여러 로컬 세션을 병행하며 응답 대기 터미널을 찾는 개발자에게 적합합니다. 설정에서 연결된 외부 화면으로 패널을 옮길 수 있습니다. “quiet”는 2분 동안 기록된 활동이 없다는 의미이며, 확정된 멈춤이나 완료율을 나타내지 않습니다. 공식 문서의 대상은 Mac의 Claude Code입니다. 앱 코드는 MIT 라이선스이며 Anthropic과 독립된 프로젝트입니다.

자주 묻는 질문

AgentValley는 무료인가요?

네. 무료 오픈 소스 앱이며 후원은 선택입니다. Claude Code를 이용하는 조건이나 비용은 별도로 적용됩니다.

표시된 비용이 실제 청구액인가요?

아니요. API 가격으로 산출한 추정치입니다. 실제 결제액은 계정의 요금제와 청구 방식에 따라 달라집니다.

세션을 보려면 플러그인이 필요한가요?

일반적인 세션 표시에는 필요 없습니다. 노치에서 권한 요청을 허용하거나 거부할 때 수동으로 설치합니다.

공식 다운로드와 지원

• 공식 릴리스 및 다운로드
• 소스 코드와 설정 안내
• 버그와 제안을 위한 GitHub Issues