Подключите Context7 в тестовой копии
Откройте инструкцию Context7 для Claude Code и выполните настройку из корня тестового проекта. Если выбран удалённый сервер с OAuth, подтвердите доступ в браузере и проверьте состояние в меню /mcp. Для рабочего проекта заранее определите, должны ли коллеги видеть ту же конфигурацию. Для первого прогона достаточно пользовательской или локальной настройки без добавления секретов в репозиторий.
Попросите агента найти руководство ровно по одному пакету. Укажите название, установленную версию, задачу и требование сослаться на раздел документации. Не ориентируйтесь только на диапазон в package.json. Запись вида ^4.18.0 задаёт диапазон, а дерево установленных зависимостей показывает, что находится в конкретной копии. Если дерево ещё не установлено, посмотрите lock-файл и согласованный способ установки проекта.
Проверьте на различии Express 4 и 5
Возьмите две отдельные учебные папки с Express 4 и 5. Для начала выполните npm ls express --depth=0 в каждой. Затем задайте вопрос про маршрут на все пути. В документации миграции Express 5 у шаблона со звёздочкой есть имя параметра. Для совпадения с корневым путём отдельно проверяется вариант с фигурными скобками. Это хороший пример, где похожий синтаксис работает по-разному между основными версиями.
Определи версию Express по установленному дереву.
Найди через Context7 документацию по шаблонам маршрутов для этой версии.
Покажи пример для / и /docs/guide и ссылку на раздел.
Отметь, если доступная справка описывает другую основную версию.Вынесите маршрут в минимальный файл с одним обработчиком и запустите его на свободном порту. В тесте отправьте запросы на / и /docs/guide. Отдельно проверьте, что обычный маршрут /health возвращает ожидаемый ответ. Если шаблон проходит на /docs/guide, но даёт 404 на /, проблема может быть в области совпадения, а не в самом подключении сервера. Сохраните вывод версии и двух запросов рядом.
Что делать при расхождении справки и теста
Откройте ссылку из ответа и проверьте, относится ли она к нужной версии. Если Context7 показывает свежий раздел, а репозиторий закреплён на старой версии, найдите официальный архив или руководство миграции. Дайте агенту именно эту страницу и повторите вопрос. Если совет всё ещё вызывает ошибку, укажите точный текст исключения и минимальный маршрут. Так проще отличить расхождение версий от ошибки в конфигурации.
Официальное руководство по синтаксису маршрутов Express 5 даёт независимую сверку для этого примера. Рабочий ответ включает версию из проекта, конкретный раздел документации и результат теста. Такой порядок полезен и для других пакетов, где имена функций и значения по умолчанию меняются между выпусками.Официальная документация: шаги и условия работы инструмента.