Как начать задачу в Claude Code и продолжить в Codex без пересказа: ставим ai-memory (проверено 26 октября 2026)
Память лежит в git-вики из markdown-файлов на диске, ключ API для работы не нужен.
ai-memory — открытый проект с лицензией MIT: слой долговременной памяти для кодовых агентов. На 26 октября 2026 года у репозитория 13 702 звезды и 970 форков по данным GitHub API; создан 21 мая 2026 года, последнее обновление — в день проверки. Автор описывает его как решение для долговременной памяти агентов-CLI и передачи работы между разными вендорами.
Что это и где хранится память
Хуки жизненного цикла агента записывают промпты, вызовы инструментов и границы сессий. Перед сохранением данные проходят очистку — в README она названа «типизированной границей приватности». Как именно чистятся секреты, README не пишет, отсылая к документам DATA_HANDLING.md и docs/security.md.
В конце сессии наблюдения превращаются в страницы вики. Источник истины — git-репозиторий из обычных .md-файлов: их можно искать через grep, править в Obsidian или синхронизировать. SQLite-индекс (FTS5, сущности, опциональные эмбеддинги) производный и пересобирается из файлов. Каталог данных содержит wiki/, raw/, db/, models/ и logs/; на macOS это ~/Library/Application Support/ai-memory.
Ключ LLM или эмбеддингов опционален: по умолчанию память работает без единого вызова модели, поиск тоже. Консолидация «dream» по умолчанию выключена. Заявлена поддержка больше двадцати агентов, среди них Claude Code, Codex, Cursor и Gemini CLI.
Установка
Сначала ставится бинарник (Linux и macOS). Первая команда скачивает и запускает установщик из последнего релиза, вторая подключает агентов:
ai-memory setup создаёт каталог данных с токеном в файле, доступном только владельцу, запускает пользовательский сервис (systemd --user на Linux, LaunchAgent на macOS) и прописывает MCP, хуки и Agent Skills для найденных агентов. Перед правками показывает план и спрашивает подтверждение; флаг --plan только печатает план. Повторный запуск ничего нового не делает.
Для Windows в README есть PowerShell-вариант установки, но нативная поддержка там экспериментальная, а через WSL2 — поддерживается.
Плагины для Claude Code и Codex
Плагины ставятся поверх уже установленного бинарника:
Первая строка добавляет репозиторий как маркетплейс плагинов Claude Code и ставит из него плагин, вторая делает то же для Codex. После этого Codex просит подтвердить доверие к хукам в меню /hooks.
Как перейти из одного агента в другой
Переключение идёт через лаунчер ai-memory run. По README, после выхода из Claude Code команда ai-memory run codex отдаёт Codex общий рабочий поток плюс приватную временную локальную проекцию видимой нативной истории Claude:
run claude и run codex запускают соответствующего агента в текущей папке; continue возобновляет новейший управляемый чекаут; resume предлагает выбрать рабочий поток в этом чекауте, а --search auth ищет поток по имени.
Передачи (handoff) устроены как типизированный протокол: у каждой есть владелец, и забрать её можно ровно один раз. В README продолжение описано через вопрос агенту: достаточно спросить «where did we leave off?», и он продолжит с ожидающей передачи. Если лаунчер завершился аварийно и оставил блокировку, помогает ai-memory run --force-unlock codex: она только снимает аренду потока и не убивает процесс агента.
Для просмотра накопленного: ai-memory recent показывает новейшие страницы, ai-memory recent --global — по всем проектам. Поиск идёт через агента («search memory for …») по MCP-инструменту memory_query с фильтрами path_prefix, tag, kind, tier.
Ограничения
- Нужен git: на него опираются захват через хуки и проверка ai-memory doctor.
- Docker-вариант по умолчанию запускается без аутентификации, пока её не включить командой ai-memory auth enable.
- Часть агентов поддерживается только через MCP, только через хуки или только в управляемом режиме — возможности зависят от агента.
- Для сборки из исходников нужен Rust; приложению для меню macOS — ещё Xcode и Swift 6.
- Чтобы ограничить, что попадает в память, в репозитории задают правила [capture]: исключить пути или перейти на белый список.
Что для чего
- Нужна память без внешних сервисов — достаточно ai-memory setup, ключи не требуются.
- Нужно переключаться между Claude Code и Codex в одной папке — ai-memory run claude, затем ai-memory run codex.
- Нужен читаемый архив решений — страницы вики лежат в wiki/ и открываются в Obsidian.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».