AI 코딩 에이전트 세션 비용 확인하기, AgentsView 로컬 대시보드로 한곳에 모으기

Claude Code와 Codex를 함께 쓰면 어느 작업이 토큰을 많이 썼는지, 이전 대화가 어디에 남았는지 찾기 어려워집니다. AgentsView는 로컬 세션 파일을 SQLite에 모아 대시보드와 검색 화면으로 보여줍니다.

직접 돌려보지는 않았습니다. 공식 README와 2026-07-10 릴리스 노트를 기준으로 정리했습니다. 저라면 여러 에이전트를 오가며 작업할 때만 이 도구를 붙이겠습니다. 에이전트가 하나면 기존 CLI 기록으로도 충분합니다.

적용 대상

• Claude Code, Codex 등 여러 코딩 에이전트의 대화와 작업량을 한곳에서 보려는 경우입니다.
• 날짜별 토큰 사용량과 추정 비용을 모델별로 나누어 확인하려는 경우입니다.
• 로컬 PC의 세션 파일을 검색하되 외부 계정을 새로 만들고 싶지 않은 경우입니다.

AgentsView는 첫 실행에서 지원하는 에이전트 세션을 찾아 로컬 SQLite 데이터베이스에 넣습니다. 기본 웹 화면은 http://127.0.0.1:8080에서 열립니다. 비슷한 컨테이너 관리 화면이 필요하면 Docker Compose로 n8n을 올린 글도 같이 볼 만합니다.

사전 준비 사항

Linux 또는 macOS 터미널, 읽을 수 있는 에이전트 세션 디렉터리가 필요합니다. Windows는 공식 PowerShell 설치 명령을 사용합니다. 세션 안에는 프롬프트와 코드 조각이 남을 수 있으므로 공유 PC에서는 브라우저 화면을 열어 둔 채 자리를 비우지 않는 편이 낫습니다.

공식 문서는 서비스 화면을 루프백 주소에만 묶습니다. SSH 포트 포워딩이나 리버스 프록시 뒤에서 열면 --public-url에 브라우저에서 여는 정확한 주소를 넣어야 합니다. 외부 네트워크에 공개할 때는 인증도 같이 켜야 합니다. 이때 --require-auth 옵션을 씁니다.

설치 절차

• macOS와 Linux에서는 공식 설치 스크립트를 실행합니다. 운영 서버라면 스크립트 내용을 먼저 확인한 뒤 실행하시면 됩니다.

curl -fsSL https://agentsview.io/install.sh | bash

• 세션 목록과 비용 요약을 먼저 확인합니다. usage daily는 기본으로 최근 30일을 집계하며, 모델별 분리는 --breakdown 옵션으로 봅니다.

agentsview session list
agentsview usage daily --breakdown

• 웹 대시보드를 띄울 때는 아래 명령을 씁니다. 데이터가 없으면 설치 실패로 단정하지 말고, 대상 에이전트의 세션 경로가 기본 위치에 있는지 확인하시면 됩니다.

agentsview serve

확인

브라우저에서 http://127.0.0.1:8080을 열고 Sessions 목록에 기록이 보이는지 확인합니다. 터미널에서는 아래 명령 결과에 날짜별 토큰과 cost_usd 항목이 나오면 비용 집계가 준비된 것입니다.

agentsview usage daily --all --json