К основному содержанию
плагин

tokendoctor — плагин для Claude Code: что делает и как установить

Плагин tokendoctor для Claude Code переигрывает прошлые сессии и рассчитывает экономию токенов при разных окнах сжатия. Инструмент оптимизирует расходы на контекст без сторонних вызовов API.

MIT ★ 171 обновлён 2026-11-17

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add localixai/tokendoctor
/plugin install tokendoctor@tokendoctor
Открыть на GitHub

Что делает tokendoctor

Плагин симулирует завершённые диалоги за последние 30 дней с окнами контекста на 200K, 300K, 400K и 600K токенов. Он читает только локальные логи, не делает запросов к нейросетям и показывает, сколько токенов сэкономила бы ранняя компактизация. Команда /tokendoctor:optimize предлагает до пяти точечных правок конфигурации и применяет только выбранные через показ diff.

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

Данные не уходят с компьютера: единственный сетевой запрос отправляется раз в день к двум публичным страницам документации. Модели плагин сам не переключает, а любую правку можно откатить через /tokendoctor undo.

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

  • рассчитать расходы на контекст при окнах от 200K до 600K токенов
  • сократить паузы на суммаризацию за счёт удаления старого вывода утилит
  • проверить конфигурацию CLAUDE.md и параметры памяти по документации
  • откатить внесённые изменения настроек с помощью команды undo

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

  • /tokendoctor:sessions 30
  • /tokendoctor:optimize
  • /tokendoctor:audit

Как установить tokendoctor

Через маркетплейс плагинов

/plugin marketplace add localixai/tokendoctor
/plugin install tokendoctor@tokendoctor

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

Вопросы о tokendoctor

Как установить tokendoctor в Claude Code?

Выполните по очереди команды /plugin marketplace add localixai/tokendoctor и /plugin install tokendoctor@tokendoctor. После установки перезапустите Claude Code.

Что делает tokendoctor?

Плагин анализирует локальные логи диалогов, моделирует их стоимость при разных размерах окна контекста и помогает настроить параметры экономии токенов.

Отправляет ли tokendoctor данные сессий на внешние серверы?

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

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

SKILL.md · MIT
<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/logo.svg">
    <img src="docs/logo-light.svg" width="72" height="72" alt="tokendoctor">
  </picture>
</p>

<h1 align="center">tokendoctor</h1>

<p align="center">
  <strong>The same Claude Code for up to 38% less</strong>
  <br>
  Replays your own past sessions to show what each change would have saved, then changes only what you pick.
</p>

<p align="center">
  <a href="https://github.com/localixai/tokendoctor/actions/workflows/ci.yml"><img src="https://github.com/localixai/tokendoctor/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
  <a href="CHANGELOG.md"><img src="https://img.shields.io/github/v/tag/localixai/tokendoctor?label=version" alt="Version"></a>
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License: MIT"></a>
</p>

<p align="center">
  <a href="#install">Install</a> &bull;
  <a href="https://tokendoctor.localix.ai/docs">Docs</a> &bull;
  <a href="https://tokendoctor.localix.ai">Website</a> &bull;
  <a href="CHANGELOG.md">Changelog</a>
</p>

<p align="center">
  <img src="docs/demo.gif" alt="tokendoctor in a real Claude Code session: /tokendoctor:sessions, then the daily trend" width="880">
</p>

**Your past sessions decide, not anyone's benchmark.** What a setting saves depends on how you
work: how long your sessions run, which models you use, what the work is. A number from someone
else's sessions, mine included, says little about yours. So tokendoctor starts by looking back at
your own.

**① Look back at your last 30 days.** `/tokendoctor:sessions` replays every session you had,
request by request, at compaction windows of 200K, 300K, 400K and 600K, and shows what each would
have cost. It only reads your transcripts, makes no model calls and changes nothing. The figure is
an upper bound: a replay can't see work the model would have redone after a summary.

**② Change only what your sessions show pays, and undo it.** `/tokendoctor:optimize` proposes
changes from those numbers and checks your settings against Claude Code's docs; it applies only the
ones you pick, each shown as a diff first. `/tokendoctor undo` puts any of them back.

**③ Optional: slide instead of summarize.** When Claude Code would stop to summarize the
conversation, tokendoctor drops old tool output instead and keeps every message. There is no model
call, so it takes milliseconds, not a minute.

## Install

```bash
claude plugin marketplace add localixai/tokendoctor
claude plugin install tokendoctor@tokendoctor
```

Restart Claude Code and run `/tokendoctor:sessions` to see what your last 30 days would have cost
at each window. Nothing changes until you pick it.

## What it found in mine

Every request sends the whole conversation to the model. On models with a 1M window, Claude Code
compacts only near 967K tokens, so the end of a long session is the expensive part. For me, two
thirds of main-thread cost went to requests with more than 400K in context.

So I set a 400K window and Sonnet for subagents. Comparing the month before with the week after,
about 23K and 19K main-thread requests, context per request went from 412K to 219K and cost per
request fell 38% at API list prices. That's one person's before and after, not a controlled
experiment.

The catch is more summaries, and each is a pause: 79 seconds on average in my sessions. That's
what the slide is for. Your sessions may show something else entirely, which is the point of
looking at them first.

## What the benchmark shows

On the [benchmark](bench/README.md), Claude Code builds a TypeScript project against tests it
can't change, so a run counts only if the tests pass. Cost is per task, on Haiku 5.5:

| Compared | Cost | Time |
| --- | --- | --- |
| Slide against a summary, a day of work | −19% | −33% |
| Slide against a summary, an eval harness | −35% | −28% |
| Slide against a summary, a short task | +6% | −17% |
| The settings advice alone, against Claude Code as it ships | dearer in 3 of 4 runs | |
| The advice and the slide, a week of work | −11% to −21% | |

Every test passed in every run. The advice alone didn't pay here because these tasks rarely pass
400K, which is where the window starts to matter. If your sessions don't either, your replay will
show it, and you should leave your window alone. Every run, the losing ones too, is in
[bench/HISTORY.md](bench/HISTORY.md).

<p align="center">
  <img src="docs/dashboard.png" alt="The author's tokendoctor dashboard: 57% of the spend was Claude re-reading the conversation" width="880"><br>
  <sub><code>/tokendoctor:dashboard</code>: where every token went, by day, model, subagent and project. One local file; this one is mine.</sub>
</p>

## Commands

| Command | What it does |
| --- | --- |
| `/tokendoctor:sessions [days]` | Replays your past sessions (30 days, or `days`) at smaller windows: what each would have saved, then where your tokens went. Reads only. |
| `/tokendoctor:audit` | Your settings, memory and CLAUDE.md checked against the docs, by severity. Reads only. |
| `/tokendoctor:dashboard [days]` | Opens a local dashboard of every session on this machine. |
| `/tokendoctor:optimize [focus]` | Proposes up to five changes from your numbers and applies the ones you pick. |
| `/tokendoctor [name] [value]` | Shows, explains or changes a setting, with no model call. |
| `/tokendoctor undo [n]` | Lists every change tokendoctor made and puts one back. |

Nothing leaves your machine: the only network call is to two public pages of Claude Code's docs,
once a day. It never switches your models on its own.

## Documentation

**[tokendoctor.localix.ai/docs](https://tokendoctor.localix.ai/docs)** has the rest: the
[38 checks](https://tokendoctor.localix.ai/docs/audit), every
[setting](https://tokendoctor.localix.ai/docs/settings),
[how the slide works](https://tokendoctor.localix.ai/docs/slide) (and Team and Enterprise
logins), the commands from a shell, the [measurements](https://tokendoctor.localix.ai/docs/proof)
and the [limits](https://tokendoctor.localix.ai/docs/limits). To work on tokendoctor itself, see
[CONTRIBUTING.md](CONTRIBUTING.md).

## License

MIT

© rsaryev · MIT · localixai/tokendoctor

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
session-tax CraniusMaximus LLC Плагин session-tax замеряет стартовый вес контекста в Claude Code до первого введённого слова. Он показывает, сколько токенов сжигают забытые скиллы, серверы и хуки. ★ 1 013звёзд репо scaffold-cost-check haabe Скилл scaffold-cost-check для Claude Code, который замеряет стоимость скаффолда фреймворка Mycelium в токенах. Запускается как разовый аудит и показывает, сколько контекста съедают CLAUDE.md, движок, harness, canvas и память. CX Codex +1 ★ 54звёзд репо model-hierarchy zscole Скилл model-hierarchy распределяет задачи ИИ-агентов по трёх ценовым уровням моделей в зависимости от сложности, снижая расходы на токены. CX Codex +1 ★ 346звёзд репо token-economist Son Nguyen Субагент token-economist анализирует расходы токенов и кэш в Claude Code через дашборд Agent Monitor, переводя метрики сессий в понятные расчёты экономии в долларах. CX Codex ★ 1 198звёзд репо get-token-insights Samarth Gupta Скилл get-token-insights разбирает историю сессий Claude Code, находит перерасход токенов и строит интерактивный отчёт по расходам, хукам и вызовам агентов. CX Codex +1 ★ 276звёзд репо llm-cost-optimizer Alireza Rezvani Скилл llm-cost-optimizer находит утечки токенов и помогает снизить расходы на LLM API без потери качества ответов. Пригодится при росте счетов за модели или перед запуском новых ИИ-эндпоинтов. CX Codex +1 73установок

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

dashboard Скилл dashboard для Claude Code собирает локальную статистику расхода токенов из транскриптов на компьютере. Отчёт открывается прямо в браузере за выбранный период дней. CX Codex +1 ★ 171звёзд репо apply Скилл apply для Claude Code применяет исправление из аудита tokendoctor после показа изменений. Команда переезжает в /tokendoctor fix <id> и не требует вызова модели. CX Codex +1 ★ 171звёзд репо sessions Скилл sessions для Claude Code анализирует локальные логи сессий и показывает распределение расхода токенов и затрат. Отчёт формируется за выбранное количество дней. CX Codex +1 ★ 171звёзд репо audit Скилл audit для Claude Code проверяет настройки проекта на параметры, которые расходуют токены или не работают. Он также разбирает инструкции и показывает отчёт по использованию токенов. CX Codex +1 ★ 171звёзд репо optimize Скилл optimize для Claude Code анализирует расход токенов и предлагает безопасные правки настроек для снижения затрат контекста. Запускается при оптимизации расхода токенов в сессиях. CX Codex +1 ★ 171звёзд репо

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

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