Контекстное окно Claude: считаем токены

Контекстное окно Claude — это объём текста и служебных данных, который модель может учитывать в одной рабочей сессии. Чтобы не переплачивать, считай не только свой вопрос, но и инструкции, историю диалога, загруженные файлы и ответ Claude. Я, Арина Михална, покажу рабочую схему без магии и таблиц с цифрами, взятыми с потолка.

Что на самом деле входит в контекст Claude

Когда ты отправляешь Claude вопрос, модель получает не только последнюю строку. В рабочий контекст могут попасть:

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

Отсюда первая неприятная правда: короткая фраза «сделай заголовок» может стоить больше, чем кажется. Если перед ней лежит длинная переписка, десять файлов и несколько страниц правил, модель учитывает весь этот багаж.

Контекстное окно нужно отличать от трёх других вещей:

Что сравниваем	Что это означает	Почему легко перепутать
Контекстное окно	Сколько данных модель может учитывать в рабочем запросе	Кажется, что это просто лимит символов
Лимит сообщений	Сколько запросов доступно в конкретном тарифе или периоде	Большое окно не означает бесконечные сообщения
Токены API	Единицы, которыми считают вход и выход при оплате API	Токены влияют на счёт, но не описывают весь пользовательский лимит
История чата	Сохранённая переписка в интерфейсе	Вся история может не помещаться в текущий рабочий контекст

В API Anthropic отдельно считает входные и исходящие токены. Ответ модели обычно дороже входного текста, поэтому длинная генерация может стоить заметнее, чем большой, но хорошо подготовленный запрос.

Если работаешь через интерфейс Claude, не своди всё к цене API. Подписка и API — разные способы доступа с разными правилами и ограничениями. Для подписки Claude Pro Anthropic указывает цену около 20 долларов в месяц, но это не означает, что любой объём работы можно безлимитно переложить на одно окно.

Как посчитать токены Claude без гадания

Запомни простую формулу:

общий расход запроса = входные токены + исходящие токены.

Для оценки одной задачи разложи её на четыре части:

1. постоянные инструкции;
2. история диалога;
3. новые файлы и текст запроса;
4. ответ Claude.

Например, ты просишь отредактировать договор. В запрос попадают:

• правила тона;
• сам договор;
• список спорных мест;
• предыдущие правки;
• твоя команда;
• ответ с новой версией.

Если каждый раз отправлять весь договор и всю историю, расход растёт. Если оставить в чате только актуальное резюме, а сам документ подключать один раз или частями, окно используется аккуратнее.

По нашим замерам, запрос статьи с контекстом около 60 000 знаков был тяжёлым для нескольких моделей: Claude Sonnet 5 и Sonnet 4.6 через шлюз завершились ошибкой 504 после 240 секунд. Это не универсальная граница контекстного окна и не тарифная цифра. Это пример того, почему большой объём текста нельзя автоматически считать «нормальным для любой задачи».

Токены не равны словам и не равны символам. Русский текст, код, таблица, JSON и повторяющиеся конструкции разбиваются по-разному. Поэтому оценка «у меня 10 000 слов, значит будет ровно столько-то токенов» не работает.

Для точного расчёта в API смотри статистику запроса и ответа. Для обычного чата используй приблизительную оценку, а затем сокращай самые тяжёлые части: старую историю, повторяющиеся инструкции и файлы, которые Claude не использует.

Размер контекста Claude: что загружать в проект

С проектом из 50 и более файлов проблема обычно не в самом количестве файлов. Проблема в том, что человек просит Claude «посмотреть всё», хотя для текущей задачи нужны три файла.

Для многофайловой работы раздели материалы на уровни.

Первый уровень — карта проекта. Это короткий файл с назначением папок, точками входа и правилами. В Claude Code для таких инструкций используют CLAUDE.md, обычный Markdown-файл без специальной JSON-схемы. Документация Claude Code указывает, что этот файл читается при запуске новой сессии.

Второй уровень — текущая задача. Сюда входят только файлы, которые прямо связаны с изменением. Для исправления формы оплаты это может быть компонент формы, обработчик и тест. Вся папка src сразу не нужна.

Третий уровень — справочные материалы. Их держи рядом, но подключай только когда возник вопрос. Документацию, старые решения и большие логи не надо отправлять в каждый запрос.

Так контекст становится рабочей памятью, а не складом. Для ориентира:

Сценарий	Что отправлять	Что не отправлять
Исправить одну ошибку	сообщение об ошибке, файл, тест	весь репозиторий
Добавить функцию	карта проекта, связанные модули, требования	старые версии файлов
Сделать ревью	изменённые файлы и критерии проверки	архив проекта целиком
Разобраться в архитектуре	карта папок и несколько точек входа	все логи и зависимости

Ссылка на настройку проекта Claude Code пригодится, если хочешь закрепить эту логику не только в чате. А про сам файл с правилами я отдельно писала в материале о CLAUDE.md и памяти проекта.

Как не потерять смысл после компактирования

Когда диалог становится слишком большим, интерфейс или инструмент может сжать старую часть истории. Это удобно: работа продолжается. Но компактирование не обязано сохранить каждую формулировку, пример и промежуточное решение.

Перед длинной задачей держи короткий файл или сообщение с пятью пунктами:

• цель проекта;
• что уже сделано;
• какие решения приняты;
• что нельзя менять;
• следующий конкретный шаг.

После компактирования попроси Claude сначала пересказать этот список и назвать открытые вопросы. Не отправляй сразу новый огромный пакет файлов. Сначала убедись, что модель правильно восстановила состояние.

В Claude Code часть постоянных правил лучше вынести в CLAUDE.md, а повторяемые рабочие процессы оформить через скиллы Claude. Тогда тебе не придётся каждый раз вручную вставлять один и тот же инструктаж.

Что меняется в API, чате и Claude Code

Одна и та же задача по-разному выглядит в трёх режимах.

Веб-интерфейс. Ты обычно думаешь сообщениями и файлами. Точную стоимость каждого токена не видишь так же явно, как в API. Здесь особенно важно не раздувать историю и не держать в одном чате пять разных задач.

API. Ты управляешь запросом сам: передаёшь инструкции, историю, документы и параметры. Anthropic отдельно учитывает входные и исходящие токены, поэтому можно анализировать расход и менять архитектуру запроса.

Claude Code. В контекст добавляются файлы проекта, вывод команд, правила, результаты инструментов и ответы агента. Поэтому агентная задача может съесть больше контекста, чем обычный вопрос, даже если твоя команда состоит из одной строки.

Это не значит, что Claude Code нужно избегать. Просто ему нужна карта проекта и ограничения. Документация описывает Claude Code как CLI-инструмент, который может применять изменения, запускать тесты и работать с проектом. Каждое такое действие добавляет в историю новые данные.

Перед запуском задачи реши, какой режим тебе нужен:

• один ответ по документу — чат;
• повторяемая автоматизация — API;
• работа с файлами, тестами и командами — Claude Code.

Если в проекте много независимых задач, не смешивай их в одну длинную сессию. Новая сессия с коротким резюме часто полезнее, чем бесконечное продолжение старой.

Ты работаешь с проектом {{название проекта}}.
Цель текущей задачи: {{одна измеримая задача}}.
Используй только эти файлы: {{список файлов}}.
Не меняй публичные интерфейсы и не трогай другие части
проекта.
Сначала дай короткий план из трёх шагов, затем внеси
изменения и перечисли изменённые файлы.
Если данных не хватает, задай вопрос, не загружай весь
проект автоматически.

По опыту Арины Михалны, такой короткий бриф полезнее длинного манифеста на несколько экранов. Правила должны снимать неопределённость, а не превращаться в ещё один роман, который модель читает перед каждой задачей.

Как экономить контекст на практике

Держи рабочий алгоритм:

1. Сформулируй один результат: «найти причину ошибки» или «добавить тест».
2. Назови файлы, которые можно менять.
3. Попроси сначала прочитать карту проекта и только связанные места.
4. Не вставляй повторно правила, которые уже лежат в CLAUDE.md.
5. После результата сохрани короткое резюме решения.
6. Для новой самостоятельной задачи начни новую сессию.

Что обычно раздувает окно:

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

Что помогает:

• карта проекта на одну страницу;
• отдельные файлы для правил и фактов;
• точечное чтение файлов;
• короткие итоговые записи;
• явный список запретов;
• проверка результата после каждого крупного изменения.

Перед FAQ оставлю главное в одной фразе: контекст не надо заполнять до отказа. Его задача не вместить весь твой цифровой архив, а дать Claude ровно те данные, которые нужны для следующего решения.

По материалам: официальная страница цен Anthropic и документация Claude Code. Собственные наблюдения о тяжёлом запросе с контекстом около 60 000 знаков помечены как наши замеры.