Быстрый старт: установка и настройка

Что вы сможете сделать после изучения

В этом уроке вы научитесь:

Установить плагин opencode-supermemory в среду OpenCode.
Настроить Supermemory API Key для подключения к облачной базе памяти.
Проверить успешность загрузки плагина.
Устранить потенциальные конфликты с другими плагинами (например, Oh My OpenCode).

После завершения ваш Agent получит базовую возможность подключения к облачной базе памяти.

Ваша текущая проблема

Возможно, вы заметили, что хотя Agent OpenCode умен, он очень забывчив:

При каждом запуске новой сессии он забывает предыдущие предпочтения, как будто страдает потерей памяти.
Стандарты архитектуры, которые вы объяснили в проекте A, Agent забывает в проекте B.
В длительных сессиях ключевая информация "выталкивается" из контекста.

Вам нужен внешний мозг, который поможет Agent запомнить всё это.

Когда использовать этот метод

Первое использование: Когда вы впервые знакомитесь с opencode-supermemory.
Переустановка среды: Когда вы переноситесь на новый компьютер или сбрасываете конфигурацию OpenCode.
Поиск и устранение проблем: Когда вы подозреваете, что плагин установлен неправильно или есть проблемы с подключением API.

🎒 Подготовка перед началом

Перед началом убедитесь, что вы уже:

Установили OpenCode: Убедитесь, что команда opencode доступна в терминале.
Получили API Key:
- Перейдите на Supermemory Console
- Зарегистрируйтесь или войдите
- Создайте новый API Key (начинается с sm_)

Что такое Supermemory?

Supermemory — это облачный слой памяти, специально разработанный для AI Agent. Он не только хранит данные, но и помогает Agent с помощью семантического поиска вспоминать нужное в нужное время.

Основная идея

Процесс установки очень прост, по сути это три шага:

Установка плагина: Запустите скрипт установки для регистрации плагина в OpenCode.
Настройка ключа: Сообщите плагину ваш API Key.
Проверка подключения: Перезапустите OpenCode, убедитесь, что Agent видит новый инструмент.

Следуйте моему примеру

Шаг 1: Установка плагина

Мы предоставляем два способа установки, выберите подходящий.

Я человек (интерактивная установка)Я Agent (автоматическая установка)

bash

# Рекомендуется: будет интерактивное руководство, которое поможет автоматически обработать конфигурацию
bunx opencode-supermemory@latest install

bash

# Если вы просите Agent установить плагин, используйте эту команду (пропустить интерактивное подтверждение и автоматически устранить конфликты)
bunx opencode-supermemory@latest install --no-tui --disable-context-recovery

Что вы должны увидеть: В терминале выводится ✓ Setup complete!, что означает, что плагин успешно зарегистрирован в ~/.config/opencode/opencode.jsonc.

Шаг 2: Настройка API Key

Плагину нужен API Key для чтения и записи вашей облачной памяти. У вас есть два способа настройки:

Способ A: переменная среды (рекомендуется)

Просто добавьте в файл конфигурации вашей оболочки (например, .zshrc или .bashrc):

bash

export SUPERMEMORY_API_KEY="sm_ваш_ключ..."

Способ B: файл конфигурации

Или создайте специальный файл конфигурации ~/.config/opencode/supermemory.jsonc:

json

{
  "apiKey": "sm_ваш_ключ..."
}

Почему: Переменные среды безопаснее и не будут случайно отправлены в репозиторий кода; файл конфигурации удобнее для управления множественными настройками.

Шаг 3: Устранение конфликтов (если вы используете Oh My OpenCode)

Если вы установили Oh My OpenCode, встроенная функция управления контекстом может конфликтовать с Supermemory.

Метод проверки: Скрипт установки обычно автоматически обнаруживает и предлагает вам отключить конфликтующие хуки. Если нет, вручную проверьте ~/.config/opencode/oh-my-opencode.json:

json

{
  "disabled_hooks": [
    "anthropic-context-window-limit-recovery"  // ✅ Убедитесь, что эта строка существует
  ]
}

Почему: Supermemory обеспечивает более интеллектуальное "упреждающее сжатие" (Preemptive Compaction), если оба плагина пытаются управлять контекстом одновременно, это приведет к путанице.

Шаг 4: Проверка установки

Перезапустите OpenCode, затем запустите команду проверки:

bash

opencode -c

Или просто введите в интерактивный режим OpenCode и просмотрите список инструментов.

Что вы должны увидеть: В списке инструментов (Tools) появляется инструмент supermemory.

Available Tools:
- supermemory (add, search, profile, list, forget)
...

Контрольная точка ✅

Проверьте следующие пункты, чтобы убедиться, что всё готово:

[ ] Запустите cat ~/.config/opencode/opencode.jsonc, вы должны увидеть "opencode-supermemory" в списке plugin.
[ ] Переменная среды SUPERMEMORY_API_KEY действует (можно проверить с помощью echo $SUPERMEMORY_API_KEY).
[ ] После запуска opencode Agent не выдает сообщений об ошибках.

Предупреждения о типичных ошибках

Частая ошибка: API Key не действует

Если вы установили переменную среды, но плагин сообщает об отсутствии аутентификации, проверьте:

Перезапустили ли вы терминал? (После изменения .zshrc нужно выполнить source ~/.zshrc или перезапустить)
Перезапустили ли вы OpenCode? (Процесс OpenCode нужно перезапустить, чтобы прочитать новую переменную)

Частая ошибка: ошибка формата JSON

Если вы вручную изменяете opencode.jsonc, убедитесь, что формат JSON правильный (особенно запятые). Скрипт установки автоматически обрабатывает это, но при ручном изменении легко ошибиться.

Итог урока

Поздравляем! Вы успешно установили "гиппокамп" для OpenCode. Теперь ваш Agent готов начать запоминать.

Мы установили плагин opencode-supermemory.
Мы настроили учетные данные для облачного подключения.
Мы устранили потенциальные конфликты плагинов.

Предпросмотр следующего урока

В следующем уроке мы изучим Инициализация проекта: создание первого впечатления.
Вы узнаете:
Как с помощью одной команды позволить Agent глубоко просканировать весь проект.
Как позволить Agent запомнить архитектуру, технологический стек и неявные правила проекта.
Как просмотреть, что именно запомнил Agent.

Приложение: справочник по исходному коду

Нажмите, чтобы просмотреть расположение исходного кода

Время обновления: 2026-01-23

Функция	Путь к файлу	Номер строки
Логика скрипта установки	`src/cli.ts`	327-410
Логика регистрации плагина	`src/cli.ts`	195-248
Логика обнаружения конфликтов	`src/cli.ts`	273-320
Загрузка файла конфигурации	`src/config.ts`	-