Параметры клиентов¶
Используйте один Nexus API-ключ. В каждом клиенте добавьте отдельную запись
подключения, чтобы штатное подключение клиента осталось на месте. Id модели
копируйте из GET /v1/models. Семейство маршрута проверьте на странице
Модели и цены, прежде чем рассчитывать на инструменты,
изображения или длинное окно контекста.
| Клиент | Протокол | Базовый URL | Поле ключа | Инструкция |
|---|---|---|---|---|
| Codex CLI | OpenAI Responses | https://api.nexus-hub.tech/v1 |
NEXUS_API_KEY |
Codex |
| ChatGPT / Codex Desktop | OpenAI Responses | https://api.nexus-hub.tech/v1 |
NEXUS_API_KEY |
Codex Desktop |
| Claude Code | Anthropic Messages | https://api.nexus-hub.tech |
ANTHROPIC_AUTH_TOKEN или ANTHROPIC_API_KEY |
Claude Code |
| Claude Desktop | Anthropic Messages | https://api.nexus-hub.tech |
поле ключа Gateway, Bearer или x-api-key |
Claude Desktop |
| VS Code | Responses, Chat Completions или Messages | /v1 для OpenAI, без /v1 для Messages |
input variable | VS Code |
| Zed | OpenAI-compatible или Anthropic-compatible | /v1 для OpenAI, без /v1 для Anthropic |
keychain или переменная окружения | Zed |
| T3 Code | отдельный профиль Codex или Claude Code | зависит от профиля | API-ключ или переменная окружения | T3 Code |
| CC Switch | отдельная запись Codex или Claude Code | зависит от записи | защищённое поле | CC Switch |
| Cherry Studio | OpenAI Chat, Responses, Messages или Gemini | корень или /v1, как в предпросмотре запроса |
поле API-ключа | Cherry Studio |
| Direct API / cURL | OpenAI, Anthropic или Gemini | зависит от протокола | заголовок авторизации | Direct API |
| Собственная интеграция | OpenAI, Anthropic или Gemini | зависит от протокола | хранилище секретов или переменная окружения | Собственная интеграция |
| Другой клиент | custom endpoint | зависит от протокола | защищённое поле клиента | Другой клиент |
Выбор URL¶
- OpenAI Chat и Responses:
https://api.nexus-hub.tech/v1. - Anthropic Messages:
https://api.nexus-hub.tech. - Gemini-compatible:
https://api.nexus-hub.tech/v1beta.
Указывайте базовый URL, а не полный маршрут операции. Клиент Responses сам
добавляет /responses, Anthropic-клиент — /v1/messages, чат-клиент —
/chat/completions.
ANTHROPIC_AUTH_TOKEN уходит как Authorization: Bearer. ANTHROPIC_API_KEY
уходит как x-api-key. Nexus принимает оба варианта. В одной записи используйте
один из них.
Идемпотентность и повторы в клиентах¶
Официальные библиотеки OpenAI и Anthropic умеют передавать Idempotency-Key
через extra_headers. Тот же ключ и то же тело защищают повтор после обрыва
связи от второго списания. Матрица и примеры — в руководстве
Повторы и идемпотентность.