# neon-ai-gateway

Скилл подключает вызовы LLM и эмбеддингов через Neon AI Gateway: одна учётная запись Neon вместо ключей OpenAI, Anthropic и Google.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 27700 установок · ★ 106
- Автор: neondatabase
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/neondatabase/agent-skills/tree/HEAD/skills/neon-ai-gateway/SKILL.md
- Обновлён: 2026-10-26
- HTML: https://affpapa.org/nevibecode/skills/neon-ai-gateway

## Что делает

Скилл объясняет агенту, как провести запросы к моделям через шлюз Neon AI Gateway, работающий на инфраструктуре Databricks. Каталог моделей общий для Anthropic, OpenAI, Google, Meta и других провайдеров, обращение идёт по идентификатору из каталога. Существующие SDK — OpenAI, Anthropic, google-genai, Vercel AI SDK и Mastra — продолжают работать: меняется только базовый URL.

Внутри — инструкция по включению шлюза в `neon.ts` через `aiGateway: true` и деплою командой `neon deploy`, которая провизионит шлюз на привязанной ветке. Каждая ветка получает свой хост шлюза, поэтому запросы из preview-ветки не смешиваются с остальными. Стриминг по SSE поддерживается без дополнительной настройки.

Шлюз доступен только в регионах `aws-us-east-2`, `aws-us-east-1`, `aws-eu-central-1` и `aws-ap-southeast-1`, и лишь на платных планах Neon — на Free команды `neon config apply`, `deploy` и `neon checkout` откажутся его включать. Часть моделей может быть помечена `enabled: false`, пока на счету нет кредитов. Скилл опирается на родительский скилл `neon`: без него придётся сначала поставить `neon` командой `neon skills -s neon -y`.

## Требования
- Работает с: Databricks

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add neondatabase/agent-skills --skill neon-ai-gateway -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/neon-ai-gateway/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/neon-ai-gateway/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add neondatabase/agent-skills --skill neon-ai-gateway -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/neon-ai-gateway/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add neondatabase/agent-skills --skill neon-ai-gateway -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/neon-ai-gateway/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install neondatabase/agent-skills neon-ai-gateway
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/neon-ai-gateway/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add neondatabase/agent-skills --skill neon-ai-gateway -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/neondatabase/agent-skills --path skills/neon-ai-gateway
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/neon-ai-gateway/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add neondatabase/agent-skills --skill neon-ai-gateway -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/neondatabase/agent-skills/tree/HEAD/skills/neon-ai-gateway/SKILL.md

## Когда брать
- вызвать LLM из приложения без отдельных ключей каждого провайдера
- сгенерировать эмбеддинги для семантического поиска
- переключиться с Claude на GPT или Gemini, поменяв одно поле `model`
- изолировать ИИ-запросы preview-ветки от продакшена
- подключить агента на Mastra или Vercel AI SDK к единому эндпоинту

## Примеры запросов агенту
- Подключи Neon AI Gateway к проекту и вызови `claude-sonnet-4-6` через Anthropic SDK
- Сгенерируй эмбеддинги для таблицы документов через шлюз Neon
- Переведи агента на Mastra с прямых ключей Anthropic на Neon AI Gateway

## Похожие
- [databricks-ai-functions](https://affpapa.org/nevibecode/skills/databricks-ai-functions.md) — скилл · 306 установок
- [sql-queries](https://affpapa.org/nevibecode/skills/sql-queries.md) — скилл · 4500 установок
- [databricks-dbsql](https://affpapa.org/nevibecode/skills/databricks-dbsql.md) — скилл · 364 установки
- [migrating-dbt-project-across-platforms](https://affpapa.org/nevibecode/skills/migrating-dbt-project-across-platforms.md) — скилл · 526 установок
- [neon-database-architect](https://affpapa.org/nevibecode/agents/neon-database-architect.md) — субагент · 478 установок
- [redis-semantic-cache](https://affpapa.org/nevibecode/skills/redis-semantic-cache.md) — скилл · 1900 установок

Из того же набора: [neondatabase/agent-skills](https://affpapa.org/nevibecode/by/neondatabase/agent-skills.md) — 9 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md