AgentsView에서 새 모델 가격을 직접 넣어야 하는 이유

AI 코딩 에이전트를 여러 개 쓰기 시작하면 곧바로 생기는 질문이 있습니다. “어떤 에이전트가, 어떤 모델로, 얼마나 비용을 쓰고 있나?” AgentsView는 이 질문에 답하기 위한 로컬 Python 도구입니다. 계정 없이 실행되며, 첫 실행 시 지원되는 에이전트 세션을 로컬 SQLite 데이터베이스에 동기화합니다.¹ 웹 UI는 기본적으로 http://127.0.0.1:8080에서 열립니다.¹

핵심은 단순한 토큰 조회가 아니라 비용 추적입니다. 그런데 비용 추적은 모델 가격 정보가 정확할 때만 의미가 있습니다. 특히 새 모델을 빠르게 도입하는 팀이라면 AgentsView의 custom model pricing을 알아둘 필요가 있습니다.

새 모델은 가격 DB보다 먼저 쓰이기 쉽다

AgentsView는 모델별 토큰 사용량에 가격 정보를 적용해 비용을 계산합니다. 기본적으로 LiteLLM 요율을 통한 자동 가격 책정을 지원하고, 오프라인 fallback도 제공합니다.¹ 그래서 많은 모델은 별도 설정 없이 비용을 볼 수 있습니다.

문제는 새 모델입니다. 예를 들어 Claude Fable 5처럼 아직 AgentsView의 가격 데이터베이스에 포함되지 않은 모델을 쓰면, 사용량은 확인되더라도 비용 추정이 빠지거나 부정확해질 수 있습니다. 이 경우 “토큰을 얼마나 썼는지”는 보여도 “그래서 얼마인지”라는 판단이 흐려집니다.

이때 custom model pricing이 필요합니다. 모델 가격이 공식 DB에 반영되기 전이라도 로컬 설정에 단가를 직접 넣어 비용 관측을 이어갈 수 있습니다.

[custom_model_pricing."claude-fable-5"]
input = 10.0
output = 50.0
cache_creation = 12.50
cache_read = 1

위와 같이 ~/.agentsview/config.toml에 알려지지 않은 모델의 가격을 직접 지정할 수 있습니다.²

입력·출력만 보면 비용을 놓칠 수 있다

custom pricing을 설정할 때는 입력 토큰과 출력 토큰만 보면 부족합니다. AgentsView는 프롬프트 캐싱을 고려해 cache_creation 토큰과 cache_read 토큰도 비용 계산에 반영합니다.¹

즉 AgentsView에서 봐야 할 단가는 네 가지입니다.

• input: 입력 토큰 단가

• output: 출력 토큰 단가

• cache_creation: 캐시 생성 토큰 단가

• cache_read: 캐시 읽기 토큰 단가

이 구분은 실제 비용 감각에 중요합니다. 같은 프롬프트라도 캐시를 새로 만드는 경우와 기존 캐시를 읽는 경우의 비용 구조가 달라질 수 있기 때문입니다. 새 모델 가격을 직접 넣을 때는 네 항목을 함께 확인해야 비용 추정이 더 안정적입니다.

설정 후에는 일별·모델별로 확인한다

가격을 넣었다면 바로 확인해야 합니다. 가장 빠른 방법은 CLI입니다.

agentsview usage daily

이 명령은 기본적으로 최근 30일의 일별 비용 요약을 출력합니다.¹ 모델별 사용량과 비용을 나눠 보고 싶다면 --breakdown을 붙입니다.¹

agentsview usage daily --breakdown

기간을 좁히거나 넓힐 수도 있습니다. --since, --until, --all 옵션으로 날짜 범위를 필터링할 수 있고, --agent 옵션으로 특정 에이전트만 볼 수 있습니다.¹

agentsview usage daily --since 2025-01-01 --until 2025-01-31
agentsview usage daily --agent claude-code

자동화나 리포팅이 필요하다면 --json 출력도 사용할 수 있습니다.¹

agentsview usage daily --breakdown --json

비용 관측은 모델 도입의 일부다

새 모델을 도입할 때 성능만 비교하면 비용 판단이 늦어집니다. 특히 코딩 에이전트처럼 반복 호출이 많고 캐시 사용이 섞이는 환경에서는 작은 단가 차이도 누적될 수 있습니다.

AgentsView의 custom model pricing은 새 모델을 쓰기 시작한 시점부터 비용을 추적하기 위한 장치입니다. 가격 DB 업데이트를 기다리지 않고 로컬에서 단가를 지정하면, 개발 중에도 모델별·에이전트별 비용 흐름을 확인할 수 있습니다.

결론은 간단합니다. 새 코딩 모델을 시험할 때는 먼저 비용 관측이 가능한 상태를 만들어야 합니다. AgentsView에서는 custom model pricing을 설정하고, usage daily와 --breakdown으로 확인하는 것만으로도 “얼마나 썼는지”를 훨씬 빠르게 판단할 수 있습니다.

¹agentsview · PyPI

²Setting a custom price for a model in AgentsView