{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "Как настроить QMD для кодинг-агентов и сократить расход токенов на поиск файлов",
    "canonical_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
    "language": "ru",
    "article_type": "руководство",
    "published_at": null,
    "updated_at": "2026-11-16T00:00:00+00:00"
  },
  "summary": "Пошаговое руководство по установке, индексации проекта и подключению QMD к Claude Code и другим ИИ-агентам, чтобы меньше тратить токены на поиск файлов. Время выполнения: 30–45 минут Уровень сложности: Intermediate",
  "topics": [
    "QMD для кодинг-агентов",
    "как настроить QMD",
    "экономия токенов ИИ-агента"
  ],
  "entities": [
    {
      "id": "E1",
      "name": "QMD для кодинг-агентов",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E2",
      "name": "как настроить QMD",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E3",
      "name": "экономия токенов ИИ-агента",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E4",
      "name": "Windows",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E5",
      "name": "Linux",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E6",
      "name": "macOS",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E7",
      "name": "Node.js",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E8",
      "name": "npm",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E9",
      "name": "Git",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E10",
      "name": "Claude",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    }
  ],
  "claims": [
    {
      "id": "AR-GUIDE-KAKNASTROI-001",
      "statement": "Время выполнения: 30–45 минут",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Время выполнения: 30–45 минут"
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-002",
      "statement": "Уровень сложности: Intermediate",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Уровень сложности: Intermediate"
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-003",
      "statement": "Понадобится: macOS, Linux или WSL2; Node.js LTS (или bun); git; кодинг-агент с поддержкой MCP (Claude Code, Cursor или аналог); репозиторий с markdown-документацией и кодом; свободное место под локальный файл индекса — оцените по размеру репозитория, индекс лежит на диске рядом с ним",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Понадобится: macOS, Linux или WSL2; Node.js LTS (или bun); git; кодинг-агент с поддержкой MCP (Claude Code, Cursor или аналог); репозиторий с markdown-документацией и кодом; свободное место под локальный файл индекса — оцените по размеру репозитория, индекс лежит на диске рядом с ним"
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-004",
      "statement": "ОС: macOS 13+, Ubuntu 22.04+ или Windows 10/11 с WSL2.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "ОС: macOS 13+, Ubuntu 22.04+ или Windows 10/11 с WSL2."
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-005",
      "statement": "Node.js LTS и npm — проверить: node -v && npm -v. Точную минимальную версию сверьте с документацией QMD.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Node.js LTS и npm — проверить: node -v && npm -v. Точную минимальную версию сверьте с документацией QMD."
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-006",
      "statement": "git — QMD индексирует рабочую копию, а не историю коммитов.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "git — QMD индексирует рабочую копию, а не историю коммитов."
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-007",
      "statement": "Ошибка: MCP error -32000: Connection closed",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Ошибка: MCP error -32000: Connection closed"
    },
    {
      "id": "AR-GUIDE-KAKNASTROI-008",
      "statement": "Причина: MCP-клиент запускает процесс в окружении без вашего PATH (типично для GUI-приложений), поэтому \"command\": \"qmd\" не находится.",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Причина: MCP-клиент запускает процесс в окружении без вашего PATH (типично для GUI-приложений), поэтому \"command\": \"qmd\" не находится."
    }
  ],
  "relationships": [
    {
      "subject": "Гайд",
      "predicate": "описывает",
      "object": "Как настроить QMD для кодинг-агентов и сократить расход токенов на поиск файлов",
      "claim_id": "AR-GUIDE-KAKNASTROI-001"
    },
    {
      "subject": "Гайд",
      "predicate": "содержит шаг",
      "object": "Шаг 1. Установите QMD и проверьте CLI",
      "claim_id": "AR-GUIDE-KAKNASTROI-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "Что это за материал?",
      "answer": "Пошаговое руководство по установке, индексации проекта и подключению QMD к Claude Code и другим ИИ-агентам, чтобы меньше тратить токены на поиск файлов.",
      "claim_ids": [
        "AR-GUIDE-KAKNASTROI-001"
      ],
      "article_anchor": "#suschnost"
    },
    {
      "question": "Что понадобится?",
      "answer": "ОС: macOS 13+, Ubuntu 22.04+ или Windows 10/11 с WSL2.; Node.js LTS и npm — проверить: node -v && npm -v. Точную минимальную версию сверьте с документацией QMD.; git — QMD индексирует рабочую копию, а не историю коммитов.; Кодинг-агент с MCP: Claude Code (claude --version), Cursor или аналог.",
      "claim_ids": [
        "AR-GUIDE-KAKNASTROI-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "Как это сделать?",
      "answer": "Шаг 1. Установите QMD и проверьте CLI → Шаг 2. Соберите индекс и ограничьте область поиска → Шаг 3. Подключите MCP-сервер к агенту и замерьте экономию",
      "claim_ids": [
        "AR-GUIDE-KAKNASTROI-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Что может пойти не так?",
      "answer": "Ошибка: MCP error -32000: Connection closed",
      "claim_ids": [
        "AR-GUIDE-KAKNASTROI-006"
      ],
      "article_anchor": "#problems"
    }
  ],
  "limitations": [
    "Ошибка: MCP error -32000: Connection closed",
    "Причина: MCP-клиент запускает процесс в окружении без вашего PATH (типично для GUI-приложений), поэтому \"command\": \"qmd\" не находится.",
    "Решение: укажите абсолютный путь из which qmd в поле command и перезапустите агент. Проверка — /mcp показывает connected.",
    "Ошибка: qmd status печатает documents: 0 для коллекции, агент отвечает «No results found»."
  ],
  "citation": {
    "preferred_citation": "AI Release. Как настроить QMD для кодинг-агентов и сократить расход токенов на поиск файлов. https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
    "canonical_url": "https://ai-release.org/guides/kak-nastroit-qmd-dlya-koding-agentov-i-sokratit-rashod.html",
    "publisher": "AI Release"
  }
}