Claude Config Editor CLI
Локальный веб-редактор конфигурации Claude Code: показывает вес проектов, удаляет старые истории чатов и правит MCP-серверы
- 265 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Редактор читает и перезаписывает `.claude.json` целиком, где лежат переписка проектов и настройки MCP-серверов
- Удаление проекта стирает его историю чата, откат возможен только из `.claude.backup.json`
Установка
- Работает в
Ручная установка
git clone https://github.com/gagarinyury/claude-config-editor.git && cd claude-config-editor && python3 server.pyРедактор откроется по адресу http://localhost:8765. Нужен Python 3.7 или новее, другие пакеты не требуются.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Редактор читает и перезаписывает `.claude.json` целиком, где лежат переписка проектов и настройки MCP-серверов
- Удаление проекта стирает его историю чата, откат возможен только из `.claude.backup.json`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Claude Config Editor — один Python-скрипт с веб-интерфейсом. Команда `python3 server.py` запускает локальный сервер на порту 8765, и редактор сам находит конфигурации Claude Code (`~/.claude.json`) и Claude Desktop (`claude_desktop_config.json`) на macOS, Linux и Windows. Зависимостей нет, хватает стандартной библиотеки Python 3.7 и новее. Вкладка с обзором показывает размер файла и список проектов, отсортированный по весу. Claude Code хранит историю переписки всех проектов в одном JSON, поэтому после нескольких недель работы файл разрастается. Редактор позволяет выбрать самые тяжелые проекты кнопкой «Top 10 Largest», удалить их историю пачкой и перед этим выгрузить любой проект в отдельный JSON. Есть поиск и сортировка по размеру, имени и числу сообщений. Вкладка MCP Servers перечисляет серверы с командой, аргументами, переменными окружения и рабочей папкой. Сервер добавляется и удаляется кнопками без ручной правки JSON. Изменения живут в памяти, пока вы не нажмете Save. Перед каждой записью редактор делает копию `.claude.backup.json`, а чтобы изменения подхватились, Claude нужно перезапустить. Автор подчеркивает, что инструмент работает только локально: сетевых запросов и телеметрии в нем нет.
Для кого. Для тех, кто давно работает в Claude Code, заметил, что `.claude.json` раздулся до десятков мегабайт, и хочет почистить его и свои MCP-серверы без ручной правки JSON.
Подходит, если
- Файл `.claude.json` стал очень большим, и Claude Code запускается медленно
- Нужно удалить истории чатов старых проектов, предварительно сохранив важные в JSON
- Хочется увидеть в одном списке все MCP-серверы Claude Code и Claude Desktop с командами и переменными окружения
- Нужно быстро добавить или убрать MCP-сервер без опечаток в JSON
- Перед чисткой хочется получить автоматическую копию конфигурации в `.claude.backup.json`
Не подходит, если
- История переписки с проектами нужна целиком, а экспортировать каждый проект вручную неудобно
- Claude Code сейчас запущен и пишет в тот же файл: перед правкой его лучше закрыть
- Нужна установка через менеджер пакетов или CLI-команда: проект запускается как скрипт из клонированного репозитория
- Конфигурацией управляет команда или система развертывания, и ручные правки на машине будут перезаписаны
Пример запроса к агенту
Склонируй claude-config-editor, запусти `python3 server.py` и открой http://localhost:8765, чтобы я увидел самые тяжелые проекты в `.claude.json`.Ограничения
- Удаление проекта стирает его историю чата безвозвратно после сохранения. Откатить можно только копией `.claude.backup.json`, которую редактор создает перед записью, или обновлением страницы до нажатия Save.
- Для работы нужен Python 3.7 или новее, а запуск идет из клонированного репозитория командой `python3 server.py`.
- Редактор правит только файлы конфигурации Claude Code и Claude Desktop, найденные автоматически. Другие места хранения истории он не трогает.
- Изменения вступают в силу после перезапуска Claude.
- Последние изменения в репозитории датированы осенью 2025 года, поэтому совместимость с новыми версиями Claude Code перед очисткой стоит проверить на копии файла.
Как отключить. Остановите сервер сочетанием Ctrl+C в окне терминала, где запущен `python3 server.py`, и удалите папку репозитория. Если нужно вернуть прежнее состояние, скопируйте `.claude.backup.json` обратно на место `.claude.json`.
Частые вопросы
Почему файл .claude.json такой большой?
Claude Code хранит историю переписки всех проектов в одном JSON. Редактор показывает проекты по убыванию размера, и самые тяжелые можно выбрать кнопкой «Top 10 Largest».
Как сохранить историю чата перед удалением?
В разделе Project History нажмите Export у нужного проекта, и браузер скачает JSON с его перепиской. После этого проект можно удалять и сохранять изменения.
Как восстановить конфигурацию после ошибки?
Перед каждым сохранением редактор создает копию `.claude.backup.json`. Верните ее на место `.claude.json`, а до нажатия Save изменения можно отменить обновлением страницы.
Отправляет ли редактор данные в интернет?
По описанию автора нет: сервер слушает localhost:8765, телеметрии и сетевых запросов нет. Код занимает около трехсот строк Python, его можно прочитать за несколько минут.
Как управлять MCP-серверами Claude через этот редактор?
Откройте вкладку MCP Servers: там видны команда, аргументы, переменные окружения и рабочая папка каждого сервера. Кнопка добавления создает запись по имени и команде, кнопка Delete убирает ее, и после Save нужен перезапуск Claude.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыcc-lens
Claude Code Lens (cc-lens)
Локальная аналитика Claude Code: панель по сессиям, токенам, расходам и проектам из данных каталога ~/.claude, без облака
MCP-сервер для работы агента с локальным компьютером: терминал и долгие процессы, поиск и правка файлов, Excel, PDF и DOCX
Плагин для Claude Code: строка статуса с контекстом, лимитами за 5 часов и 7 дней, стоимостью и расходом Codex, Gemini и z.ai
Claude Code History Viewer
claude-code-history-viewer
Настольное приложение для просмотра, поиска и анализа истории разговоров из Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Aider и других агентов
Minutes
minutes
Локальный MCP-сервер для памяти о встречах: запись и транскрипция на устройстве в Markdown, поиск истории из Claude Code, Codex, Cursor и других MCP-клиентов
Плагин для Claude Code, который хранит память между сессиями в одном локальном файле, без базы, облака и ключей API
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Config Editor (эта запись) | нет | 265 | |
| cc-lens | нет | 599 | показывает аналитику сеансов, токенов и стоимости, а здесь правится сам файл конфигурации |
| Claude Usage | нет | 2 282 | локальная панель по журналам Claude Code только для чтения, без правки конфигурации |
Коротко о README
Страница описывает проблему раздутого `.claude.json`, показывает скриншоты трех вкладок и дает запуск в три команды. Затем идут сценарии использования, таблица путей к конфигурациям для разных систем и ответы на частые вопросы о безопасности.