splunk/token-meter

📝 Launch blog · 🌐 Website · 📚 Learn Tokenomics

Token Meter는 AI 코딩 에이전트를 위한 오픈 소스, 로컬 우선 사용량 및 비용 대시보드입니다. 이 도구는 Claude, Codex, Cursor, OpenCode, Kiro, Pi의 토큰 사용량, 예상 비용, 컨텍스트 압력(context pressure), 시간, 그리고 툴 활동을 한 곳에서 보여줍니다.

로컬 전용. Python 표준 라이브러리만 사용하며 API 키나 원격 측정(telemetry) 기능이 없습니다. 정직한 수치. 추정치는 명시되며, 증거가 누락된 부분은 '사용 불가'로 표시되고 절대 0으로 처리되지 않습니다.

git clone https://github.com/splunk/token-meter.git
./token-meter/scripts/install

이 명령을 실행하면 로컬 서버와 네이티브 컴패니언(companion)이 시작되고 자동 시작이 활성화됩니다. 메뉴 바/트레이 컴패니언을 건너뛰려면 --backend-only 옵션을 추가하세요.

베타: Windows 확장 기능은 아직 베타 버전입니다.

`powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -Command '$p=Join-Path $env:TEMP

라이브 비용, 토큰, 컨텍스트 압력, 출력 속도, 도구 호출, 세션 예산, 그리고 자식 에이전트 활동을 한 페이지에서 확인하세요.

플랫폼, 프로젝트, 런타임, 세션을 가로질러 모든 기간을 비교하여 검토할 만한 실행(run)을 찾아보세요.

출력이 많거나, 실패하거나, 반복되거나, 사용되지 않은 도구 및 스킬 팩을 확인하세요.

로컬 git만을 사용하여 로컬 푸시와 지출액을 쌍으로 비교하여 프로젝트별/일자별 변경된 코드를 보여줍니다. 이는 생산성 점수가 아닌 기계적인 신호입니다.

각 명명된 자식 에이전트 역할(child-agent role)에 대한 지출, 실행당 비용, 그리고 볼륨을 추적하고, **세션 (Sessions) → 서브 에이전트 (Subagents)**에서 개별 실행으로 드릴다운할 수 있습니다.

월간 및 세션별 예산을 설정하고, 모델 가격 책정을 편집하며, Codex 또는 Claude를 로컬 MCP에 연결하세요. 여기에는 8개의 읽기 전용 증거 도구(check, usage, budget, capabilities, sessions, trace, stats, schema)와 confirm: true가 필요한 2개의 세션 예산 설정기가 포함됩니다. 트레이스(Traces)는 원시 트레이스 내용이 아닌 허용 목록화된 구조와 숫자만 다룹니다. 자세한 내용은 사용자 가이드(User guide)를 참조하세요.

대시보드를 열지 않고도 현재 실행 상태를 확인할 수 있습니다. 업데이트는 10분마다 확인되며 기본적으로 자동 설치됩니다.

• 대시보드는 127.0.0.1에 바인딩됩니다. 외부에 노출하지 마세요. - 트레이스, 프롬프트, 응답, 경로 및 분석 데이터는 절대 귀하의 기기를 벗어나지 않습니다.
• MCP는 파생된 숫자만 반환합니다. 연결하는 에이전트는 이 데이터를 자체 모델 제공업체로 전송할 수 있습니다.
• 비용은 추정치입니다. Codex는 공개 API 요금을 사용하며, 이는 구독 결제와 다를 수 있습니다.

자세한 내용은 사용자 가이드(User guide) · 보안 정책(Security policy)을 참조하세요.