api_designer — субагент для Claude Code: что делает и установка
Субагент api_designer для Claude Code проектирует контракты REST- и GraphQL-API по требованиям продукта или сервиса. Он включается при подготовке API-спецификации.
лицензия не указана ★ 776 обновлён 2026-11-12
.claude/agents/api_designer.mdЧто делает api_designer
api_designer превращает требования к продукту и сервису в готовый к реализации контракт API. Он описывает область действия, потребителей и ресурсы, а также запросы, ответы, ошибки и правила пагинации.
В контракт входят требования к аутентификации и авторизации, идемпотентности, лимитам запросов и версиям. Субагент добавляет примеры схем, рекомендации по жизненному циклу и критерии проверки контракта. Он отделяет обязательные требования от предложений по реализации.
Существующие контракты сохраняются, пока явно не согласовано несовместимое изменение. Контекст репозитория, модели предметной области и действующие схемы можно передать как дополнительные сведения.
Какие задачи решает
- описать методы и операции API по требованиям
- зафиксировать формат запросов, ответов и ошибок
- задать правила аутентификации и версионирования
- определить критерии проверки контракта
Примеры запросов агенту
- Спроектируй REST API по требованиям в этом проекте и подготовь контракт.
- Опиши GraphQL-операции, схемы и ошибки для сервиса.
- Составь контракт API с правилами аутентификации, пагинации и версионирования.
Как установить api_designer
Вручную: положить файлы
.claude/agents/api_designer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/api_designer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/api_designer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы об api_designer
Как установить api_designer в Claude Code?
Добавь файл субагента по пути .claude/agents/api_designer.md.
Что делает api_designer?
Он составляет Markdown-контракт REST- или GraphQL-API по требованиям и контексту сервиса. В документе описаны операции, схемы и правила взаимодействия.
Какие API может описывать api_designer?
Субагент работает с REST- и GraphQL-интерфейсами. Он может включить в контракт параметры запросов, ответы, ошибки и пагинацию.