Claude Conversation Extractor — экспорт разговоров Claude Code
Claude Conversation Extractor
CLI на Python без зависимостей: находит журналы Claude Code в ~/.claude/projects, ищет по ним и сохраняет разговоры в Markdown, JSON или HTML
- 691 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Инструмент читает все журналы Claude Code на диске, а в разговорах бывают ключи, пути и закрытый код
- Выгрузка пишет файлы с этим содержимым в обычную папку: режим `--detailed` добавляет вывод терминала и ответы MCP-серверов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/claude-conversation-extractorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструмент читает все журналы Claude Code на диске, а в разговорах бывают ключи, пути и закрытый код
- Выгрузка пишет файлы с этим содержимым в обычную папку: режим `--detailed` добавляет вывод терминала и ответы MCP-серверов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
У Claude Code нет кнопки экспорта: разговоры лежат в `~/.claude/projects` файлами JSONL в недокументированном формате. Claude Conversation Extractor находит эти файлы сам и превращает их в читаемые документы. Пакет ставится из PyPI, написан на чистом Python и работает на Windows, macOS и Linux. Команда `claude-extract` показывает список разговоров и выгружает выбранные: по номерам (`--extract 1,3,5`), последние (`--recent 5`) или все сразу (`--all`). Формат по умолчанию Markdown, а флаг `--format` переключает на `json` или `html`. Флаг `--detailed` добавляет в выгрузку вызовы инструментов, ответы MCP, системные сообщения и вывод терминала. Каталог результата задается флагом `--output`. Команда `claude-start` открывает интерактивное меню с поиском по мере набора, `claude-search "запрос"` ищет по всем разговорам без меню, а старое имя `claude-logs` сохранено для совместимости. Поиск регистронезависимый, показывает фрагменты совпадений и предлагает сразу выгрузить найденные сессии.
Для кого. Для тех, кто работает в Claude Code каждый день и хочет сохранять историю сессий в обычных файлах, искать в ней прошлые решения и делиться выжимками с командой.
Подходит, если
- Нужно резервно сохранить все разговоры Claude Code одной командой `claude-extract --all`, пока они не удалены
- Вы ищете решение, которое Claude подсказал на прошлой неделе, и помните только пару слов из разговора
- Нужна выгрузка в HTML для просмотра в браузере или в JSON для собственного анализа
- Для документации или разбора ошибки требуется полный транскрипт вместе с вызовами инструментов и ответами MCP: поможет `--detailed`
- Вы хотите сложить журналы в отдельную папку через `--output`, например в каталог резервных копий
Не подходит, если
- Нужен полноценный просмотрщик с графиком расходов и несколькими агентами: инструмент работает только с журналами Claude Code
- Нужна выгрузка из облачного приложения Claude на claude.ai: инструмент читает локальные файлы `~/.claude/projects`
- В журналах есть секреты, которые нельзя класть в открытые файлы: перед выгрузкой решите, где будут лежать результаты
- Нужна поддержка последних изменений формата журналов Claude Code: репозиторий давно не обновлялся
Пример запроса к агенту
claude-extract --recent 5 --format html --output ~/claude-backupsОграничения
Последний коммит в репозитории датируется январем 2026 года, поэтому формат журналов Claude Code мог измениться после этого. Инструмент разбирает недокументированные файлы JSONL, и при расхождении формата часть записей может не попасть в выгрузку.
Инструмент читает локальные журналы. Результат по умолчанию кладется в папку `Claude logs` на рабочем столе, это меняется флагом `--output`. Для Python нужна версия 3.8 или новее, на macOS и Linux пакет удобно ставить через pipx, чтобы избежать проблем с окружением.
Выгрузка в несколько форматов появилась в версии 1.1.1. В подробном режиме в выгрузку попадает все, что видел агент: команды, вывод терминала и ответы MCP-серверов, включая содержимое файлов.
Как отключить. Удалите пакет командой `pipx uninstall claude-conversation-extractor` или `pip uninstall claude-conversation-extractor`. Ранее выгруженные файлы остаются в папке результата и удаляются вручную.
Частые вопросы
Как экспортировать разговоры Claude Code в Markdown?
Установите пакет командой `pipx install claude-conversation-extractor`, затем запустите `claude-extract` и выберите разговоры из списка. Для выгрузки всего сразу есть `claude-extract --all`, для последних пяти сессий `claude-extract --recent 5`.
Где Claude Code хранит журналы?
В `~/.claude/projects` на macOS и Linux, на Windows в `%USERPROFILE%\.claude\projects`. Это файлы JSONL в недокументированном формате, которые инструмент находит автоматически.
Как найти старый разговор по слову?
Выполните `claude-search "error handling"` или откройте меню командой `claude-start` и выберите поиск: результаты появляются по мере набора. Поиск регистронезависимый и показывает фрагменты рядом с совпадением.
В каких форматах можно сохранить разговор?
В Markdown по умолчанию, в JSON для программной обработки и в HTML для просмотра в браузере. Формат задается флагом `--format`, а флаг `--detailed` добавляет вызовы инструментов и системные сообщения.
Нужны ли какие-то зависимости?
Нет, пакет написан на чистом Python и требует версию 3.8 или новее. Pipx нужен только для удобной установки без конфликтов окружения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыClaude Code History Viewer
claude-code-history-viewer
Настольное приложение для просмотра, поиска и анализа истории разговоров из Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Aider и других агентов
Локальный веб-редактор конфигурации Claude Code: показывает вес проектов, удаляет старые истории чатов и правит MCP-серверы
Локальная память для Claude Code: бинарный файл индексирует прошлые разговоры и подставляет нужный контекст в новые сессии.
Около сотни скиллов для Claude Code: встречи и расшифровки, исследования, публикации, TDD, Telegram, почта и личная аналитика
cc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
Плагин Parrot для Claude: агент ищет по записям встреч с Mac, находит обещания, пишет письма после звонка и готовит к разговору.
Коротко о README
Описание построено вокруг проблемы: у Claude Code нет экспорта, а журналы лежат в недокументированном формате. Затем идут установка для трех систем, примеры команд, форматы выгрузки, поиск и расположение файлов. В конце собраны ответы на частые вопросы.