Як не витрачати зайві токени в Claude Code: уважно до `disable_prompt_caching`

Інструменти на кшталт Claude Code відкривають зручні можливості для роботи з кодом за допомогою ШІ, але разом із цим з’являється й новий тип витрат — токени. У короткому гіді від каналу KODARIK розбирають один із малопомітних, але критично важливих параметрів, який може непомітно збільшувати вартість роботи з Claude Code.

Що таке кешування промптів і чому воно важливе

Claude Code, як і інші AI-інструменти, працює з текстовими запитами (промптами), які перетворюються на токени. Чим більше токенів — тим вища вартість обробки. Щоб не рахувати одне й те саме щоразу, система може кешувати промпти: повторні звернення з однаковим вмістом частково або повністю використовують уже збережений результат, а не генеруються «з нуля».

Кешування промптів дає два ключові ефекти:

• Зменшення витрат токенів — повторні запити обходяться дешевше.
• Прискорення відповіді — система не виконує повний цикл обробки кожного разу.

Відключення кешу, відповідно, робить кожен запит «новим» для моделі — навіть якщо ви фактично повторюєте попередній сценарій.

Глобальна змінна disable_prompt_caching: маленький прапорець, велика проблема

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

• disable_prompt_caching = 1 — кешування вимкнено.
• disable_prompt_caching = 0 або відсутність змінної — кешування увімкнено (поведінка за замовчуванням).

Ключовий ризик полягає в тому, що ця змінна може залишитися в коді випадково:

• хтось із команди міг тимчасово вимкнути кешування для тестів;
• змінну додали для експериментів, але потім забули прибрати;
• нові розробники просто не звернули уваги на її наявність.

У результаті проєкт працює без кешу, а команда систематично витрачає більше токенів, ніж потрібно, навіть не підозрюючи про це.

Як перевірити налаштування і що робити

Щоб уникнути зайвих витрат, варто включити перевірку disable_prompt_caching у стандартний чекліст налаштувань проєкту.

Рекомендований підхід:

1. Переглянути конфігурацію проєкту
   Переконатися, що глобальна змінна disable_prompt_caching:
2. або взагалі відсутня,

3. або явно має значення 0.

4. Прибрати зайві перевизначення
   Якщо змінна встановлена в 1 і немає поточної потреби в тестуванні без кешу, її варто:

5. або видалити,

6. або змінити значення на 0.

7. Зафіксувати правило в документації
   Описати в командних гайдах, у яких випадках кешування можна тимчасово вимикати, і наголосити на обов’язковому поверненні до стандартних налаштувань після завершення тестів.

8. Періодично робити рев’ю налаштувань
   Особливо актуально для довготривалих проєктів, де конфігурація змінюється багатьма людьми.

Чому це критично для економії

Вимкнене кешування саме по собі не ламає функціональність — система продовжує працювати. Проблема в тому, що наслідки проявляються не одразу, а у вигляді поступового зростання витрат:

• кожен повторний промпт повністю оплачується токенами;
• при активній розробці або великій команді це множиться на сотні й тисячі звернень;
• фінальний рахунок за використання моделі виявляється значно вищим, ніж міг би бути.

Тому контроль за disable_prompt_caching — це не дрібна технічна деталь, а базовий елемент економії в роботі з Claude Code.

Source

https://www.youtube.com/watch?v=auML3UP50sg