---
title: "opencode: свой OpenAI-совместимый провайдер, настройка"
description: "Как добавить BroadNet Inference в агента для программирования opencode как свой OpenAI-совместимый провайдер в opencode.jsonc: алиасы моделей, возможности и лимиты."
url: https://broadrouter.com/ru/guides/opencode-custom-provider/
lang: ru
updated: 2026-11-16
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Переведено с английского с помощью ИИ. [Читать оригинал на английском](https://broadrouter.com/guides/opencode-custom-provider/) (обновлён 2026-11-16).

# BroadNet Inference в opencode: свой провайдер

Обновлено 2026-11-16

В opencode.jsonc добавьте в providers запись broadnet с package @opencode/ai/providers/openai-compatible, settings.baseURL равным https://inference.broadnet.ai/v1 и env равным BROADNET\_API\_KEY. Сопоставьте короткие ключи моделей с ID BroadNet через modelID, например broadnet/glm-5.3, и выберите модель командой /models. Старые конфиги V1 с npm @ai-sdk/openai-compatible и options.baseURL тоже работают.

opencode — агент для программирования в терминале с открытым исходным кодом. Провайдеры, которых нет в его встроенном каталоге, добавляются как **custom providers** (свои провайдеры) в `opencode.jsonc`. BroadNet Inference работает в формате OpenAI chat completions, поэтому использует OpenAI-совместимый пакет среды выполнения opencode. Руководство следует актуальной документации opencode (V2).

## Настройка

1.  **Экспортируйте ключ** в той оболочке, из которой запускаете opencode:

```bash
export BROADNET_API_KEY='your-broadnet-key'
```

2.  **Создайте конфиг.** Положите его в проект как `opencode.jsonc` или в `~/.config/opencode/opencode.jsonc`, чтобы он действовал везде. Комментарий в конфиге напоминает, что документация BroadNet не заявляет вызов инструментов для DeepSeek V4.1 Flash, поэтому это нужно сначала проверить.

```jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "model": "broadnet/glm-5.3",
  "providers": {
    "broadnet": {
      "name": "BroadNet Inference",
      "env": ["BROADNET_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://inference.broadnet.ai/v1"
      },
      "models": {
        "glm-5.3": {
          "modelID": "broadnet/glm-5.3",
          "name": "GLM 5.3",
          "capabilities": { "tools": true, "input": ["text"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "deepseek-v4.1-flash": {
          "modelID": "broadnet/deepseek-v4.1-flash",
          "name": "DeepSeek V4.1 Flash",
          // BroadNet's docs don't list tool calling for this model: test it first
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 1048576, "output": 16000 }
        },
        "qwen3.8-27b": {
          "modelID": "broadnet/qwen3.8-27b",
          "name": "Qwen3.8 27B",
          "capabilities": { "tools": true, "input": ["text", "image"], "output": ["text"] },
          "limit": { "context": 262144, "output": 16000 }
        }
      }
    }
  }
}
```

3.  **Запустите opencode и выберите модель** командой `/models`. Ссылка на модель имеет вид `broadnet/<ключ в карте>`, например `broadnet/glm-5.3`. В BroadNet opencode отправляет значение `modelID`.

Файлы конфигурации объединяются. opencode применяет сначала глобальный файл, затем файлы проекта, найденные от текущего каталога вверх (сначала самые дальние), затем конфиг из `.opencode/`, так что файл проекта может переопределить глобальный провайдер. Управляемый системный конфиг, если его использует ваша компания, переопределяет и то и другое. Храните ключ в окружении, а не в файле, тогда конфиг можно класть в систему контроля версий.

## Зачем алиасы

ID BroadNet уже содержат слеш (`broadnet/glm-5.3`). Ключ в карте `models` — это то, что opencode показывает и выбирает, а `modelID` — то, что он отправляет. Короткие ключи делают ссылки читаемыми.

Задайте `capabilities` и `limit` сами. Для модели вне своего каталога opencode предполагает поддержку инструментов в JSON, ввод текста и изображений, контекст 200 000 токенов и 32 000 токенов на выходе. Его документация называет это резервными предположениями, а не определёнными значениями. Значение `output` 16000 выше — наше предложение, а не лимит BroadNet; оно оставляет место для рассуждений.

### Старые конфиги V1

opencode V2 по-прежнему читает формат V1, так что существующий блок вроде этого продолжит работать:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "broadnet": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BroadNet Inference",
      "options": {
        "baseURL": "https://inference.broadnet.ai/v1",
        "apiKey": "{env:BROADNET_API_KEY}"
      },
      "models": {
        "broadnet/glm-5.3": { "name": "GLM 5.3" }
      }
    }
  }
}
```

В нативном формате V2 `provider` превращается в `providers`, `npm` — в `package` (`aisdk:@ai-sdk/openai-compatible`, если хотите оставить пакет AI SDK), а `options.baseURL` и `options.apiKey` переезжают в `settings`. [Руководство opencode по миграции с V1](https://opencode.ai/docs/migrate-v1/) сопоставляет каждое поле.

## Какую модель выбрать

| Задача | Модель | Примечания |
| --- | --- | --- |
| Агентное программирование с инструментами | [GLM 5.3](https://broadrouter.com/ru/models/glm-5.3/) | Заявлены инструменты и структурированный вывод; контекст 1 млн |
| Скриншоты, арабский | [Qwen3.8 27B](https://broadrouter.com/ru/models/qwen3.8-27b/) | Инструменты и изображения; контекст 262K |
| Сессии на весь день по фиксированной цене | [DeepSeek V4.1 Flash](https://broadrouter.com/ru/models/deepseek-v4.1-flash/) | Безлимитные тарифы; инструменты у BroadNet не заявлены |

opencode опирается на вызовы инструментов. Документация BroadNet не заявляет вызов инструментов для DeepSeek V4.1 Flash, поэтому в конфиге это помечено как предположение, которое нужно проверить. Прогоните реальную задачу на часе Meteor ($1), прежде чем покупать месяц Full Moon ($60).

## Решение проблем

-   **401.** Ключ в `BROADNET_API_KEY` неверен, истёк или исчерпан лимит оплаты по факту. Убедитесь, что переменная задана в процессе, который запускает opencode.
-   **Модель не найдена или отклонена.** Выбирайте ключ в карте (`broadnet/glm-5.3`) и проверьте, что `modelID` точно совпадает с ID BroadNet. Ссылки чувствительны к регистру. Для платных моделей нужно пополнить баланс; грант $5 покрывает только `broadnet/gemma-4-26b-a4b`.
-   **Пустые ответы.** Увеличьте `limit.output`. [Почему ответы приходят пустыми](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/).
-   **429.** Ключи с оплатой по факту допускают 30 запросов в минуту и 4 одновременно. Повторы тоже считаются. См. [ошибки и повторные запросы](https://broadrouter.com/ru/guides/errors-and-retries/).
-   **Субагенты на тарифе.** Каждая [сессия тарифа](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/) обрабатывает один запрос за раз, поэтому параллельные субагенты встают в очередь, если у каждого нет своей сессии.

## Термины в этом руководстве

[Контекстное окно (context window)](https://broadrouter.com/ru/glossary/context-window/)

Контекстное окно — это максимальное число токенов, с которым языковая модель может работать в одном запросе. В него входят промпт, история диалога, описания инструментов, изображения и сгенерированный ответ, включая токены рассуждений. Всё, что не помещается, приходится обрезать, сжимать в краткое изложение или делить на несколько запросов.

[Вызов инструментов (tool calling)](https://broadrouter.com/ru/glossary/tool-calling/)

Вызов инструментов (function calling) — это функция LLM API, при которой модель возвращает структурированный запрос на выполнение функции, заданной разработчиком, с аргументами в JSON. Приложение выполняет функцию и отправляет результат обратно; сама модель код никогда не выполняет.

[ИИ-агент для программирования (AI coding agent)](https://broadrouter.com/ru/glossary/coding-agent/)

ИИ-агент для программирования — это инструмент, в котором языковая модель работает с кодовой базой в цикле: читает файлы, правит их, запускает команды, например тесты, читает вывод и решает, каким будет следующий шаг, пока задача не выполнена или не достигнут лимит.

[Лимит запросов (rate limit)](https://broadrouter.com/ru/glossary/rate-limit/)

Лимит запросов (rate limit) — это ограничение, которое API накладывает на объём использования клиентом за отрезок времени, например число запросов или токенов в минуту. Запросы сверх лимита отклоняются, обычно с HTTP 429 Too Many Requests, пока использование снова не опустится ниже порога.

[Оплата по факту (pay-as-you-go)](https://broadrouter.com/ru/glossary/pay-as-you-go/)

Оплата по факту (pay-as-you-go) — это модель ценообразования, при которой вы платите только за то, что использовали, по счётчику в единицах вроде токенов, запросов или минут аудио, без подписки и минимальных обязательств. Так тарифицирует большинство LLM API — с предоплаченного баланса или по периодическому счёту.

[Параллельность (concurrency)](https://broadrouter.com/ru/glossary/concurrency/)

Параллельность (concurrency) — это число запросов, которые клиент одновременно держит в работе. LLM API часто ограничивают её на ключ или тариф отдельно от лимита запросов в минуту, потому что каждый открытый запрос занимает мощности GPU, пока ответ не будет готов.

[ИИ-агент (AI agent)](https://broadrouter.com/ru/glossary/agent/)

ИИ-агент — это система, в которой языковая модель сама направляет свои шаги к цели: решает, какие инструменты вызвать, читает результаты и повторяет, пока не выдаст итоговый ответ или не упрётся в лимит. Фиксированный сценарий, который вызывает модель в заранее заданных местах, обычно называют не агентом, а workflow.

[Chat Completions API](https://broadrouter.com/ru/glossary/chat-completions-api/)

Chat Completions API — это HTTP-эндпоинт OpenAI, POST /v1/chat/completions, который принимает имя модели и список сообщений с ролями и возвращает следующее сообщение модели. Формат его запроса и ответа стал общим стандартом, который повторяют OpenAI-совместимые провайдеры и SDK.

## Вопросы и ответы

### Почему opencode не находит мою модель BroadNet?

opencode ищет модель по ссылке вида провайдер/ключ в карте моделей, и ID чувствительны к регистру. С конфигом ниже выбирайте broadnet/glm-5.3, где glm-5.3 — ключ в карте. Значение modelID — только то, что отправляется в BroadNet.

### В моём конфиге provider и npm с @ai-sdk/openai-compatible. Это ошибка?

Нет. Это формат V1, и руководство opencode по миграции говорит, что он по-прежнему поддерживается. В нативном формате V2 provider переименован в providers, npm — в package (aisdk:@ai-sdk/openai-compatible), а options.baseURL — в settings.baseURL.

### Почему opencode возвращает пустые ответы?

Модель потратила бюджет на выход на рассуждения. Увеличьте limit.output для модели. В BroadNet рассуждения учитываются в max\_tokens.

## Похожие руководства

-   [Cline и BroadNet Inference: провайдер OpenAI Compatible](https://broadrouter.com/ru/guides/cline-openai-compatible/)
-   [Как устроены безлимитные тарифы LLM API для агентов](https://broadrouter.com/ru/guides/unlimited-llm-api-sessions/)
-   [Почему рассуждающая модель возвращает пустой ответ](https://broadrouter.com/ru/guides/reasoning-tokens-empty-response/)
-   [Vercel AI SDK и BroadNet Inference: OpenAI-совместимый провайдер](https://broadrouter.com/ru/guides/vercel-ai-sdk-openai-compatible/)
-   [Все инструменты, которые работают с BroadNet Inference (на английском)](https://broadrouter.com/integrations/): SDK, агенты для программирования, чат-интерфейсы и инструменты автоматизации с точными настройками для каждого

Проверьте на своей реальной нагрузке. Новые аккаунты получают стартовый грант US$5 на Gemma и распознавание речи. Для DeepSeek, GLM и Qwen3.8 нужно пополнить баланс.

[Начать](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-opencode-custom-provider&utm_content=page-cta) ·

**Источники**

-   [Документация opencode, Providers (свой провайдер) (дата обращения 2026-11-14)](https://opencode.ai/docs/providers/)
-   [Документация opencode, Models (алиасы, возможности, лимиты) (дата обращения 2026-11-14)](https://opencode.ai/docs/models/)
-   [Документация opencode, расположение конфигов (дата обращения 2026-11-14)](https://opencode.ai/docs/config/)
-   [Документация opencode, миграция с V1 (дата обращения 2026-11-14)](https://opencode.ai/docs/migrate-v1/)
-   [Справочник API BroadNet Inference (на английском)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ru-guides-opencode-custom-provider&utm_content=sources)
