neon-expert — субагент для Claude Code: Neon и установка
Консультирует по Neon Serverless Postgres: помогает с настройкой, подключениями, ветками и масштабированием, а сложные задачи передаёт профильным субагентам.
npx claude-code-templates@latest --agent database/neon-expertЧто делает neon-expert
Субагент разбирает вопросы по Neon: настройку проекта, CLI и Management API, пулинг соединений, ветвление базы и автомасштабирование. Для простых задач предлагает конкретные команды и примеры запросов. Сложную работу со схемами и ORM направляет neon-database-architect, настройку авторизации — neon-auth-specialist, диагностику медленных запросов — neon-optimization-analyzer.
Он различает прямое и пуловое подключения. В режиме транзакций пулер не поддерживает SET на уровне сессии, LISTEN/NOTIFY и SQL-команды PREPARE/DEALLOCATE; если проект от них зависит, потребуется прямое подключение. В серверлесс-обработчике соединение следует создавать и закрывать внутри одного запроса.
Установка для Claude Code выполняется командой npx claude-code-templates@latest --agent database/neon-expert; файл агента находится по пути .claude/agents/neon-expert.md. Субагент использует Read, Bash и Grep, а не MCP-инструменты, поэтому для действий с Neon он обращается к CLI.
Какие задачи решает
- настроить подключение приложения к Neon
- выбрать прямое или пуловое соединение
- создать ветку базы для тестирования
- разобраться с автомасштабированием Neon
- передать проектирование схемы профильному субагенту
Примеры запросов агенту
- Настрой подключение приложения к Neon и покажи проверочный запрос.
- Объясни, когда проекту нужно прямое подключение, а когда пулер.
- Подскажи, как создать тестовую ветку Neon и получить строку подключения.
Как установить neon-expert
1Через claude-code-templates
npx claude-code-templates@latest --agent database/neon-expert2Вручную: положить файлы
.claude/agents/neon-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/neon-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/neon-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о neon-expert
Как установить neon-expert в Claude Code?
Выполните npx claude-code-templates@latest --agent database/neon-expert. Файл агента находится в .claude/agents/neon-expert.md.
Что делает neon-expert?
Он помогает с настройкой Neon Serverless Postgres, CLI и API, соединениями, ветками и масштабированием. Задачи по схемам, авторизации и медленным запросам передаёт специализированным субагентам.
Какие ограничения есть у пулового подключения Neon?
Пулер работает в режиме транзакций, где недоступны сессионный SET, LISTEN/NOTIFY и SQL-команды PREPARE/DEALLOCATE. Для таких операций нужен прямой адрес подключения или API подготовленных запросов драйвера.
