token-check — скилл для Claude Code: что делает и как установить
Оценивает размер текста, файла или всей беседы в токенах. Помогает понять расход контекста и урезать лишнее до отправки в модель.
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/token-check/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/token-check/
1Через Skills CLI (Vercel)
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a codex2Вручную: положить файлы
.agents/skills/token-check/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a cursor2Вручную: положить файлы
.cursor/skills/token-check/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install egorfedorov/claude-context-optimizer token-check2Вручную: положить файлы
.github/skills/token-check/SKILL.md1Через Skills CLI (Vercel)
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a gemini-cli2Командой платформы
gemini skills install https://github.com/egorfedorov/claude-context-optimizer --path skills/token-checkВручную: положить файлы
.devin/skills/token-check/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add egorfedorov/claude-context-optimizer --skill token-check -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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