/ Каталог / Песочница / Context Mode
● Сообщество mksglu ⚡ Сразу

Context Mode

автор mksglu · mksglu/context-mode

Изолируйте вывод инструментов и сохраняйте состояние сессии в SQLite — на 98% меньше расхода токенов и никакой амнезии при компакшне.

Context Mode решает проблему «LLM забыл, что делал» двумя способами. Первый: sandbox-инструменты перехватывают сырые данные за пределами контекстного окна (снимок playwright: 56 КБ → индексируется, агент ищет то, что нужно). Второй: журнал событий SQLite на сессию переживает компакшн контекста — модель продолжает именно с того места, где остановилась. Работает как плагин + MCP для 12 платформ.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

context-mode-mcp.replay ▶ готово
0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "context-mode-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "context-mode-mcp",
      "command": "npx",
      "args": [
        "-y",
        "context-mode"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json
{
  "context_servers": {
    "context-mode-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "context-mode"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add context-mode-mcp -- npx -y context-mode

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: Context Mode

Перестать сжигать контекст на сыром выводе инструментов

👤 Активные пользователи Claude Code, которые сталкиваются с компакшном в середине сессии ⏱ ~15 min intermediate

Когда использовать: Вы замечаете, что агент «забывает» через 30 минут и тратит деньги на повторное чтение.

Предварительные требования
  • Claude Code v1.0.33+brew upgrade claude-code или npm update -g @anthropic-ai/claude-code
Поток
  1. Установка
    /plugin marketplace add mksglu/context-mode
    /plugin install context-mode@context-mode✓ Скопировано
    → Плагин регистрирует хуки + 6 sandbox-инструментов
  2. Проверка
    /context-mode:ctx-doctor✓ Скопировано
    → Все проверки [x]
  3. Использовать как обычно
    Now do a big task that would normally blow context — e.g. analyze all .log files under /var/log✓ Скопировано
    → ctx_execute используется вместо сырого Read; вывод индексируется, а не дампится
  4. Проверить экономию
    /context-mode:ctx-stats✓ Скопировано
    → Отчёт о коэффициенте сокращения по каждому инструменту

Итог: Та же задача, в 10 раз дольше до компакшна, и агент помнит.

Подводные камни
  • Другие MCP обходят маршрутизацию — Прогоняйте их вызовы через ctx_batch_execute для последовательного учёта
Сочетать с: serena

Бесшовно продолжить долгую задачу после компакшна модели

👤 Разработчики в многочасовых агентных сессиях ⏱ ~5 min beginner

Когда использовать: Задача слишком большая, чтобы уместиться в одном контекстном окне.

Поток
  1. Запуск с --continue
    [CLI flag] claude --continue✓ Скопировано
    → SQLite предыдущей сессии загружен
  2. Наблюдение
    What did I last ask you about? What tasks are in progress?✓ Скопировано
    → Точный пересказ из FTS5-индекса, без галлюцинаций

Итог: Подлинно возобновляемый воркфлоу.

Подводные камни
  • Забыть --continue означает начать заново — Персистентность требует --continue; без него — намеренный чистый старт

Комбинации

Сочетайте с другими MCP — эффект x10

context-mode-mcp + serena

Serena для семантической навигации по коду, context-mode чтобы держать её вывод за пределами контекста

Use serena for the lookup, ctx_execute to post-process the results.✓ Скопировано
context-mode-mcp + playwright

Снимок страницы остаётся в sandbox

Snapshot the page via playwright, let context-mode hold it — search it instead of dumping.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
ctx_execute code: str (js/python) Запустить скрипт для обработки данных; выводить только нужное free
ctx_batch_execute ops: [{tool, args}] Обернуть несколько вызовов инструментов через sandbox free
ctx_index content: str, tags?: [] Сохранить данные для последующего извлечения free
ctx_search query: str Извлечь из индекса сессии free
ctx_fetch_and_index url: str Загрузить URL, держать за пределами контекста, но с возможностью поиска free
ctx_stats none Посмотреть, сколько контекста было сэкономлено free

Стоимость и лимиты

Во что обходится

Квота API
Локально
Токенов на вызов
Значительное сокращение — 98% на реальных сессиях по замерам
Деньги
Бесплатно (лицензия ELv2)
Совет
Чем дольше сессия, тем больше выгода — используйте для долгих задач

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: SQLite сессии в ~/.context-mode/
Исходящий трафик: Отсутствует

Устранение неполадок

Частые ошибки и исправления

ctx-doctor показывает отсутствующие хуки

Полностью перезапустите Claude Code после установки; хуки регистрируются при старте

Проверить: Re-run /context-mode:ctx-doctor
Sandbox не выполняет код

Не установлен рантайм Node/Python. Doctor укажет какой. Установите через brew/asdf.

Поиск не возвращает результатов

Verify FTS5 built: sqlite3 ~/.context-mode/session.db "SELECT name FROM sqlite_master". Reinstall if broken.

Альтернативы

Context Mode в сравнении

АльтернативаКогда использоватьКомпромисс
Raw Claude Code (no plugin)Короткие сессии, которые никогда не доходят до компакшнаНет экономии контекста
claude-memХотите слой памяти без парадигмы sandbox-инструментовДругой компромисс — только память, без sandbox для вывода инструментов

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills