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

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

Плагин context-hogs считает расход токенов по файлам проекта и показывает отчёт с самыми затратными местами.

MIT ★ 586 обновлён 2026-10-26

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add karanb192/claude-code-hooks
/plugin install context-hogs@claude-code-hooks
Открыть на GitHub

Что делает 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

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

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
session-tax CraniusMaximus LLC Плагин session-tax замеряет стартовый вес контекста в Claude Code до первого введённого слова. Он показывает, сколько токенов сжигают забытые скиллы, серверы и хуки. ★ 1 013звёзд репо context-optimizer Rohit Ghumare Скилл context-optimizer оптимизирует расход токенов и очищает контекст в сессиях Claude Code. Помогает, когда агент начинает тормозить или исчерпывается бюджет. CX Codex +1 ★ 2 966звёзд репо context-optimization muratcankoylan Скилл context-optimization расширяет полезную ёмкость окна контекста через маскировку вывода инструментов, переиспользование KV-кеша, сжатие и разбиение задач между субагентами. CX Codex +1 532установок context-compressor oimiragieo Скилл context-compressor сжимает большие текстовые файлы, истории чатов и RAG-загрузки перед отправкой модели, сохраняя доказательства для правильного ответа. Помогает, когда контекст раздут, а платёж щипает. CX Codex +1 274установок context-guardian Ricky-Stevens Плагин context-guardian следит за заполнением контекста в Claude Code и сжимает его, когда порог пройден. Сохраняет решения, команды и диффы; удаляет повторяемые файлы и системный шум. ★ 5звёзд репо ai-context-kit ofershap MCP-сервер ai-context-kit анализирует файлы контекста вроде CLAUDE.md и правил Cursor, подсчитывает токены и находит конфликтующие инструкции в проекте. CX Codex +1 ★ 8звёзд репо

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

Весь набор →
protect-secrets Плагин protect-secrets для Claude Code проверяет вызовы Read, Edit, Write, Bash и Grep и блокирует доступ к секретам или сначала запрашивает разрешение. ★ 586звёзд репо bounty-board Плагин bounty-board превращает TODO и FIXME в вашем коде в растущие по возрасту XP-бонусы. Плагин сканирует репозиторий, оценивает долг в очки и подсказывает три самых прибыльных задачи прямо в сессии. ★ 586звёзд репо dead-end-registry Плагин dead-end-registry сохраняет отменённые решения и предупреждает, если вы или модель снова пытаетесь пойти по тупиковому пути. Помогает не тратить токены на повторные ошибки. ★ 586звёзд репо standup-autopilot Плагин standup-autopilot собирает задачи, тесты, PR и блокеры из транскриптов сессий и оформляет сводку для дейли. Открытые блокеры возвращаются в следующую сессию. ★ 586звёзд репо pr-provenance-stamp Плагин pr-provenance-stamp дописывает в тело пулл-реквеста квитанцию: число промптов, оценку расхода, коды возврата тестов и долю строк, написанных агентом. ★ 586звёзд репо dead-rules-audit Плагин dead-rules-audit аудирует соблюдение правил из CLAUDE.md во время сессии Claude Code и отмечает правила, которые агент постоянно игнорирует. ★ 586звёзд репо nerf-receipts Плагин nerf-receipts считает сбои инструментов, повторные правки одного файла и токены на задачу. Помогает увидеть, меняются ли эти показатели вместе со сменой модели. ★ 586звёзд репо cache-tax Плагин cache-tax показывает, во сколько обойдётся возврат в сессию после того, как часовой кеш промпта остыл, — до того, как вы нажмёте Enter. ★ 586звёзд репо

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

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