Скрипт запуска настраивает MCP-сервер CodeGraph, LSP и плагин
opencode-codegraph для локальной копии исходников. Руководство поможет открыть сессию
OpenCode и проверить, что ответ использует нужный проект и актуальный контекст.
Подготовка
Выполняйте команды в PowerShell из корня исходного репозитория CodeGraph. Нужны Python-зависимости
CodeGraph, Node.js/npm, установленный OpenCode и доступ к выбранной модели. Сначала
импортируйте проект и проверьте актуальность CPG. Замените PROJECT
именем зарегистрированного проекта, путь после --db — путём его CPG, PROVIDER/MODEL —
доступной моделью, SYMBOL — символом проекта, а SESSION_ID — нужной сессией OpenCode.
Без --db скрипт использует data/projects/codegraph.duckdb: один --project не заменяет этот путь.
Если файл отсутствует, скрипт может попытаться перестроить CPG зарегистрированного проекта.
Скрипт готовит конфигурацию opencode.json, устанавливает пакет и при необходимости
запускает API. Интерактивный запуск сохраняет подготовленную конфигурацию для следующих
сессий. После завершения неинтерактивного запуска OpenCode скрипт восстанавливает
исходный opencode.json.
Проверьте доступные параметры без запуска сервисов:
python scripts/run_opencode_codegraph.py --help
Интерактивная сессия
python scripts/run_opencode_codegraph.py --project 'PROJECT' --db 'data/projects/PROJECT.duckdb'
Модель скрипта запуска по умолчанию — openai/gpt-5.4. Чтобы выбрать другую доступную
в вашем OpenCode модель, передайте её идентификатор через --model.
Переменная CODEGRAPH_OPENCODE_MODEL задаёт модель по умолчанию; --model выбирает её для отдельного запуска:
python scripts/run_opencode_codegraph.py --project 'PROJECT' --db 'data/projects/PROJECT.duckdb' --model 'PROVIDER/MODEL'
Выберите модель для настроенного аккаунта и отправьте первый запрос в OpenCode.
Проверьте, что клиент получил ответ модели. Если провайдер вернул model is not supported,
выберите поддерживаемый вашим аккаунтом идентификатор и повторите запуск с --model.
Проверьте результат запроса, даже если команда завершилась с кодом 0.
Версия пакета в исходниках — opencode-codegraph 0.1.38. Для установки из npm
скрипт задаёт диапазон ^0.1.38 по манифесту пакета. Реестр npm должен содержать
версию, соответствующую этому диапазону.
Поддерживаемые команды CodeGraph
Текущий каталог .opencode/commands содержит:
/audit— аудит ограниченной области;/continue— продолжение явной сессии CodeGraph;/explain— объяснение кода со ссылками на данные проекта;/next— проверка состояния и выбор следующего разрешённого действия;/onboard— изучение текущего репозитория и контекста проекта;/review— ревью ограниченного изменения;/status— состояние сессии и контекста;/update— повторная проверка готовности контекста; обновление только по разрешённому действию сервера.
Команда /status запрашивает состояние проекта и синхронизации контекста, затем показывает свежесть данных и следующий шаг. Команда /review начинает с проверки проекта и сессии, читает изменения и формирует заключение со ссылками на использованные данные.
Неинтерактивный запуск
Для одного неинтерактивного запроса:
python scripts/run_opencode_codegraph.py `
--project 'PROJECT' --db 'data/projects/PROJECT.duckdb' `
--run "Explain the impact of changing SYMBOL and cite source locations"
Используйте --session 'SESSION_ID' или --continue-last только для нужной сессии. Проверьте имя
проекта в ответе и сохраните предупреждения об устаревших данных или ухудшенном режиме.
При OpenCode 1.2.27 или неизвестной версии скрипт отключает регистрацию плагина и LSP
для неинтерактивного запуска. Для проверки хуков откройте интерактивную сессию и выполните шаги из справочника плагина.
Проверка и восстановление
- Убедитесь, что скрипт показывает ожидаемый проект и адрес API.
- До первой задачи выполните
/status. - Если MCP недоступен, проверьте состояние сервисов CodeGraph и имя зарегистрированного проекта в конфигурации подключения.
- При устаревшем плагине повторите скрипт запуска без
--no-plugin-install. - При устаревших данных обновите проект до принятия ответа.
Откройте указанные в ответе участки кода и сопоставьте их с проверяемой ревизией проекта. Сохраните вывод рецензента вместе с результатом анализа.
Для отдельного подключения редактора настройте opencode.json по руководству LSP: оно описывает путь к CPG, транспорт и проверку диагностики.
Справочные материалы
Параметры CLI описаны в руководстве, а проверки соединения — в диагностике.