Документация
Как сохранить историю чатов Claude Code и Codex локально
Сохраните читаемую копию рабочего диалога, пока его история доступна в клиенте. Agent Hub копирует поддерживаемые локальные события Claude Code, Codex и DeepSeek Harness в свой архив. Исходные файлы остаются у клиентов.
Руководство относится к текущему исходному коду. Установка и различия между кандидатом и опубликованной бетой описаны в быстром старте.
Сохраните доступную историю
Откройте локальный интерфейс:
ahub ui- Перейдите в All data → Chats → Sources & automatic updates.
- Выберите поддерживаемые хранилища, которые хотите сохранить.
- Нажмите Save chats to Hub, а если архив уже есть — Update archive now.
- Прочитайте результат для каждого источника и предупреждения о полноте. Откройте один сохранённый чат и проверьте исходное сообщение.
Сохранение копирует доступные поддерживаемые события, включая сообщения и результаты инструментов. Оно не читает все облачные аккаунты и не восстанавливает файлы, удалённые до копирования. Обнаруженный источник ещё не означает, что вся его история сохранена.
Сохраняйте новые сообщения после закрытия интерфейса
Выбрав источники, включите Update selected sources in the background. Локальный процесс проверяет выбранные хранилища каждые 30 секунд и продолжает работать после закрытия страницы и сервера интерфейса Hub. Новые сохранения оставляют доступными прежние версии.
Проверить или остановить обновления можно в терминале:
ahub history status
ahub history watch --stopОстановка обновлений не удаляет чаты. Если исходное хранилище стало недоступно, уже сохранённые диалоги тоже остаются в Hub. Чтобы изменить выбор источников, сначала приостановите обновления, проверьте новый список и снова включите их.
Необязательная настройка Resume selected updates when I sign in добавляет запуск при входе в систему на macOS или Linux после просмотра плана. Закрытие браузера и перезагрузка компьютера — разные случаи: фоновые обновления сами по себе не включают автозапуск. Подробнее — в руководстве по обновлениям.
Разберитесь с предупреждениями о полноте
| Что видно | Что это значит |
|---|---|
| Источник прочитан полностью | Выбранное поддерживаемое хранилище удалось прочитать при этом обновлении. |
| Неполное покрытие или неподдерживаемые события | Некоторые события не удалось полностью проиндексировать. Откройте подробности этого диалога. |
| Ссылки на вложения без локальных копий | В записи упоминается файл, но Hub не сохранил его содержимое. Сами сообщения при этом могут быть на месте. |
| Источник недоступен | Hub сейчас не может прочитать оригинал. Ранее сохранённые версии остаются доступны. |
Проверяйте и события, и вложения. Полное чтение источника не означает, что скопированы все изображения, загруженные документы и внешние ссылки. Новые сообщения тоже остаются несохранёнными до следующего успешного копирования.
Это полноценный бэкап?
Архив помогает, если доступ к исходным файлам пропал после того, как Hub успел их скопировать. По умолчанию он находится на том же компьютере в ~/.agent-hub/state/history и не входит в обычную Git-историю Hub. Это не отдельная резервная копия на другом устройстве и не зашифрованное хранилище.
Для защиты от поломки устройства используйте обычное приватное резервное копирование компьютера. Сохраняйте данные Hub и восстановления; не коммитьте их в публичный репозиторий. ZIP с исходниками, отправка Git-репозитория Hub или переустановка CLI не заменяют копию архива. Перед переносом или сбросом прочитайте об ограничениях восстановления.
Можно ли выгрузить сохранённый диалог?
Откройте чат, раскройте Conversation details & preserved versions, выберите версию и нажмите Download preserved source. Вы получите исходные байты этой версии в нативном формате. Если нужен небольшой читаемый набор фрагментов для другого клиента, используйте продолжение в другом клиенте.
Если поисковый индекс нужно перестроить, Storage & troubleshooting → Rebuild search index создаст индексы событий заново из сохранённых исходных данных. Эта операция не вернёт отсутствующие исходники и не исправит любые повреждения архива.
Дальше: найдите прежний ответ или откройте справочник архива.