К основному содержанию
скилл CX Codex

token-check — скилл для Claude Code: что делает и как установить

Оценивает размер текста, файла или всей беседы в токенах. Помогает понять расход контекста и урезать лишнее до отправки в модель.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a claude-code
Открыть на GitHub

Что делает token-check

Скилл даёт быструю оценку объёма данных в токенах по эвристикам символов. Для кода и JSON закладывается около 3 символов на токен, для английского текста — 4 символа, а для кириллицы расход заметно выше: от 1.5 до 3 символов на токен. Изображения берут около 1500 токенов, а PDF складывается из текста и страниц-картинок. Скилл сопоставляет полученный диапазон с контекстным окном модели (1M токенов для актуальных Opus, Sonnet и Haiku 5.5 или 200K для старых версий).

В чатах каждое раннее сообщение пересылается снова с каждым ответом. Документ на 20K токенов за 30 следующих сообщений сожжёт уже около 600K токенов. Точные цифры возвращает только счётчик API, поэтому скилл выдаёт приблизительный диапазон и сразу предлагает способы экономии: вырезать base64 и дубли логов, отправлять только нужную функцию или запускать аудит через /cco audit.

Какие задачи решает

  • прикинуть расход токенов на лог, код или вставленный текст
  • оценить влияние прикреплённого PDF на лимиты контекста
  • выяснить причину быстрого исчерпания лимитов в длинном диалоге
  • получить рекомендации по сокращению контекста перед отправкой

Примеры запросов агенту

  • Сколько токенов займёт этот файл логов и как его сократить?
  • Оцени размер текущей беседы в токенах
  • Почему я так быстро упираюсь в лимиты с этим документом?

Как установить token-check

1Через Skills CLI (Vercel)

npx skills add egorfedorov/claude-context-optimizer --skill token-check -a claude-code

2Вручную: положить файлы

~/.claude/skills/token-check/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/token-check/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о token-check

Как установить token-check в Claude Code?

Выполните команду npx skills add egorfedorov/claude-context-optimizer --skill token-check -a claude-code. Также файл скилла можно сохранить напрямую по пути ~/.claude/skills/token-check/SKILL.md.

Что делает скилл token-check?

Он рассчитывает приблизительное число токенов для файлов, фрагментов кода или текущей истории сообщений. Дополнительно скилл показывает долю от окна контекста и подсказывает шаги для уменьшения объёма.

Насколько точны расчёты токенов?

Это приблизительные оценки по символьным коэффициентам, а точный подсчёт даёт только токенизатор API. Для кириллицы расчёт закладывает 1.5–3 символа на токен, поэтому русский текст расходует лимиты быстрее английского.

Исходный текст

SKILL.md · MIT
---
name: token-check
description: Estimate how many tokens a pasted text, an attached file or the conversation so far takes, what it means for the context window and usage limits, and how to cut it. Use when the user asks how big something is in tokens, why they keep hitting limits, or whether a file is too large to send.
license: MIT
---

# Token check

Give a quick, honest estimate and the cheapest way to get the same result.
These are estimates; say so. Exact counts come from the API's token counter.

## Estimate

- English prose: about 4 characters per token, roughly 750 words per 1,000
  tokens. A full page of text is 500–700 tokens.
- Code, JSON, logs: about 3 characters per token.
- Cyrillic, CJK and other non-Latin scripts: about 1.5–3 characters per
  token, so the same text costs noticeably more than in English.
- Images: on the order of 1,500 tokens each at typical sizes. PDFs: the text,
  plus an image's worth for pages read as images.

Give a range (for example "about 18–24K tokens"), and compare it with the
context window: 1M tokens on current Opus, Sonnet and Haiku 5.5 models,
200K on older Haiku.

## Explain the real cost

In a conversation, everything already in it is re-sent with every new
message. A 20K-token document pasted early is paid for again on each of the
next 30 messages, about 600K tokens in total. That, not the first send, is
what uses up limits.

## Ways to cut it, cheapest first

1. Send only the part that matters: the section, the function, the failing
   lines of a log.
2. Strip what carries no meaning: minified code, base64, repeated log lines,
   boilerplate.
3. Summarize a long document once, then continue from the summary.
4. When a conversation is long, start fresh from a handoff (the `fresh-start`
   skill).
5. In Claude Code: read files with offset/limit, let the `context-optimizer`
   scout subagent do wide exploration on Haiku, and run `/cco audit` to see
   where a session's tokens actually went.

© egorfedorov · MIT · egorfedorov/claude-context-optimizer

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок ask-matt Matt Pocock Помогает выбрать подходящий скилл или рабочий поток из набора Matt Pocock. Пригодится, когда непонятно, с чего начать задачу: от идеи до разбора бага. 766 587установок to-tickets Matt Pocock Разбивает план, спецификацию или переписку на небольшие сквозные задачи и отмечает, какие из них блокируют остальные. Пригодится, когда нужно согласовать порядок работы до публикации задач в трекере. 711 230установок writing-plans Jesse Vincent Скилл превращает требования к многошаговой задаче в подробный план реализации до начала работы с кодом. Пригодится, когда исполнителю нужно зафиксировать файлы, интерфейсы и проверки. CX Codex 282 859установок caveman-review JuliusBrussee Пишет замечания к коду одной строкой: место, проблема, исправление. Пригодится, когда ревью диффа или PR надо пройти быстро и без воды. CX Codex +1 411 800установок caveman-compress JuliusBrussee Сжимает CLAUDE.md, списки задач и другие текстовые файлы в краткий формат, сохраняя читаемую резервную копию. CX Codex +1 411 500установок

Из того же набора6

sharpen-prompt Переписывает расплывчатые запросы в точные промпты с целью, контекстом и критериями готовности. Пригодится перед задачей для другого ассистента. CX Codex +1 ★ 124звёзд репо project-context Собирает то, что вы каждый раз объясняете заново, и превращает это в инструкции и файлы-справочники. Новые чаты стартуют с этим контекстом. CX Codex +1 ★ 124звёзд репо fresh-start Скилл собирает краткую выжимку диалога до 300 слов, чтобы перезапустить чат без потери важных решений и перерасхода токенов. CX Codex +1 ★ 124звёзд репо doc-digest doc-digest превращает длинные документы, PDF, таблицы и логи в краткую выжимку для дальнейшей работы с ИИ-агентом. Подходит для анализа материалов в нескольких сообщениях и переноса контекста в новый чат. CX Codex +1 ★ 124звёзд репо cco Показывает, сколько стоит текущая сессия и куда уходят токены, и даёт команды, чтобы тратить меньше. Полезен, когда счёт растёт, а причина непонятна. CX Codex +1 ★ 124звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой