Настройка клиентов¶
Все клиенты используют один Nexus-ключ и каталог моделей именно этого ключа. Базовый URL зависит от протокола:
| Сценарий | Протокол | Базовый URL | Первый маршрут |
|---|---|---|---|
| Codex и response-клиенты | OpenAI Responses | https://api.nexus-hub.ru/v1 |
POST /v1/responses |
| Claude Code | Anthropic Messages | https://api.nexus-hub.ru |
POST /v1/messages |
| Универсальные OpenAI-клиенты | OpenAI Chat | https://api.nexus-hub.ru/v1 |
POST /v1/chat/completions |
| Gemini-клиенты | Gemini-compatible | https://api.nexus-hub.ru/v1beta |
POST /v1beta/models/{model}:generateContent |
Общий порядок настройки¶
- Создайте Nexus API-ключ в Telegram-боте.
- Выберите в клиенте отдельный профиль или custom endpoint.
- Укажите протокол и базовый URL из таблицы выше.
- Передайте ключ через защищённое поле клиента или переменную окружения.
- Выберите модель из
GET /v1/models.
Выберите протокол¶
Подходит для Codex и response-клиентов. Укажите базовый URL
https://api.nexus-hub.ru/v1 и начните с POST /v1/responses.
Подходит для Claude-совместимых клиентов. Оставьте базовый URL
https://api.nexus-hub.ru и передавайте POST /v1/messages с заголовком
anthropic-version: 2023-06-01.
Используйте https://api.nexus-hub.ru/v1beta только там, где клиент
документирует Gemini-совместимый формат. Модель указывается в пути запроса.
Перед диагностикой
Ещё раз проверьте маршрут, видимость модели для ключа и точное поле в
клиенте. В поддержку передавайте только маршрут, код ошибки, примерное
время и x-request-id; не отправляйте ключ, полный prompt или заголовки.
Перед настройкой сверяйтесь с параметрами клиентов. Отдельные инструкции есть для Codex CLI, ChatGPT / Codex Desktop, Claude Code, Claude Desktop, VS Code, Zed, T3 Code, CC Switch, прямого API, собственной интеграции и другого клиента.