Интеграция с Claude Code
Claude Code — официальный CLI и расширение VS Code для Claude от Anthropic. Это руководство описывает интеграцию Moira с Claude Code.
Предварительные требования
- Установленный и настроенный Claude Code
- Доступ к серверу Moira (облако или self-hosted)
- Действующие учетные данные Moira
Конфигурация
Используйте Claude Code в MCP-клиентах: там находятся генерируемая настройка, её область действия, текущие способы авторизации и официальная инструкция поставщика. Сначала проверьте существующее подключение; если нужен вход, используйте его OAuth или родную альтернативу с API-токеном. Сохраните другие серверы и не копируйте учётные данные в инструкции проекта.
Проверка подключения
Проверьте подключение, попросив Claude:
Покажи доступные воркфлоу MoiraВы должны увидеть список ваших воркфлоу.
Использование Moira в Claude Code
Запуск воркфлоу
Найди актуальный workflow разработки в Moira и запусти его для этой задачиClaude:
- Вызовет
executionсaction: "prepare"и ID воркфлоу - Вызовет
executionсaction: "execute"и полученным Start attempt ID - Получит Process ID, Step attempt ID и директиву первого шага
- Выполнит директиву
- Отправит результаты через
execution(step) - Продолжит до завершения воркфлоу
Продолжение сессии
Если сессия была прервана, продолжите с:
Продолжи мой воркфлоу Moira с process ID abc-123Получение помощи
Покажи документацию Moira по узламClaude вызовет help с темой.
Интеграция с CLAUDE.md
Для воркфлоу, специфичных для проекта, добавьте в CLAUDE.md:
## Воркфлоу Moira
Этот проект использует Moira для воркфлоу разработки.
### Доступные воркфлоу
- `dev-flow` - Основной воркфлоу разработки- `review-flow` - Воркфлоу код-ревью
### Начало разработки
Чтобы начать задачу, запустите воркфлоу разработки:
1. Подготовьте и выполните запуск воркфлоу `dev-flow`2. Следуйте каждой директиве шага3. Отправьте результаты перед переходом к следующему шагуОбщие правила выбора workflow храните в CLAUDE.md. Активный Process ID сохраняйте в игнорируемом рабочем пространстве или handoff задачи, чтобы временное состояние запуска не стало постоянной инструкцией проекта.
Доступные инструменты
Основной цикл workflow использует следующие инструменты:
| Инструмент | Описание |
|---|---|
workflow (list) | Список доступных воркфлоу |
execution (prepare, execute) | Подготовка или выполнение защищённого от повторов запуска |
execution (step) | Отправка результата, получение следующей директивы |
help | Получение документации |
settings | Управление пользовательскими настройками |
execution | Информация о сессии и выполнениях |
Полный актуальный каталог, входные схемы, действия и примеры находятся в справочнике MCP-инструментов.
Устранение неполадок
Проблемы с подключением
- Проверьте правильность URL MCP сервера
- Проверьте сетевое подключение
- Убедитесь в действительности аутентификации
- Проверьте логи Claude Code на наличие ошибок
Воркфлоу не запускается
- Проверьте существование ID воркфлоу:
workflowсaction: "list" - Проверьте права доступа к воркфлоу
- Убедитесь, что у вас есть доступ к воркфлоу
Потеря сессии
Если process ID потерян:
- Проверьте
execution({ action: "executions" })для активных выполнений - Возобновите с правильным process ID
- Сохраните выбранный Process ID в игнорируемом workspace/handoff задачи
Лучшие практики
- Сохраняйте Process ID — Храните в игнорируемом workspace/handoff задачи
- Следуйте директивам — Выполняйте именно то, что говорит директива
- Выполняйте условия завершения — Проверяйте перед отправкой
- Проверяйте помощь — Используйте
helpпри неуверенности
Связанное
- Быстрый старт — Общее руководство по настройке
- MCP клиенты — Другие интеграции клиентов