🌐 Это автоматический перевод. Приветствуются исправления от сообщества!

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">Система сжатия постоянной памяти, созданная для <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#быстрый-старт">Быстрый старт</a> •
  <a href="#как-это-работает">Как это работает</a> •
  <a href="#инструменты-поиска-mcp">Инструменты поиска</a> •
  <a href="#документация">Документация</a> •
  <a href="#конфигурация">Конфигурация</a> •
  <a href="#устранение-неполадок">Устранение неполадок</a> •
  <a href="#лицензия">Лицензия</a>
</p>

<p align="center">
  Claude-Mem бесшовно сохраняет контекст между сеансами, автоматически фиксируя наблюдения за использованием инструментов, генерируя семантические сводки и делая их доступными для будущих сеансов. Это позволяет Claude поддерживать непрерывность знаний о проектах даже после завершения или переподключения сеансов.
</p>

---

## Быстрый старт

Установите одной командой:

```bash
npx claude-mem install
```

Или установите для OpenCode:

```bash
npx claude-mem install --ide opencode
```

Или установите для Antigravity CLI ([руководство по настройке](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

Или установите из маркетплейса плагинов внутри Claude Code:

```bash
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
```

Перезапустите Claude Code. Контекст из предыдущих сеансов будет автоматически появляться в новых сеансах.

> **Примечание:** Claude-Mem также опубликован на npm, но `npm install -g claude-mem` устанавливает **только SDK/библиотеку** — это не регистрирует хуки плагина и не настраивает сервис worker. Всегда устанавливайте через `npx claude-mem install` или команды `/plugin`, указанные выше.

### 🦞 OpenClaw Gateway

Установите claude-mem как плагин постоянной памяти на шлюзах [OpenClaw](https://openclaw.ai) одной командой:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

Установщик берёт на себя зависимости, настройку плагина, конфигурацию AI-провайдера, запуск worker и опциональные потоки наблюдений в реальном времени в Telegram, Discord, Slack и другие сервисы. Подробности см. в [Руководстве по интеграции OpenClaw](https://docs.claude-mem.ai/openclaw-integration).

**Ключевые возможности:**

- 🧠 **Постоянная память** - Контекст сохраняется между сеансами
- 📊 **Прогрессивное раскрытие** - Многоуровневое извлечение памяти с видимостью стоимости токенов
- 🔍 **Поиск на основе навыков** - Запросы к истории проекта с помощью навыка mem-search
- 🖥️ **Веб-интерфейс просмотра** - Поток памяти в реальном времени по URL worker, выводимому при запуске
- 💻 **Навык для Claude Desktop** - Поиск в памяти из разговоров Claude Desktop
- 🔒 **Контроль конфиденциальности** - Используйте теги `<private>` для исключения конфиденциального контента из хранилища
- ⚙️ **Настройка контекста** - Детальный контроль того, какой контекст внедряется
- 🤖 **Автоматическая работа** - Не требуется ручное вмешательство
- 🔗 **Цитирование** - Ссылки на прошлые наблюдения по ID через API worker или просмотр всех в веб-интерфейсе

---

## Документация

📚 **[Просмотреть полную документацию](https://docs.claude-mem.ai/)** - Просмотр на официальном сайте

### Начало работы

- **[Руководство по установке](https://docs.claude-mem.ai/installation)** - Быстрый старт и продвинутая установка
- **[Руководство по использованию](https://docs.claude-mem.ai/usage/getting-started)** - Как Claude-Mem работает автоматически
- **[Инструменты поиска](https://docs.claude-mem.ai/usage/search-tools)** - Запросы к истории проекта на естественном языке

### Лучшие практики

- **[Инженерия контекста](https://docs.claude-mem.ai/context-engineering)** - Принципы оптимизации контекста для AI-агентов
- **[Прогрессивное раскрытие](https://docs.claude-mem.ai/progressive-disclosure)** - Философия стратегии подготовки контекста в Claude-Mem

### Архитектура

- **[Обзор](https://docs.claude-mem.ai/architecture/overview)** - Компоненты системы и поток данных
- **[Эволюция архитектуры](https://docs.claude-mem.ai/architecture-evolution)** - Путь от v3 к v5
- **[Архитектура хуков](https://docs.claude-mem.ai/hooks-architecture)** - Как Claude-Mem использует хуки жизненного цикла
- **[Справочник по хукам](https://docs.claude-mem.ai/architecture/hooks)** - Объяснение 7 скриптов хуков
- **[Сервис Worker](https://docs.claude-mem.ai/architecture/worker-service)** - HTTP API и управление Bun
- **[База данных](https://docs.claude-mem.ai/architecture/database)** - Схема SQLite и поиск FTS5
- **[Архитектура поиска](https://docs.claude-mem.ai/architecture/search-architecture)** - Гибридный поиск с векторной базой данных Chroma

### Конфигурация и разработка

- **[Конфигурация](https://docs.claude-mem.ai/configuration)** - Переменные окружения и настройки
- **[Разработка](https://docs.claude-mem.ai/development)** - Сборка, тестирование, участие в разработке
- **[Ветки релизов](https://docs.claude-mem.ai/branches)** - Поток веток stable, core-dev и community-edge
- **[Устранение неполадок](https://docs.claude-mem.ai/troubleshooting)** - Распространенные проблемы и решения

---

## Как это работает

**Основные компоненты:**

1. **5 хуков жизненного цикла** - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 скриптов хуков)
2. **Умная установка** - Проверка кешированных зависимостей (скрипт предварительного хука, не является хуком жизненного цикла)
3. **Сервис Worker** - Локальный HTTP API с веб-интерфейсом просмотра и конечными точками поиска, управляемый Bun
4. **База данных SQLite** - Хранит сеансы, наблюдения, сводки
5. **Навык mem-search** - Запросы на естественном языке с прогрессивным раскрытием
6. **Векторная база данных Chroma** - Гибридный семантический + ключевой поиск для интеллектуального извлечения контекста

Подробности см. в [Обзоре архитектуры](https://docs.claude-mem.ai/architecture/overview).

---

## Инструменты поиска MCP

Claude-Mem предоставляет интеллектуальный поиск памяти через **4 инструмента MCP**, следуя экономичному по токенам паттерну **3-уровневого рабочего процесса**:

**3-уровневый рабочий процесс:**

1. **`search`** - Получить компактный индекс с ID (~50-100 токенов/результат)
2. **`timeline`** - Получить хронологический контекст вокруг интересующих результатов
3. **`get_observations`** - Получить полные детали ТОЛЬКО для отфильтрованных ID (~500-1000 токенов/результат)

**Как это работает:**
- Claude использует инструменты MCP для поиска в вашей памяти
- Начните с `search`, чтобы получить индекс результатов
- Используйте `timeline`, чтобы увидеть, что происходило вокруг конкретных наблюдений
- Используйте `get_observations`, чтобы получить полные детали для релевантных ID
- **Экономия токенов примерно в 10 раз** благодаря фильтрации перед получением деталей

**Доступные инструменты MCP:**

1. **`search`** - Поиск по индексу памяти с полнотекстовыми запросами, фильтрация по типу/дате/проекту
2. **`timeline`** - Получение хронологического контекста вокруг конкретного наблюдения или запроса
3. **`get_observations`** - Получение полных деталей наблюдений по ID (всегда группируйте несколько ID в один запрос)

**Пример использования:**

```typescript
// Шаг 1: Поиск по индексу
search(query="authentication bug", type="bugfix", limit=10)

// Шаг 2: Просмотрите индекс, определите релевантные ID (например, #123, #456)

// Шаг 3: Получите полные детали
get_observations(ids=[123, 456])
```

Подробные примеры см. в [Руководстве по инструментам поиска](https://docs.claude-mem.ai/usage/search-tools).

---

## Ветки релизов

Стабильные релизы выпускаются из `main` и публикуются в npm. `core-dev` и
`community-edge` — это ветки, запускаемые из исходного кода, для ранних исправлений
надежности и интеграций сообщества. См. **[Ветки релизов](https://docs.claude-mem.ai/branches)**
для описания потока веток и инструкций по запуску нестабильных версий.

---

## Системные требования

- **Node.js**: 20.0.0 или выше
- **Claude Code**: Последняя версия с поддержкой плагинов
- **Bun**: Среда выполнения JavaScript и менеджер процессов (автоматически устанавливается при отсутствии)
- **uv**: Менеджер пакетов Python для векторного поиска (автоматически устанавливается при отсутствии)
- **SQLite 3**: Для постоянного хранения (встроенный)

---
### Примечания по настройке для Windows

Если вы видите ошибку вида:

```powershell
npm : The term 'npm' is not recognized as the name of a cmdlet
```

Убедитесь, что Node.js и npm установлены и добавлены в ваш PATH. Загрузите последнюю версию установщика Node.js с https://nodejs.org и перезапустите терминал после установки.

---

## Конфигурация

Настройки управляются в `~/.claude-mem/settings.json` (автоматически создается с настройками по умолчанию при первом запуске). Настройте AI-модель, порт worker, директорию данных, уровень логирования и параметры внедрения контекста.

Все доступные настройки и примеры см. в **[Руководстве по конфигурации](https://docs.claude-mem.ai/configuration)**.

### Настройка режима и языка

Claude-Mem поддерживает несколько режимов рабочего процесса и языков через настройку `CLAUDE_MEM_MODE`.

Эта опция управляет одновременно:
- Поведением рабочего процесса (например, code, chill, investigation)
- Языком, используемым в сгенерированных наблюдениях

#### Как настроить

Отредактируйте файл настроек по адресу `~/.claude-mem/settings.json`:

```json
{
  "CLAUDE_MEM_MODE": "code--zh"
}
```

Режимы определены в `plugin/modes/`. Чтобы увидеть все доступные режимы локально:

```bash
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
```

#### Доступные режимы

| Режим | Описание |
|------------|-------------------------|
| `code` | Стандартный английский режим |
| `code--zh` | Режим упрощенного китайского |
| `code--ja` | Японский режим |

Языковые режимы следуют шаблону `code--[lang]`, где `[lang]` — это код языка ISO 639-1 (например, `zh` для китайского, `ja` для японского, `es` для испанского).

> Примечание: `code--zh` (упрощенный китайский) уже встроен — дополнительная установка или обновление плагина не требуются.

#### После изменения режима

Перезапустите Claude Code, чтобы применить новую конфигурацию режима.
---

## Разработка

Инструкции по сборке, тестированию и процессу участия в разработке см. в **[Руководстве по разработке](https://docs.claude-mem.ai/development)**.

---

## Устранение неполадок

При возникновении проблем опишите проблему Claude, и навык устранения неполадок автоматически выполнит диагностику и предоставит исправления.

Распространенные проблемы и решения см. в **[Руководстве по устранению неполадок](https://docs.claude-mem.ai/troubleshooting)**.

---

## Отчеты об ошибках

Создавайте подробные отчеты об ошибках с помощью автоматического генератора:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
```

## Участие в разработке

Приветствуются вклады! Пожалуйста:

1. Форкните репозиторий
2. Создайте ветку для функции
3. Внесите изменения с тестами
4. Обновите документацию
5. Отправьте Pull Request

Claude-Mem выпускается из трёх веток: `main` (стабильная), `core-dev` и
`community-edge`. Только `main` публикуется в npm; остальные запускаются из
исходного кода. См. [Ветки релизов](https://docs.claude-mem.ai/branches) для
описания стратегии и инструкций по локальному запуску.

Процесс участия см. в [Руководстве по разработке](https://docs.claude-mem.ai/development).

---

## Лицензия

Claude-Mem распространяется под лицензией Apache License 2.0.

Мы выбрали Apache-2.0, потому что устойчивая агентная память должна легко встраиваться
в инструменты разработчиков, локальных агентов, серверы MCP, корпоративные системы, робототехнические
стеки и производственные среды исполнения агентов.

Полные детали см. в файле [LICENSE](LICENSE). См. также [docs/license.md](docs/license.md)
и [docs/ip-boundary.md](docs/ip-boundary.md) для описания области действия лицензии и
границы между открытым и коммерческим использованием.

**Примечание о Ragtime**: Директория `ragtime/` лицензирована под **Apache License 2.0**. Подробности см. в [ragtime/LICENSE](ragtime/LICENSE).

---

## Поддержка

- **Документация**: [docs/](docs/)
- **Проблемы**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **Репозиторий**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **Официальный аккаунт X**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Официальный Discord**: [Присоединиться к Discord](https://discord.com/invite/J4wttp9vDu)
- **Автор**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**Создано с помощью Claude Agent SDK** | **Работает на Claude Code** | **Сделано на TypeScript**

---

### А что насчёт CMEM?

CMEM — это токен, созданный третьей стороной, но официально признанный создателем Claude-Mem (Alex Newman, @thedotmack). Токен выступает в роли катализатора роста сообщества и средства для доставки CMEM разработчикам и специалистам умственного труда, которым он нужен больше всего.

Официальный BASE CA: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3