SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Порівняння трекерів витрат Claude Code

Дізнайтеся, чому трекери показують різні суми: порівняння локальних парсерів журналів, вбудованих екранів usage та стеку OpenTelemetry.

Що насправді читає трекер витрат Claude Code

Кожен трекер витрат Claude Code читає одне з трьох джерел даних, і саме джерело визначає, на яке запитання він може відповісти. Парсер журналів читає файли стенограм сеансів на вашому диску. Дашборд читає записи про використання, які Anthropic зберігає для вашого облікового запису або організації. Система метрик читає потік OpenTelemetry (OTel), який Claude Code передає після ввімкнення відповідної функції. Усі три джерела можуть одночасно бути правильними й усе одно показувати різні результати, оскільки вони підраховують різні показники.

У цьому посібнику токени не пояснюються повторно. У матеріалі як Claude Code підраховує використання токенів описано вхідні та вихідні дані, операції запису в кеш і читання з кешу. Без розуміння цієї частини дашборд мало що пояснює. Тут розглядається вужче питання: що може бачити кожен тип інструмента і чого він ніколи не може побачити.

Чому за один день з’явилися три трекери витрат Claude Code

Три окремі трекери витрат Claude Code опублікували в один день. Це не були три версії одного інструмента, і саме це важливо. Один аналізував локальні файли сеансів. Другий працював як обгортка для екранів використання облікового запису. Третій був розміщеним бекендом трасування, який ви запускаєте самостійно.

Вони з’явилися одночасно, тому що вартість сеансу агента перестала бути очевидною. Вартість чату приблизно відповідає тому, що ви бачите на екрані. Агент читає двадцять файлів, запускає набір тестів і повторно надсилає весь діалог під час кожного ходу, тому рахунок визначається контекстом, який ви не вводили. У межах підписки показана Claude Code сума в доларах є оцінкою. Anthropic зазначає, що вона не має значення для білінгу. Важливим є індикатор використання, який у різні дні заповнюється з різною швидкістю. Кожен із трьох інструментів закриває окрему частину цієї прогалини.

Форма 1: локальний аналізатор журналів показує вартість використання за сьогодні

Claude Code зберігає кожну розмову у форматі JSON Lines (JSONL) у ~/.claude/projects/<project>/<session-id>.jsonl, де <project> — шлях до робочого каталогу, у якому неалфавітно-цифрові символи замінено на -. Кожен хід асистента в цьому файлі містить кількість токенів для відповідного запиту. Аналізатор журналів підсумовує ці значення та розраховує їхню вартість.

ccusage — найпоширеніший вибір. Його не потрібно встановлювати:

npx ccusage@latest daily
npx ccusage@latest daily --breakdown
npx ccusage@latest blocks
npx ccusage@latest session --json

daily підсумовує дані за датою. --breakdown розподіляє кожен рядок за моделлю, завдяки чому можна побачити, що один день роботи з Opus становить більшу частину тижня. blocks групує дані за п’ятигодинним періодом, після якого підписка поновлює ліміт. session підсумовує дані для кожної розмови, а daily --instances групує їх за проєктом, щоб показати, який репозиторій є найдорожчим. Додайте --since і --until, щоб обмежити діапазон, і виконайте npx ccusage@latest daily --help, щоб визначити формат дат, якого очікує ваша версія. Станом на жовтень 2026 року інструмент також читає дані інших CLI для агентів, зокрема Codex і OpenCode, що важливо під час їх порівняння. Звіти за замовчуванням об’єднують усі виявлені джерела; додайте claude перед daily або session, щоб зосередитися на Claude Code.

Ціни беруться з таблиці цін на моделі, а інструмент має три режими розрахунку вартості. --mode auto використовує значення costUSD, записане Claude Code у файл, якщо воно є, і розраховує вартість за кількістю токенів, якщо його немає. --mode calculate завжди розраховує вартість за токенами та ігнорує записану вартість. --mode display показує лише записану вартість і виводить $0.00 для рядків, у яких її немає. Якщо підсумок виглядає неправильним, запустіть той самий звіт із calculate, а потім із display. Велика різниця між результатами означає, що для більшості записів немає збереженої вартості, тому всі наведені значення є оцінками. Якщо ви сплачуєте за договірними тарифами, значення pricingOverrides у defaults у файлі конфігурації ccusage.json замінює ціну для окремих моделей.

Ті самі дані можна використовувати у вашому prompt. ccusage statusline виводить компактний рядок для рядка стану Claude Code; його можна підключити до ~/.claude/settings.json так само, як будь-яку іншу команду для рядка стану. Див. створення рядка стану Claude Code, де наведено блок налаштувань і поля, які він отримує.

Аналізатор журналів не може побачити те, що не відбувалося на цьому комп’ютері. Другий ноутбук, сеанс на claude.ai або робота колеги: ці транскрипти зберігаються на відповідних дисках. Старі термінальні сеанси за замовчуванням видаляються після 30 днів бездіяльності відповідно до cleanupPeriodDays, але термін зберігання можна налаштувати: використовуйте велике значення, наприклад 3650, щоб зберігати історію протягом кількох років. Транскрипти сеансів, які запущено або які востаннє продовжено в Desktop чи Cowork, за замовчуванням зберігаються довше цього періоду. Є винятки, зокрема для конфігурацій HIPAA.

Є ще один ризик, пов’язаний зі структурою даних. У документації Anthropic зазначено, що формат записів є внутрішнім форматом Claude Code і змінюється між версіями, тому скрипти, які безпосередньо аналізують ці файли, можуть перестати працювати з будь-яким випуском. Це стосується кожного інструмента такого типу. Саме тому написаний вручну однорядковий jq для обробки JSONL є гіршою ідеєю, ніж здається: супроводжувані аналізатори відстежують зміни формату за вас, а ваш однорядковий скрипт у день перейменування поля покаже впевнено неправильне число.

Насамкінець потрібне застереження щодо суми в доларах у межах підписки. Використання в межах ліміту вашого плану Pro або Max не тарифікується за кількістю токенів, тому ця сума показує, скільки коштували б ваші токени за стандартними тарифами API. Вона вимірює інтенсивність використання. Це не ваш рахунок. Винятком є кредити на використання: якщо їх увімкнути, використання понад ліміт плану тарифікується за стандартними тарифами API як окрема плата, а claude.ai показує витрати за цей місяць у Settings > Usage. Якщо насправді потрібно визначити, який план обрати, це окреме порівняння: див. тарифи API та підписка Claude.

Форма 2: вбудовані екрани використання показують, яка модель витратила бюджет

Claude Code має вбудовану звітність, але більшість користувачів ніколи її не відкриває. Виконайте /usage у межах сеансу. Блок Session угорі показує кількість токенів для кожної моделі та суму в доларах за поточний сеанс. Дані обчислюються локально на основі кількості токенів і стандартних тарифів, якщо адміністратор не налаштував таблицю modelPricing у керованих параметрах. У такому разі в рядку Total cost буде зазначено at your organization's configured rates. У будь-якому випадку це лише приблизна оцінка, яка може відрізнятися від суми у вашому рахунку. Для планів Pro або Max Anthropic зазначає, що ця сума не має значення для виставлення рахунків, оскільки таке використання включене до плану. Підсумки скидаються, коли /clear починає нову розмову.

У планах Pro, Max, Team або Enterprise із оплатою за місце цей самий екран показує, яку частину ліміту плану використано. У Enterprise з оплатою за використання немає включеного обсягу, який можна вичерпати, оскільки кожен токен оплачується за тарифами API. У цих планах екран також розподіляє нещодавнє використання між skills, subagents, plugins та окремими MCP-серверами у відсотках від загального обсягу. Він позначає дії, на які припадає 10% або більше нещодавнього використання, наприклад довгий контекст або промахи кешу. Натискайте d або w, щоб перемикатися між останніми 24 годинами та останніми 7 днями. Ці значення є приблизними й обчислюються з локальної історії сеансів на цьому комп’ютері, тому використання на другому пристрої не враховується. Коли ліміт вичерпано, Claude Code називає цей ліміт і показує час його скидання; порожня смуга використання не означає, що ліміт вичерпано. Сеанс може зачекати й продовжити роботу після скидання, а дії після досягнення ліміту — це окреме рішення щодо моделі, контексту та плану.

Якщо користувачів більше одного, показники переходять на рівень облікового запису. Організація API отримує сторінку Console Cost, панель Claude Code із витратами та прийнятими рядками для кожного учасника, а також Claude Code Analytics API, який за допомогою ключа адміністратора повертає ті самі щоденні показники для кожного користувача. Плани Team та Enterprise мають звіт про витрати в консолі адміністратора з експортом у CSV, який оновлюється щодня. Він охоплює витрати за usage credits у планах із оплатою за місце та повне використання в Enterprise з оплатою за використання. Enterprise також має analytics API. Який саме звіт ви бачите, залежить від способу входу кожного розробника, тому організації зі змішаною конфігурацією потрібно переглядати два звіти й підсумовувати їх вручну.

Для планування бюджету опублікований показник у документації Anthropic про вартість станом на October 2026 становить у середньому близько $13 на розробника за активний день і $150–$250 на розробника на місяць; у 90% користувачів витрати не перевищують $30 за активний день. Розглядайте це як опублікований орієнтир для корпоративних розгортань, а не як прогноз для вашої команди. Спочатку сформуйте пілотну групу та виміряйте показники, а вже потім екстраполюйте результати.

Панелі не показують дані з точністю до дня та окремого користувача. Вони повідомлять, що Opus використовувалася більшу частину вівторка. Але вони не покажуть, який prompt, repository або CI job спричинили це використання. Крім того, дані надходять із затримкою, оскільки звіти організації оновлюються щодня. Тому панелі призначені для аналізу, а не для виявлення агента, який неконтрольовано витрачає ресурси цього дня. Для такого виявлення потрібні ліміти, а не звіти. Цьому присвячено розділ обмеження витрат агента на VPS.

Форма 3: власний стек OpenTelemetry показує, який prompt спричинив погіршення

Claude Code передає метрики й події OpenTelemetry після ввімкнення telemetry та налаштування exporters. Це єдиний варіант, який передає дані про token usage і витрати окремих користувачів у систему під вашим контролем майже в реальному часі. Метрики містять claude_code.cost.usage у USD, claude_code.token.usage у tokens, claude_code.session.count і claude_code.active_time.total.

Найцікавіша метрика — метрика tokens, оскільки вона має атрибути. Кожна точка даних містить type, значенням якого є input, output, cacheRead або cacheCreation, а також model і query_source, значенням якого є main, subagent або auxiliary. Вона також містить agent.name, skill.name, mcp_server.name і mcp_tool.name. Назви MCP servers, які ви налаштували самостійно, і власних custom subagents передаються як custom, якщо не встановити OTEL_LOG_TOOL_DETAILS=1. Цей параметр також додає Bash commands і tool input до tool events. Цього достатньо, щоб отримати відповіді на запитання, недоступні жодній dashboard: яка частина рахунку припадає на subagents, а яка — на ваші власні turns; чи подвоїв один MCP server обсяг input tokens; чи зменшилася кількість cache reads після редагування CLAUDE.md. Саме в поведінці cache зазвичай приховується несподіванка. У матеріалі коли prompt caching окупається пояснено, на що слід звертати увагу.

Варто виправити одну поширену помилку, оскільки це питання виникає в кожному обговоренні цієї теми. Langfuse — хороший self-hosted tracing backend, а його запуск на VPS описано в матеріалі self-hosting Langfuse для agent tracing. Його OTLP endpoint приймає лише traces. За замовчуванням Claude Code експортує metrics і log events, а не spans. Тому передавання OTEL_EXPORTER_OTLP_ENDPOINT до Langfuse залишає project порожнім і не дає жодної корисної помилки. Експорт spans підтримується, але в beta-режимі він залишається вимкненим, доки не встановити CLAUDE_CODE_ENHANCED_TELEMETRY_BETA=1 і OTEL_TRACES_EXPORTER. Власна інтеграція Langfuse з Claude Code працює інакше: Stop hook або plugin, який його встановлює, читає session transcripts після кожної відповіді та перетворює їх на traces. Тому на неї поширюються ті самі обмеження локального log parser. Langfuse підходить для agents, які ви створюєте безпосередньо через API, коли ваш власний код створює кожен span із його prompt, model і cost. Для підсумків витрат із Claude Code CLI оптимальним варіантом є metrics store.

Налаштування відстеження витрат Claude Code на власному VPS

Достатньо двох сервісів: collector для отримання метрик і Prometheus для їх зберігання. Не відкривайте жоден із них у публічний інтернет, оскільки відкритий OTLP-порт приймає записи від будь-кого, хто його знайде. Створіть /opt/ccmetrics/compose.yaml:

services:
  collector:
    image: otel/opentelemetry-collector-contrib:latest
    command: ["--config=/etc/otel/config.yaml"]
    volumes:
      - ./collector.yaml:/etc/otel/config.yaml:ro
    ports:
      - "10.8.0.1:4318:4318"
    restart: unless-stopped
  prometheus:
    image: prom/prometheus:latest
    volumes:
      - ./prometheus.yml:/etc/prometheus/prometheus.yml:ro
      - prom-data:/prometheus
    ports:
      - "127.0.0.1:9090:9090"
    restart: unless-stopped

volumes:
  prom-data:

10.8.0.1 — це адреса сервера всередині WireGuard-тунелю. Тому collector доступний із ваших машин і недоступний звідусіль. Адреса перед портом тут має практичне значення, оскільки опубліковані Docker-порти не фільтруються через ufw: див. чому опубліковані Docker-порти обходять ufw. Налаштування самого тунелю описано в розділі WireGuard VPN на власному VPS.

/opt/ccmetrics/collector.yaml:

receivers:
  otlp:
    protocols:
      http:
        endpoint: 0.0.0.0:4318

processors:
  batch:

exporters:
  prometheus:
    endpoint: 0.0.0.0:8889

service:
  pipelines:
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [prometheus]

/opt/ccmetrics/prometheus.yml. Порт 8889 ніколи не публікується на хості, оскільки Prometheus звертається до collector через Compose network за іменем сервісу:

global:
  scrape_interval: 30s

scrape_configs:
  - job_name: claude-code
    static_configs:
      - targets: ["collector:8889"]
cd /opt/ccmetrics
docker compose up -d
docker compose logs collector

Журнал collector має завершуватися повідомленням Everything is ready. Begin running and processing data.. Якщо журнал зупиняється через помилку конфігурації, YAML не вдалося розібрати, і контейнер перезапускатиметься в циклі.

Тепер підключіть до нього Claude Code. На кожній машині, де працює Claude Code, додайте це до ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "none",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/protobuf",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://10.8.0.1:4318",
    "OTEL_METRIC_EXPORT_INTERVAL": "10000"
  }
}

Запустіть сеанс, надішліть один prompt, дочекайтеся інтервалу експорту (тут 10 секунд, типове значення — 60 секунд), а потім запитайте Prometheus, які дані він отримав:

curl -s http://localhost:9090/api/v1/label/__name__/values | grep -o 'claude_code[a-z_]*'

Ви маєте отримати кілька назв, що починаються з claude_code_. Exporter замінює крапки на символи підкреслення та додає одиницю вимірювання, тому точні рядки залежать від версії collector. Порожній результат означає, що дані не надійшли. Перевірте, чи збігаються протокол і порт, оскільки http/protobuf використовує порт 4318, а grpc — порт 4317; невідповідність не спричиняє явної помилки. Виконайте claude --debug-file /tmp/claude-debug.log і знайдіть у цьому файлі рядки [3P telemetry]. Саме там Claude Code повідомляє про помилки експорту OTel.

Якщо потрібна одна машина без сервера, пропустіть усе описане вище. Установіть CLAUDE_CODE_ENABLE_TELEMETRY=1 і OTEL_METRICS_EXPORTER=prometheus, і Claude Code сам надасть endpoint для збору метрик за адресою http://localhost:9464/metrics. Коли prometheus є єдиним переліченим exporter, Claude Code вилучає одиниці USD, tokens і s з експортованих метрик, щоб scrape залишався коректним текстовим форматом Prometheus. Назви метрик не змінюються, а налаштування, яке об’єднує exporter-и, наприклад otlp,prometheus, зберігає ці одиниці.

Така схема потребує окремого рішення щодо конфіденційності. Типово з машини передаються лише лічильники та метадані, без тексту prompt і результатів роботи інструментів. OTEL_LOG_USER_PROMPTS=1 додає текст prompt до експортованих подій і також вмикає текст відповіді assistant, якщо OTEL_LOG_ASSISTANT_RESPONSES=0 його не перевизначає. OTEL_LOG_TOOL_CONTENT=1 додає вибрані результати роботи інструментів до trace spans із винятками та обрізанням за лімітом вмісту, який типово становить 60 KB. Ці прапорці можуть розкрити вихідний код і секрети у вибраному вмісті; вони не експортують автоматично весь контекст. Для повних текстів розмов потрібне окреме налаштування OTEL_LOG_RAW_API_BODIES. Вмикайте ці параметри лише свідомо та спочатку прочитайте як не допускати секрети в контексті агента.

Відстеження витрат для скриптових запусків і запусків у CI

Саме неінтерактивні запуски застають людей зненацька, оскільки ніхто не стежить за екраном. claude -p за допомогою --output-format json повідомляє в payload результату вартість цього запуску:

claude -p "summarise the failing tests" --output-format json | jq '.total_cost_usd'

Payload містить total_cost_usd і розподіл витрат за кожною моделлю, тому завдання CI може записувати власні витрати без dashboard. Як і будь-яке локальне значення, це оцінка на стороні клієнта. Якщо запуск продовжує розмову з --continue або --resume, він повідомляє загальну вартість усієї розмови, включно з попередніми запусками. Додайте це значення до файлу або передайте його як метрику до колектора, описаного вище. Це найдешевший практичний спосіб відстежувати витрати, і для кожного запуску він потребує одного виклику jq.

Режими відмови та що ви побачите

Звіт порожній. npx ccusage@latest daily не виводить рядків, отже, він не читає каталог, у який Claude Code записує дані. CLAUDE_CONFIG_DIR змінює це розташування, і ccusage також читає цю змінну, тому запускайте обидва інструменти з однаковим значенням. Якщо старі сеанси відсутні, перевірте cleanupPeriodDays: термінальні сеанси за замовчуванням видаляються після 30 днів бездіяльності, а транскрипти Desktop і Cowork зазвичай зберігаються довше.

Дві машини показують різні підсумки. Це очікувана поведінка, а не помилка. І /usage, і будь-який парсер журналів читають лише локальну історію сеансів, тому використання з іншого пристрою або з claude.ai не враховується в жодному з них.

Локальний підсумок не збігається з рахунком. Локальні значення обчислюються на основі кількості токенів за стандартними list rates, якщо не налаштувати контрактні тарифи: таблиця modelPricing у керованих налаштуваннях для /usage або pricingOverrides для ccusage. У разі підписки використання в межах ліміту плану взагалі не тарифікується за кількістю токенів, а тарифікуються лише usage credits. Сторінка Console Cost є авторитетним джерелом для розрахунків за API.

Вартість зросла, хоча ви виконували ту саму роботу. Спочатку перевірте стовпці кешу. Довгий сеанс повторно надсилає всю історію на кожному кроці: під час дії кешу застосовується cached rate, а після його завершення — повна ставка для вхідних даних. Тому одна тривала перерва призводить до повторної обробки всієї розмови. Це відображається як велике значення для вхідних даних поруч із малим значенням для вихідних даних, а тарифікація вхідних і вихідних токенів пояснює, чому ці показники змінюються незалежно один від одного.

День із subagents виглядає нереалістично. Кожен subagent використовує власне контекстне вікно, тому кількість токенів залежить від кількості запущених subagents і тривалості роботи кожного з них. У плані атрибуція /usage показує частку subagent для цієї машини у відсотках. Для деталізації на рівні запитів дані OTel розділяють їх за допомогою атрибута query_source у claude_code.token.usage. Парсер журналів покаже загальний підсумок, але не дасть змоги визначити окремі значення.

FAQ

Чи показує ccusage, скільки я фактично плачу на плані Max?

Ні. Використання в межах ліміту плану підписки не тарифікується за токенами. Тому аналізатор журналів розраховує вартість ваших токенів за стандартними публічними тарифами API та показує, скільки та сама робота коштувала б через API. Це зручний відносний показник навантаження за день, а також спосіб порівнювати між собою проєкти або моделі. Щоб дізнатися фактичну суму до сплати, використовуйте сторінку Console Cost для тарифікації API, а для підписки — сторінку тарифікації плану. Якщо для вас увімкнені кредити на використання, обсяг понад ліміт тарифікується за стандартними тарифами API, а claude.ai показує ці витрати в Settings > Usage.

Де Claude Code зберігає файли сеансів, які читають ці інструменти?

У ~/.claude/projects/<project>/<session-id>.jsonl, де <project> — шлях до робочого каталогу, у якому неалфавітно-цифрові символи замінено на -. Кожен рядок є JSON-об’єктом для одного повідомлення, використання інструмента або запису метаданих. CLAUDE_CONFIG_DIR переміщує весь каталог, а cleanupPeriodDays у settings.json керує строком зберігання. За замовчуванням для термінальних сеансів він становить 30 днів бездіяльності. Транскрипти Desktop і Cowork зазвичай зберігаються довше. Anthropic описує формат записів як внутрішній, який може змінюватися між версіями. Тому використовуйте інструмент, що підтримується, а не власний скрипт для їх аналізу.

Чи можу я надсилати телеметрію Claude Code до Langfuse?

Не за допомогою телеметрії за замовчуванням. Кінцева точка Langfuse OTLP приймає trace-дані, а Claude Code за замовчуванням експортує метрики та події журналу, а не spans. Тому ці дані немає куди записувати. Експорт spans є beta-функцією, яку потрібно окремо ввімкнути. Власна інтеграція Langfuse з Claude Code натомість використовує Stop hook, що перетворює транскрипти сеансів на trace-дані. Для підсумків витрат надсилайте метрики Claude Code до OpenTelemetry collector і зберігайте їх у Prometheus. Використовуйте Langfuse для агентів, яких ви самостійно створюєте через API, де ваш код генерує spans із prompt, model і cost.

Чому мої локальні показники не збігаються зі сторінкою використання в Console?

Тому що вони обчислюються по-різному. /usage і аналізатори журналів підсумовують кількість токенів із файлів сеансів на машині, за якою ви працюєте, а потім розраховують вартість за стандартними публічними тарифами, якщо не налаштовано договірні тарифи. Для цього вони використовують modelPricing у керованих налаштуваннях для /usage або pricingOverrides для ccusage. Console охоплює використання вашої організації на різних машинах і з різними ключами. Для фактичних витрат API використовуйте її сторінку Cost, оскільки показники витрат на аналітичній панелі Claude Code є оцінками. Розбіжність є нормальною. Значна розбіжність зазвичай означає, що до цього самого облікового запису тарифікується використання з другого пристрою, CI runner або іншого учасника команди.

Як відстежувати вартість запуску claude -p у CI?

Запустіть його з --output-format json і прочитайте total_cost_usd з результату, наприклад за допомогою claude -p "..." --output-format json | jq '.total_cost_usd'. Той самий payload містить розподіл за моделями та ідентифікатор сеансу. Записуйте це значення для кожного job — і отримуватимете витрати для кожного pipeline без агента, dashboard або додаткового сервісу.

Чи була ця стаття корисною?