context-hogs — плагин для Claude Code: что делает и как установить
Плагин context-hogs считает расход токенов по файлам проекта и показывает отчёт с самыми затратными местами.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install context-hogs@claude-code-hooksЧто делает context-hogs
Плагин следит за вызовами инструментов Read, Grep, Glob и Bash. Асинхронный хук PostToolUse замеряет байты в результатах, связывает их с путями к файлам и записывает строки в локальный журнал. При завершении сессии SessionEnd плагин формирует сводную таблицу расходов и предлагает блок исключений для файла CLAUDE.md. Токены оцениваются из расчёта 4 байта на токен, поскольку хуки не получают точные счётчики от API.
Журнал сохраняется локально в файле ~/.claude/context-hogs/<repo-key>/ledger.jsonl. Плагин не выполняет сетевых запросов и ограничивается модулями fs, path и os. Поведение настраивается через переменные окружения: можно поменять лимит строк журнала через CONTEXT_HOGS_LEDGER_CAP, количество строк в таблице через CONTEXT_HOGS_TOP_N и тариф на миллион токенов через CONTEXT_HOGS_USD_PER_MTOK.
Какие задачи решает
- найти самые тяжёлые файлы, раздувающие контекст агента
- оценить примерную стоимость обращений к кодовой базе в долларах
- сформировать правила игнорирования файлов для
CLAUDE.md
Примеры запросов агенту
- /context-hogs:leaderboard
- Покажи, какие файлы израсходовали больше всего токенов за сессию
- Сгенерируй список исключений для CLAUDE.md на основе расхода контекста
Как установить context-hogs
Через маркетплейс плагинов
/plugin marketplace add karanb192/claude-code-hooks/plugin install context-hogs@claude-code-hooksПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о context-hogs
Как установить context-hogs в Claude Code?
Выполните по очереди команды /plugin marketplace add karanb192/claude-code-hooks и /plugin install context-hogs@claude-code-hooks, после чего перезапустите Claude Code.
Что делает context-hogs?
Он отслеживает результаты чтения файлов и выполнения команд, привязывает байты к путям в проекте и строит таблицу файлов с наибольшим расходом контекста.
Откуда берутся данные о стоимости и токенах?
Плагин оценивает токены по формуле 4 байта на токен, а итоговую сумму считает по ставке из переменной CONTEXT_HOGS_USD_PER_MTOK (по умолчанию 3.0 доллара за миллион входных токенов).
Исходный текст
context-hogs · MIT
# context-hogs > Per-file context-cost leaderboard: attributes every tool result's tokens to the files it loaded, so you know which files cost you the most. A `PostToolUse` hook fires after every `Read`, `Grep`, `Glob`, and `Bash` call, measures the tool result's bytes, resolves the file path(s) that result belongs to, and appends a ledger row. Tokens are estimated from bytes (~4 bytes/token) and dollars from a configurable input-token rate (hooks don't receive real token counts, so nothing is fabricated). At `SessionEnd`, or on demand via the skill, it aggregates the ledger into your repo's most token-expensive files (read count, cumulative tokens, estimated cost, plus repeat-offender flags for lockfiles, generated code, and giant utils) and renders that leaderboard. ## Install ``` /plugin marketplace add karanb192/claude-code-hooks # once per machine /plugin install context-hogs@claude-code-hooks ``` Restart Claude Code, done. (Or from a shell: `claude plugin install context-hogs@claude-code-hooks`.) ## What it does | Event | Runs | What happens | |-------|------|--------------| | PostToolUse (`Read\|Grep\|Glob\|Bash`) | async (zero added latency) | Measures the tool result's bytes, resolves the file path(s) it belongs to, appends a ledger row. | | SessionEnd | sync | Aggregates the whole ledger, renders the leaderboard card via `systemMessage`, and writes a suggested CLAUDE.md ignore block for the top offenders. | `/context-hogs:leaderboard` renders this repo's context-cost leaderboard on demand. ## Configuration All optional, set via environment variables: | Variable | Default | Purpose | |----------|---------|---------| | `CONTEXT_HOGS_BYTES_PER_TOKEN` | `4` | Bytes-per-token ratio used to estimate tokens. | | `CONTEXT_HOGS_USD_PER_MTOK` | `3.0` | Input $/1M tokens used to estimate cost. Set to your model's current input rate. | | `CONTEXT_HOGS_TOP_N` | `10` | Number of files shown on the leaderboard. | | `CONTEXT_HOGS_LEDGER_CAP` | `50000` | Max ledger rows kept; older rows are compacted at SessionEnd. | State is stored under `~/.claude/context-hogs/<repo-key>/ledger.jsonl`. ## Data & privacy Records file paths, read counts, and byte/token estimates per repo. It makes no network calls (the script only uses `fs`, `path`, and `os`), so everything stays on your local machine. ## Uninstall ``` /plugin uninstall context-hogs@claude-code-hooks ```
© Karan Bansal · MIT · karanb192/claude-code-hooks