HAM — Иерархическая память агента
kromahlusenii-ops/hamHAM — система памяти для AI-агентов на базе Claude Code. Заменяет один большой файл контекста набором небольших CLAUDE.md-файлов по директориям, снижая расход токенов до 80%, ускоряя ответы и уменьшая затраты на API.
Установка
git clone https://github.com/kromahlusenii-ops/ham.gitREADME
HAM — Hierarchical Agent Memory
Меньше токенов. Экологичный AI.
HAM — система памяти для AI-агентов, сокращающая потребление токенов до 80%. Вместо загрузки всего контекста проекта при каждом запросе HAM ограничивает память директорией, с которой вы реально работаете.
Меньше токенов. Быстрее агенты. Ниже затраты. Экологичнее AI.
Только Claude Code — HAM является скиллом для Claude Code и работает исключительно с Claude-агентами. Не совместим с Cursor, Copilot, Windsurf и другими AI-инструментами для написания кода.
Проблема
Каждый раз при старте сессии AI-агент перечитывает всё подряд: полную структуру проекта, соглашения, которые уже усвоил, решения, которые уже были приняты, контекст, не имеющий отношения к текущей задаче.
Один раздутый CLAUDE.md может занять 47% контекстного окна ещё до того, как агент напишет хоть строчку кода.
Это впустую потраченные токены, деньги и энергия.
Решение
HAM заменяет один огромный файл контекста небольшими, точечными файлами памяти на каждом уровне директорий. Агент читает только то, что нужно для директории, с которой работает.
project-root/
├── CLAUDE.md # Глобально: стек, соглашения (до 250 токенов)
├── src/
│ ├── CLAUDE.md # Общие паттерны src
│ ├── api/
│ │ └── CLAUDE.md # Авторизация API, rate limits, паттерны эндпоинтов
│ ├── components/
│ │ └── CLAUDE.md # Соглашения по компонентам, правила стилизации
│ └── db/
│ └── CLAUDE.md # Контекст схемы, паттерны запросов
└── .memory/
├── decisions.md # Архитектурные решения с обоснованием
└── patterns.md # Паттерны реализации
Агент читает 2–3 небольших файла вместо одного массивного дампа контекста. Стартовый контекст сокращается с тысяч токенов до сотен.
До и после
| До HAM | После HAM | |
|---|---|---|
| Контекст на запрос | 4 000 – 12 000 токенов | 800 – 2 400 токенов |
| Сессия из 50 запросов | 200K – 600K токенов | 40K – 120K токенов |
| Занято контекстного окна при старте | До 47% | Менее 10% |
| Сокращение токенов | — | До 80% |
Почему это важно
Для вашего бюджета
Меньше токенов — меньше счета за API. Команды, запускающие агентов в масштабе, замечают экономию сразу.
Для скорости
Меньший контекст — быстрее ответы. Агент тратит меньше времени на обработку нерелевантной информации и больше — на написание кода.
Для планеты
AI-инференс потребляет более 80% электроэнергии, расходуемой на AI. Каждый сгенерированный токен требует вычислений, энергии и охлаждения. Сокращение лишних токенов — это не только эффективность, но и осознанный выбор в пользу устойчивого развития.
По прогнозам, к 2030 году дата-центры будут потреблять 945 ТВт·ч электроэнергии — больше, чем вся Япония. Главным драйвером этого роста является AI. — Международное энергетическое агентство
HAM делает использование AI экологичнее, устраняя токены, которым не нужно было существовать.
Установка
git clone https://github.com/kromahlusenii-ops/ham.git ~/.claude/skills/ham
Это устанавливает HAM глобально — он будет доступен в каждом проекте, открытом в Claude Code.
Установка только для конкретного проекта
Если вы предпочитаете ограничить HAM одним проектом вместо глобальной установки:
cd your-project
mkdir -p .claude/skills
git clone https://github.com/kromahlusenii-ops/ham.git .claude/skills/hamСкиллы уровня проекта хранятся в .claude/skills/ и активны только в этом проекте.
Быстрый старт
Откройте Claude Code в директории проекта и напишите:
go ham
Всё. HAM автоматически определит ваш стек, просканирует структуру проекта и сгенерирует точечные файлы CLAUDE.md по всей кодовой базе. Ручная настройка не требуется.
После настройки напишите HAM savings, чтобы увидеть отчёт о сокращении токенов и затрат.
Обновление
cd ~/.claude/skills/ham && git pull
Как это работает
HAM следует трём принципам:
Точечность, а не дамп. Каждый фрагмент контекста хранится в наиболее специфичной директории, к которой относится. Глобальные соглашения — в корне. Паттерны API — в папке API. Правила компонентов — в папке компонентов.
Читать мало, читать по делу. Агент загружает корневой контекст и контекст целевой директории. Два-три небольших файла вместо всего проекта.
Самоподдерживающаяся память. Файлы решений и логи паттернов обновляются по мере работы агента. Корневой CLAUDE.md инструктирует агента читать перед написанием кода и записывать перед завершением — контекст остаётся актуальным без ручного обслуживания.
Команды
Настройка
| Команда | Что делает |
|---|---|
go ham | Настроить HAM в проекте (всё определяется автоматически) |
ham update | Обновить HAM до последней версии |
ham status | Показать версию HAM и статус настройки |
ham route | Добавить/обновить Context Routing в корневом CLAUDE.md |
Аналитика
| Команда | Что делает |
|---|---|
ham dashboard | Запустить веб-дашборд на localhost:7777 |
ham savings | Показать отчёт об экономии токенов и затрат |
ham carbon | Показать статистику по энергии и CO2e |
ham insights | Сгенерировать инсайты и записать actionable-пункты в inbox |
Бенчмаркинг
| Команда | Что делает |
|---|---|
ham benchmark | Сравнить производительность задач: baseline vs HAM |
ham baseline start | Начать захват baseline по 10 задачам (без загрузки памяти HAM) |
ham baseline stop | Досрочно завершить baseline, сохранив частичные данные |
ham metrics clear | Удалить все данные бенчмарков |
Обслуживание
| Команда | Что делает |
|---|---|
ham audit | Проверить состояние системы памяти |
ham commands | Показать все доступные команды |
Дашборд
Напишите HAM dashboard (или HAM sandwich), чтобы запустить интерактивный веб-дашборд на http://localhost:7777, визуализирующий реальные данные ваших сессий Claude Code.
Дашборд показывает:
- Экономию токенов — оценочное количество сэкономленных токенов и денег благодаря HAM, сравнивая сессии с HAM и без него
- Бенчмаркинг задач — сравнение производительности baseline vs HAM