api-architect — субагент для Claude Code: API и установка
Проектирует REST- и GraphQL-API и готовит код для связи сервисов. Вызывайте его, когда нужно выбрать стиль API или продумать устойчивость и защиту.
npx claude-code-templates@latest --agent api-graphql/api-architectЧто делает api-architect
Субагент помогает спроектировать GraphQL-схему и структуру резолверов, подготовить REST-клиент или сравнить REST, GraphQL и gRPC. Для GraphQL учитывает федерацию, пакетную загрузку данных и ограничения сложности запросов; для REST — слои сервиса и обработки отказов, повторы и идемпотентность. Он работает с инструментами чтения и редактирования файлов, а также Bash.
Перед генерацией кода он собирает исходные требования: для REST нужны базовый адрес API и хотя бы один метод, для GraphQL — подход к схеме и тип операций. Обязательно задать язык с фреймворком, тип API и способ аутентификации. Сначала нужно явно сказать «generate» — до этого субагент не начинает писать код.
Какие задачи решает
- спроектировать GraphQL-схему с федерацией
- создать REST-клиент с повторами и защитой от сбоев
- сравнить REST, GraphQL и gRPC для нового сервиса
- задать аутентификацию и ограничение запросов к API
Примеры запросов агенту
- Спроектируй GraphQL API для каталога товаров с поиском, категориями и остатками; сначала собери требования.
- Подготовь REST-клиент для платёжного сервиса на TypeScript с повторными запросами; дождись моих ответов и команды «generate».
- Сравни REST, GraphQL и gRPC для системы уведомлений в реальном времени и порекомендуй вариант.
Как установить api-architect
1Через claude-code-templates
npx claude-code-templates@latest --agent api-graphql/api-architect2Вручную: положить файлы
.claude/agents/api-architect.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/api-architect.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/api-architect.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о api-architect
Как установить api-architect в Claude Code?
Запустите npx claude-code-templates@latest --agent api-graphql/api-architect, затем используйте файл .claude/agents/api-architect.md.
Что делает api-architect?
Он помогает проектировать REST- и GraphQL-API, создавать клиентский код и выбирать стиль API. Перед генерацией собирает требования.
Что нужно указать перед генерацией API?
Обязательно задайте язык и фреймворк, тип API и схему аутентификации. Для REST также нужны базовый URL и хотя бы один HTTP-метод, а для GraphQL — способ проектирования схемы и хотя бы один тип операции.
