Memory Bank в Cline: как настроить память проекта для агента

Cline не помнит прошлые разговоры: каждая новая задача начинается с чистого листа. Cline Memory Bank решает это не магией, а дисциплиной: проект хранит несколько markdown-файлов, а агент по правилу читает их перед работой и обновляет после. У подхода есть цена в токенах, и её легко недооценить. Разберём, как настроить память, чтобы она помогала и не разоряла.

Что такое Memory Bank

По документации Cline, Memory Bank — это методология документирования, которая превращает ассистента без памяти в партнёра с постоянным контекстом. Технически это обычные файлы в папке проекта, доступные и вам, и агенту. Стандартная структура:

memory-bank/
├── projectbrief.md      # основа: цели и требования
├── productContext.md    # зачем проект, какие проблемы решает
├── activeContext.md     # текущий фокус, недавние изменения, следующие шаги
├── systemPatterns.md    # архитектура и паттерны
├── techContext.md       # стек, окружение, ограничения
└── progress.md          # что готово, что осталось, известные проблемы

Файлы выстроены иерархией: projectbrief.md лежит в основе, от него зависят три файла контекста, а те питают activeContext.md и progress.md. Чаще всего меняется activeContext.md: его обновляют после каждой сессии.

Это не функция, встроенная в программу. Memory Bank работает за счёт инструкций: вы кладёте правило, которое говорит агенту читать эти файлы и поддерживать их актуальными. Поэтому подход работает и в других инструментах; команды и интеграция могут отличаться.

Cline Memory Bank: настройка за пять минут

Пошагово, по документации:

1. Создайте файл правил, например .clinerules/memory-bank.md (допустим и .cline/rules/). Правила — markdown-файлы с постоянными инструкциями. Cline также видит .cursorrules, .windsurfrules и AGENTS.md.
2. Положите в него инструкции Memory Bank: структуру файлов и порядок чтения и обновления. Готовый текст есть на странице Memory Bank в документации Cline; ниже мы дадим короткую собственную версию.
3. Попросите Cline: «initialize memory bank». Он создаст структуру.
4. В дальнейшем начинайте работу фразой «follow your custom instructions» и после значимых этапов говорите «update memory bank».

Короткая версия правила, которую удобно положить в проект:

## Memory Bank: правила работы

Перед каждой задачей прочитай memory-bank/activeContext.md и memory-bank/progress.md.
Остальные файлы читай, только если задача касается архитектуры, стека или целей проекта.
После значимых изменений обнови activeContext.md (не длиннее 40 строк) и progress.md.
Не копируй в memory-bank код и логи: указывай пути к файлам.

Обратите внимание на разницу с «эталонным» текстом из документации: там агент обязан читать все файлы в начале каждой задачи. Это надёжно, но дорого, о чём ниже.

Цена памяти в токенах

Агент отправляет модели накопленную переписку на каждом шаге. Всё, что он прочитал в начале задачи, остаётся в контексте и оплачивается заново при каждом следующем запросе. Формула проста:

расход на память = токены файлов × число запросов в задаче × цена входа.

Цены на 18 октября 2026, claude-sonnet-5-5 через OpenAI-совместимый формат: вход $0.4 за 1M токенов. Допустим, шесть файлов вместе весят 12 000 токенов, а задача делает 25 запросов.

12 000 × 25 = 300 000 токенов, 0.3 × 0.4 = $0.12 за задачу. При 20 задачах в день это $2.40.

Если сократить память до 3 000 токенов (читаются только два файла): 3 000 × 25 = 75 000 токенов, 0.075 × 0.4 = $0.03 за задачу, при 20 задачах $0.60 в день.

Это верхняя оценка при условии, что файлы остаются в контексте всех 25 запросов, и без скидки за кэш. В OpenAI-формате для Claude скидки за кэш нет: весь вход идёт по цене входа. Для моделей GPT чтение кэша видно в обоих форматах. Для дешёвых моделей цифры другие: у deepseek-v4.1-flash вход стоит $0.013, и те же 300 000 токенов обойдутся в 0.3 × 0.013 = $0.0039. Но дешевле не значит достаточно: сравнивайте модели по цене, контексту и индексу силы (39 у deepseek-v4.1-flash, 48 у claude-sonnet-5-5) и проверяйте, справляется ли модель с задачей. Актуальный список цен — GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Как не раздуть память

Несколько приёмов, которые работают независимо от провайдера.

Держите файлы короткими. activeContext.md должен отвечать на вопросы «над чем работаем» и «что дальше», а не хранить историю. Прошлое переносите в архив вне memory-bank/.

Читайте выборочно. Не заставляйте агента открывать все шесть файлов на каждую мелкую правку. Базовое чтение — два файла, остальное по необходимости.

Условные правила. Cline умеет включать правило только когда вы работаете с подходящими файлами. В начало файла правил добавляется блок YAML:

---
paths:
  - "memory-bank/**"
  - "docs/architecture/**"
---

Правило с таким блоком подключается, когда текущая работа затрагивает перечисленные пути. Без условий все правила загружаются в каждый запрос, и по мере роста библиотеки правил это тратит токены и размывает внимание агента.

Команды управления контекстом. /newtask упаковывает план, сделанное и нужные файлы в новую задачу с чистым окном контекста, /smol (синоним /compact) сжимает текущую переписку. Перед сменой задачи попросите обновить память, затем начните новую.

Ссылки вместо копий. В файлах памяти указывайте пути (src/billing/invoice.py), а не вставляйте код: агент откроет файл, когда понадобится.

Правила и workflows

Memory Bank — только один из видов постоянных инструкций. Рядом стоит различать:

• Правила (.clinerules/): стиль кода, ограничения («не трогать /legacy»), структура проекта. Загружаются автоматически, поэтому их нужно держать короткими и конкретными.
• Workflows: сценарии для повторяемых операций (релиз, миграция, ревью). Они лежат в папке workflows/ проектной или глобальной конфигурации и запускаются по запросу, поэтому токены тратят только когда нужны. Как именно вызывать workflow в вашей версии, смотрите в документации Cline.
• Глобальные правила в ~/.cline/rules относятся ко всем проектам, а при конфликте проектные правила приоритетнее.

Из этого следует простое разделение: то, что нужно всегда, кладите в правила, то, что нужно иногда, — в workflows, то, что меняется от сессии к сессии, — в Memory Bank. Файл AGENTS.md подойдёт, если вы хотите общие инструкции для нескольких инструментов; см. также статью о том, как писать CLAUDE.md↗, там принципы те же.

Подключение провайдера

Чтобы Cline работал на ключе шлюза, в настройках провайдера выберите OpenAI-совместимый API и укажите Base URL https://api.zukko.pro/v1, ключ fetch_... из кабинета↗ и идентификатор модели. Подробности — в документации↗ и статье про подключение Cline↗. Отдельный ключ с дневным лимитом в долларах защитит от случайного цикла, а о других способах сократить расход написано в статье про уменьшение расхода токенов↗.

Частые вопросы

Нужно ли создавать Memory Bank вручную?

Нет, достаточно положить правило и попросить Cline «initialize memory bank». Он создаст структуру сам, а вы отредактируете содержимое.

Должен ли Cline читать все файлы Memory Bank каждый раз?

В эталонных инструкциях из документации — да. Но можно ограничиться двумя файлами и читать остальные по необходимости, это снижает расход токенов.

Чем Memory Bank отличается от README?

README описывает проект для людей и меняется редко. Memory Bank содержит активный контекст и прогресс, которые обновляются почти каждую сессию.

Сколько стоит такая память?

По формуле: токены файлов × число запросов в задаче × цена входа. Для 12 000 токенов, 25 запросов и цены $0.4 за 1M это $0.12 за задачу. Баланс пополняется от $1 через СБП (комиссия платёжной страницы 8,5%), картой MasterCard или криптой.