Як рахувати токени в Claude Code: повний гайд

Що таке токени в Claude?

Токен — це одиниця тексту, яку Claude зчитує та записує: фрагмент слова. Згідно з власним глосарієм Anthropic, для моделей, що передували Claude Opus 4.7, один токен дорівнював приблизно 3.5 англійським символам. У поточному токенізаторі це значення ближче до 2.5, оскільки Anthropic оцінює 1M токенів приблизно у 2.5M символів. У будь-якому разі, з урахуванням пробілів і розділових знаків, це виходить значно більше ніж один токен на слово, тому тисяча слів звичайного тексту — це впевнено понад 1,300 токенів. Код «важчий» у розрахунку на рядок: фігурні дужки, оператори, підкреслення та відступи розбиваються на більшу кількість токенів на символ, ніж англійська мова, і файл із вихідним кодом на кілька сотень рядків зазвичай займає кілька тисяч токенів. Файл на 2,000 рядків, який агент вирішує прочитати, — це п'ятизначна кількість токенів ще до того, як буде написано хоча б один рядок нового коду.

Дві особливості токенізаторів часто вводять в оману. По-перше, вони залежать від моделі. Станом на жовтень 2026 року Claude Opus 4.7 і всі наступні моделі, включно з поточними Fable 5.1, Opus 5.5, Sonnet 5.5 та Haiku 5.5, використовують новіший токенізатор. Він генерує приблизно на 30% більше токенів для того самого тексту, ніж ранні моделі Claude, як-от Haiku 4.5 (точне збільшення залежить від вмісту). Це змінює будь-який бюджет у токенах, навіть якщо ціни за токен при цьому не зросли. По-друге, tiktoken, бібліотека, до якої звертається кожен допис у блогах, — це токенізатор OpenAI, а не Claude, тому її підрахунки не збігатимуться з тим, що виставляє в рахунках Anthropic. Єдиним надійним джерелом підрахунку є ендпоінт count_tokens, описаний нижче.

Чому ваша сесія програмування коштує саме стільки

Кожен рахунок Claude, чи то API-інвойс, чи то ліміт підписки, базується переважно на одному показнику: вхідні та вихідні токени. Деякі інструменти API додають окремий рядок витрат (наприклад, вебпошук станом на жовтень 2026 року коштує $10 за 1 000 запитів на додаток до токенів, які генерують його результати), але в сесії програмування головним фактором є саме лічильник токенів. Сторінка з цінами виглядає просто: певна сума доларів за мільйон вхідних токенів і за мільйон вихідних. Проте вона не пояснює, що під час агентної сесії програмування лічильник вхідних даних працює набагато інтенсивніше, ніж здається на перший погляд, оскільки вся історія розмови повторно надсилається на кожному кроці. Я займаюся продажем інфраструктури з погодинною або поштучною оплатою вже п'ятнадцять років, і токени — це перший показник, щодо якого більшість клієнтів щиро не розуміють, що саме його накручує. Це урок з читання показників: що вважається вхідними та вихідними даними в агентній сесії, чому цикл повторного надсилання такий дорогий, чому prompt caching змінює розрахунки та які важелі насправді впливають на підсумкову суму.

Все є вхідними даними: що насправді враховує лічильник

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

• Системний промпт. Власні інструкції для Claude Code, а також ваші CLAUDE.md та файли пам'яті, що завантажуються на початку сесії та присутні в кожному наступному запиті.
• Визначення інструментів. Кожна схема інструмента, який може викликати агент. Кожен підключений MCP server збільшує ці фіксовані накладні витрати, хоча Claude Code тепер за замовчуванням відкладає повні визначення інструментів MCP, тому в контексті залишаються лише назви інструментів до моменту їх першого використання, що зменшує, але не усуває витрати.
• Кожен файл, який зчитує агент. Read вихідного файлу додає весь його вміст у контекст, і він залишається там.
• Кожен результат роботи інструмента. Запуски тестів, вивід grep, дані з термінала, журнали збірки — все це повертається як вхідні токени. Невдалий набір тестів, що виводить 8,000 рядків, за обсягом дорівнює невеликій книзі. Станом на жовтень 2026 року Claude Code за замовчуванням передає приблизно 30,000 символів виводу команди вбудовано, а все, що довше, зберігається як файл із прев'ю до 2,000 символів, проте кожен вивід у межах цього ліміту, як і кожне подальше зчитування збереженого файлу, оплачується в повному обсязі.
• Уся історія розмови, що повторно надсилається на кожному кроці. Це питання заслуговує на окремий розділ.

Чому повторне надсилання коштує грошей

Claude API є stateless-сервісом. Він не зберігає сесію між запитами, як і будь-який інший подібний API. Тому на другому кроці клієнт надсилає історію першого кроку, відповідь на нього та нове повідомлення. На п'ятдесятому кроці клієнт повторно надсилає все, що залишилося в контексті з кроків від 1 до 49: кожен прочитаний файл, результат роботи інструментів та diff, які не були стиснуті, плюс сам п'ятдесятий крок. (Стиснення замінює стару історію на короткий підсумок, а результати читання файлів підпорядкованим агентом залишаються в його власному контексті, повертаючи лише фінальний результат). Модель щоразу перечитує всю збережену історію діалогу, і кожен із цих повторно прочитаних токенів оплачується як вхідні дані.

Наслідок: вартість одного кроку зростає приблизно лінійно залежно від довжини сесії, а загальна вартість сесії — приблизно квадратично. Повідомлення, яке на третьому кроці коштувало пів цента, на шістдесятому кроці може коштувати у двадцять разів більше за те саме однорядкове запитання, оскільки воно несе на собі «вантаж» із шістдесяти кроків. Це головний факт, який пояснює більшість запитів у підтримку на тему «чому мій рахунок такий високий». Це не особливість Claude, а принцип роботи: будь-який LLM-продукт, що виглядає як stateful, насправді є stateless API із циклом повторного надсилання даних усередині.

Результат: те, що ви бачите, і приховане обдумування

Токени результату є найдорожчими: у поточній лінійці вони коштують у 5 разів дорожче за вхідні токени ($10/$50 для Fable 5.1, $4/$20 для Opus 5.5, $2/$10 для Sonnet 5.5, $0.10/$0.50 для Haiku 5.5 для запитів обсягом до 100,000 токенів, станом на October 2026). До результату входять текст і код, які генерує Claude, а також токени обдумування: внутрішні міркування моделі перед відповіддю. Важливі два факти. Обдумування тарифікується за ставками для результату та враховується в max_tokens. Відповідь API, яка завершується з stop_reason: "max_tokens", і обрізана відповідь часто означають, що бюджет спочатку витрачено на обдумування. У поточних моделях підсумок міркувань може взагалі не відображатися. API типово не повертає його для Fable 5.1, Opus 5.5, Sonnet 5.5, Haiku 5.5 і попередніх моделей аж до Opus 4.7, але обдумування все одно відбулося та його все одно тарифікують. Невидиме не означає безкоштовне.

Claude Code типово вмикає розширене обдумування, оскільки воно помітно покращує виконання багатокрокових завдань, а типовий бюджет може сягати десятків тисяч токенів на запит. Для простіших завдань його можна зменшити: знизьте рівень зусиль за допомогою /effort або в /model чи вимкніть обдумування в /config на моделях, які це підтримують. Станом на October 2026 Claude Code не може вимкнути обдумування для Opus 5.5, Sonnet 5.5, Haiku 5.5 і моделей Fable, тому тут важелем є рівень зусиль. API дає більше можливостей для двох із них. Haiku 5.5 приймає thinking: {"type": "disabled"} за високого або нижчого рівня зусиль, як і старіша Opus 5, тоді як старіша Sonnet 5 приймає його на будь-якому рівні зусиль, зокрема xhigh і max. Sonnet 5.5 відхиляє "disabled" і натомість приймає thinking: {"type": "between_tools"}. Це вимикає початкове обдумування за низького, середнього або високого рівня зусиль, тому запит без інструментів отримує відповідь без попереднього обдумування. Лише Opus 5.5 і моделі Fable зберігають обдумування незалежно від того, що саме ви надсилаєте. Це реальний спосіб керувати витратами, а не забобон.

Кешування промптів змінює математику розрахунків

Кешування промптів — це причина, чому цикл повторних надсилань не призводить до фінансових втрат. API може кешувати стабільний префікс вашого промпту, системний промпт, визначення інструментів, історію розмови та під час наступного запиту обробити його за частку вартості. Станом на жовтень 2026 року діють такі множники: запис у кеш коштує 1.25× від базової ставки вводу (2× для варіанта з 1-годинним терміном дії), а читання з кешу коштує 0.1× для більшості моделей, 0.05× для Claude Opus 5.5 та Claude Sonnet 5.5, і 0.025× для Claude Fable 5.1. Запис є дорожчим; читання забезпечує знижку 90% для більшості моделей, 95% для Opus 5.5 та Sonnet 5.5, і 97.5% для Fable 5.1. (Ставку читання для Sonnet 5.5 було знижено з 0.1× до 0.05× 7 жовтня 2026 року.) Одне читання вже повністю компенсує 5-хвилинну премію за запис.

Claude Code керує кешуванням автоматично, і під час активної сесії майже весь обсяг повторних надсилань завантажується з кешу. Проте кеш анулюється після періоду бездіяльності. Станом на жовтень 2026 року Claude Code надає основній розмові одногодинний кеш у межах передплати згідно з лімітами вашого тарифного плану, та п'ятихвилинний кеш з моменту останнього використання при роботі через API key, хмарного провайдера або при використанні кредитів (налаштування promptCacheTtl може запитати годинний кеш у таких випадках за ставкою запису 2×). При п'ятихвилинному кеші, якщо ви відійдете на довгу каву, повернетеся і надішлете повідомлення, кеш буде анульовано, і весь накопичений префікс буде перезаписано за ставкою 1.25× замість читання за кешованою ставкою. У сесії на 150K токенів цей один «холодний» запит записує всі 150K токенів за ставкою 1.25×, тоді як «гарячий» запит прочитав би їх за 0.1× — це 12.5-кратна різниця для префікса (25-кратна для Opus 5.5 та Sonnet 5.5, 50-кратна для Fable 5.1). Це контрінтуїтивний результат, який варто засвоїти: ритм «бездіяльність — відновлення» може коштувати дорожче, ніж безперервна робота, оскільки кожна пауза, що перевищує TTL, перетворює ваш наступний запит з дешевого читання на дорогий перезапис. Працюйте інтенсивно; при п'ятихвилинному кеші не надсилайте повідомлення у великій сесії з інтервалом у десять хвилин.

Якщо ви викликаєте API з власного застосунку на VPS, нічого з цього не відбувається автоматично: ви активуєте функцію за допомогою cache_control, і типовою помилкою є додавання часової мітки або ID запиту в системний промпт, що змінює байти префікса в кожному запиті та непомітно вимикає кешування. Ознакою цього є значення usage.cache_read_input_tokens, що дорівнює нулю для запитів, які виглядають ідентичними.

Формула з прикладом розрахунку

Не зважайте на твердження про фіксовану вартість сесії. Вартість сесій може відрізнятися на два порядки. Єдине, що працює — це формула:

turn cost = (uncached input        x base input price)
          + (cache writes          x 1.25 x base input price)
          + (cache reads           x read multiplier x base input price)
          + (output incl. thinking x output price)

read multiplier = 0.10 on most models, 0.05 on Opus 5.5 and Sonnet 5.5, 0.025 on Fable 5.1
session cost = sum over all turns

Приклад розрахунку для Claude Opus 4.8, який зараз є застарілою моделлю, але все ще доступний. Станом на жовтень 2026 року ціна становить $5 за мільйон вхідних токенів та $25 за мільйон вихідних. Розглянемо середину сесії з накопиченим контекстом у 80,000 токенів: 75,000 зчитано з кешу, 3,000 записано в кеш, 2,000 нових вхідних токенів без кешування, 1,500 вихідних токенів, включно з процесом «мислення».

• Зчитування з кешу: 75,000 × $0.50/M = $0.0375
• Запис у кеш: 3,000 × $6.25/M = $0.019
• Вхідні дані без кешу: 2,000 × $5/M = $0.010
• Вихідні дані: 1,500 × $25/M = $0.0375

Це приблизно $0.10 за запит; п'ятдесят таких запитів коштуватимуть близько $5. Тепер розглянемо той самий запит після закінчення терміну дії кешу: 78,000 токенів, що підлягають кешуванню, перезаписуються за ціною $6.25/M, плюс ті самі 2,000 токенів без кешу за $5/M. Разом це близько $0.50 до виведення результату — приблизно в п'ять разів дорожче за «теплий» запит при ідентичній роботі. Ця різниця і є суттю кешування в одному числі. Для актуальної моделі Claude Opus 5.5 ($4/$20, зі зчитуванням з кешу за 0.05×) той самий «теплий» запит коштує близько $0.07 (зчитування $0.015, запис $0.015, вхідні без кешу $0.008, вихідні $0.030), а «холодний» варіант — $0.40 до виведення результату, що майже в шість разів дорожче за «теплий». Ці чотири рядки розрахунків — єдиний чесний спосіб порівняти постачальників, оскільки офіційні тарифи ігнорують зчитування з кешу та витрати на «мислення», а тестування на трьох реальних завданнях показує де рахунок Claude виявляється вищим або нижчим за OpenAI.

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

Перегляд власного використання

У Claude Code потрібна команда /usage (/cost також працює, це псевдонім). Блок Session угорі показує статистику токенів і локально обчислену оцінку вартості для поточного сеансу. На планах із підпискою той самий екран показує індикатори лімітів плану та розподіл, який пов’язує нещодавнє використання зі skills, subagents, plugins і окремими MCP servers. У нових версіях блок Session також містить рядок Prompt cache (main). Він показує частку вхідних даних, отриманих із кешу, промахи кешу та поточний стан кешу. Для достовірної інформації про тарифікацію облікових записів API джерелом даних є сторінка usage у Claude Console. Значення CLI є оцінкою. /context будує кольорову сітку вмісту вікна контексту: system prompt, tools, MCP definitions, files і history. Це найшвидший спосіб виявити надмірно великий CLAUDE.md або надто балакучий MCP server. У повноекранному режимі деталізація за окремими елементами згортається, а передавання all розгортає її.

В API кожна відповідь точно показує, що сталося:

response = client.messages.create(model="claude-sonnet-5-5", max_tokens=2048,
                                  messages=messages)
u = response.usage
total_prompt = u.input_tokens + u.cache_creation_input_tokens + u.cache_read_input_tokens
print(f"uncached={u.input_tokens} written={u.cache_creation_input_tokens} "
      f"read={u.cache_read_input_tokens} output={u.output_tokens}")

Зверніть увагу: input_tokens — це лише некешований залишок. Фактичний розмір prompt дорівнює сумі всіх трьох полів вхідних даних. Agent, який працював протягом години та показав input_tokens: 4000, не є дешевим: інші 200,000 токенів були отримані з кешу. Щоб оцінити обсяг до надсилання запиту, скористайтеся endpoint для підрахунку токенів. Виклик цього endpoint безкоштовний, він має власний rate limit і виконує підрахунок за tokenizer тієї моделі, яку ви вкажете. Сприймайте результат як приблизну оцінку: тарифікація залежить від фактичного запиту.

count = client.messages.count_tokens(model="claude-sonnet-5-5",
                                     messages=[{"role": "user", "content": big_file}])
print(count.input_tokens)

Ніколи не tiktoken з наведеної вище причини.

Плани підписки проти оплати за фактом використання

Механіка в цьому посібнику всюди однакова; різниця лише в порядку розрахунків. З API key Anthropic нараховує оплату за фактом використання (pay-as-you-go) за кожен токен згідно з опублікованими тарифами; кожне число вище — це реальні гроші. Лічильник починає працювати раніше, ніж очікує більшість користувачів, оскільки безкоштовного рівня не існує. Є лише невеликий кредит при реєстрації та кілька ендпоінтів, за які не стягується плата — це те, що отримує новий API-акаунт до прив'язки банківської картки. Винятком, починаючи з 7 жовтня 2026 року, є підписки Max або Team: ці плани тепер включають щомісячні API-кредити для ваших власних застосунків та агентів на Claude Platform: $100 на місяць для Max 5x та $200 для Max 20x, а для Team — $20 за Standard-місце та $100 за Premium-місце, з об'єднаним лімітом у $500. Ви отримуєте їх шляхом прив'язки організації в Console; невикористані кредити анулюються в кінці кожного розрахункового циклу, і вони не покривають інтерактивний Claude Code. У межах підписки Claude (Pro, Max, Team та застарілі плани Enterprise з оплатою за місце) використання Claude Code списується з ліміту вашого плану: станом на жовтень 2026 року це п'ятигодинне вікно сесії, що постійно оновлюється, плюс тижневе вікно, спільне для всіх моделей та чату claude.ai, а сума в /usage доларах має лише інформаційний характер, а не є рахунком до оплати. Станом на жовтень 2026 року є два винятки: поточні Enterprise-місця з оплатою за використання взагалі не мають включеного ліміту, тому кожен токен тарифікується за стандартними ставками API, а моделі Fable не входять у ліміт для Pro, стандартних місць Team або стандартних застарілих місць Enterprise, де вони працюють за рахунок кредитів pay-as-you-go. Якщо ви вичерпаєте вікно, ви побачите повідомлення "You've hit your session limit" або "You've hit your weekly limit" із зазначенням часу скидання ліміту, і перемикання моделей за допомогою /model не відновить доступ, оскільки вікна спільні для всіх моделей. Ці вікна прив'язані до акаунта, а не до клієнта, у якому ви працюєте, що варто знати, якщо ви все ще з'ясовуєте, що працює нативно на Linux і який план покриває кожну поверхню. Те, яке саме з двох вікон ви вичерпали, визначає тривалість очікування та доцільність подальших дій, тому варто знати ваші варіанти при досягненні ліміту під час виконання завдання. Плани можуть опціонально активувати кредити на використання, якими можна керувати через /usage-credits, щоб купувати доступ понад встановлений ліміт. Я свідомо не наводжу квоти планів: це найбільш мінливі цифри в цій темі, тому перевіряйте claude.com/pricing та власні індикатори /usage. Механіка токенів важлива і при підписці: неефективна сесія вичерпує ваше вікно так само, як вона вичерпувала б долари. Щодо підписки див. який план Claude відповідає вашому рівню використання.

Важелі, що реально працюють

• Обмежуйте обсяг даних, які зчитує агент. Запит «виправ помилку валідації в auth.py» зчитує один файл; «покращ цю кодову базу» — сорок. Тримайте CLAUDE.md компактним, оскільки він завантажується в кожну сесію, тому залишайте в ньому лише найважливіше, а інструкції для конкретних робочих процесів перенесіть у навички, що завантажуються за запитом.
• Чіткість і лаконічність. /clear між непов’язаними завданнями: застарілий контекст повторно надсилається — і оплачується — з кожним наступним повідомленням. У межах одного тривалого завдання /compact Focus on the failing tests and the diff узагальнює історію, що дозволяє уникнути квадратичного зростання витрат.
• Вибір моделі відповідного розміру. Sonnet підходить для більшості завдань програмування за ціною $2/$10 за мільйон токенів станом на жовтень 2026 року. Це стандартна ціна, а не вступна: Sonnet 5.5 коштує $2/$10, а Sonnet 5 зберіг ціну $2/$10 після скасування запланованого на 1 вересня підвищення до $3/$15. Для порівняння: Opus 5.5 коштує $4/$20, а Haiku 5.5 — $0.10/$0.50 (для промптів до 100 000 токенів, $0.50/$2.50 понад цей ліміт) є оптимальним інструментом для механічної роботи агентів, наприклад, для аналізу журналів. Fable 5.1 знаходиться на іншому ціновому рівні — $10/$50, що відповідає вартості Fable 5 і у два з половиною рази перевищує ціну Opus 5.5 за обома показниками. Тому варто знати, які завдання дійсно виправдовують таку вартість, перш ніж залишати цю модель обраною для рутинної роботи. /model дозволяє перемикатися посеред сесії.
• Попередня фільтрація об’ємних виводів. Хук, який за допомогою grep відфільтровує результати тестування, залишаючи лише помилки перед тим, як їх побачить Claude, перетворює 20 000 токенів результатів роботи інструментів на 300. Це економить токени при кожному наступному повторному надсиланні цього кроку.
• Пакетна обробка неінтерактивних завдань. Для власних API-конвеєрів, класифікації, масового перегляду та нічних завдань використовуйте Batches API. Він дозволяє запускати ті самі моделі зі знижкою 50% в обмін на асинхронну доставку результатів.
• Враховуйте час життя кешу. Працюйте безперервними сесіями. Від’єднана сесія Claude Code у tmux на VPS нічого не коштує в режимі очікування; токени витрачаються лише під час виконання кроку. Проте простій, що перевищує TTL кешу, призводить до втрати «теплого» кешу, і наступний крок вимагатиме повторного запису даних.

FAQ

Скільки токенів використовує сесія програмування в Claude Code?

Фіксованої кількості немає. Один запит у середині сесії зазвичай містить десятки тисяч токенів промпту, коли накопичуються файли та історія, а робоча сесія може сягати мільйонів. Більшість із них обслуговується з кешу за ціною, що становить десяту частину базового тарифу або менше, залежно від моделі. Для орієнтиру: опубліковані Anthropic корпоративні показники станом на жовтень 2026 року становлять у середньому близько $13 на розробника за активний день, причому 90% користувачів витрачають менше $30. Запустіть /usage у власній сесії; п'ять хвилин спостереження за цим показником дадуть краще розуміння, ніж будь-яка середня статистика.

Чи платні «thinking tokens», навіть якщо я їх не бачу?

Так. «Thinking tokens» тарифікуються як вихідні токени (за вищою ціною) і враховуються в max_tokens. Поточні моделі виставляють рахунок за них, навіть якщо інтерфейс приховує резюме міркувань від відображення. Якщо відповідь переривається з stop_reason: "max_tokens" до того, як завершиться видима частина, ймовірно, процес мислення вичерпав бюджет. У Claude Code зменште рівень зусиль за допомогою /effort для завдань, які не потребують глибоких міркувань.

Чому довга сесія Claude Code стає дорожчою з кожним повідомленням?

Тому що API є stateless: кожен запит повторно надсилає всю історію діалогу, що залишається в контексті, усі прочитані файли, результати роботи інструментів та попередні обміни даними, які не були стиснуті. Це тарифікується як вхідні дані, тому 50-й запит несе в собі «вантаж» з 1-го по 49-й. Prompt caching дозволяє обслуговувати повторюваний префікс за десяту частину базової ціни вхідних даних на більшості моделей (5% на Opus 5.5 та Sonnet 5.5, 2.5% на Fable 5.1), але сам префікс постійно зростає, а будь-яка пауза, що перевищує TTL кешу, перетворює наступний запит на повну оплату за перезапис. /compact скорочує історію; /clear скидає її.

Як перевірити використання токенів та витрати в Claude Code?

У Claude Code команда /usage відображає статистику токенів сесії, локальну оцінку вартості та індикатори лімітів підписки (/cost є псевдонімом); /context показує, що саме заповнює контекстне вікно. Для отримання офіційних даних про білінг API використовуйте сторінку використання в Claude Console. У власному коді зчитуйте response.usage: сума input_tokens, cache_creation_input_tokens та cache_read_input_tokens дає реальний розмір промпту. Оцінюйте витрати заздалегідь за допомогою ендпоінту count_tokens, ніколи не використовуйте для цього tiktoken.