OpenCode

Настройте OpenCode для вызова моделей через TokenHub.

OpenCode может вызывать модели TokenHub через интерфейс OpenAI compatible. Используйте официальный способ установки, затем замените только API key, Base URL и model ID.

Endpoint TokenHub для этого руководства: https://us-api.tokenhub.com/v1/chat/completions.

Когда использовать

Начните с небольшого репозитория или тестового проекта. Сначала попросите инструмент читать файлы, объяснять код или составлять план, затем включайте правки.

Установите или откройте инструмент

Следуйте официальной документации OpenCode для установки или запуска. Если интерфейс изменился, ориентируйтесь на актуальную документацию.

Для CLI-инструментов сначала убедитесь, что исполняемый файл доступен, и только потом добавляйте учетные данные TokenHub:

opencode --version

Подготовьте учетные данные TokenHub

Создайте TokenHub API key и выберите подходящую модель в списке моделей TokenHub.

export TOKENHUB_API_KEY="sk-..."

Храните ключ в локальном shell, секретном хранилище IDE или защищенном поле API key инструмента. Не коммитьте ключ в репозиторий.

Настройте провайдера TokenHub

В настройках Models, Providers, API Keys или OpenAI Compatible укажите следующие значения.

Значения provider

Поле	Значение
Провайдер	OpenAI Compatible или Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	Значение `TOKENHUB_API_KEY`
Модель	`gpt-4.1` или другой model ID TokenHub

Расположение настроек

Поле	Значение
User config	`~/.config/opencode/opencode.json`
Project config	`opencode.json`
Interactive setup	Run `/connect` and select the TokenHub provider

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "tokenhub": {
      "name": "TokenHub",
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "__API_BASE_URL__/v1",
        "apiKey": "{env:TOKENHUB_API_KEY}"
      },
      "models": {
        "gpt-4.1": {
          "name": "gpt-4.1"
        }
      }
    }
  },
  "model": "tokenhub/gpt-4.1"
}

Confirm OpenCode can read the provider and start with the TokenHub provider prefix:

opencode models tokenhub
opencode --model tokenhub/gpt-4.1

Если установленная версия записывает немного другую schema, сначала используйте интерактивную настройку, затем сохраните те же значения TokenHub: Base URL, API key и model ID.

Если инструмент разделяет chat, edit, apply и fast models, для первого теста используйте одну и ту же модель TokenHub. После проверки разделите их по стоимости, задержке и силе рассуждения.

Временные переменные только для диагностики

Используйте временные переменные только для проверки ключа, сети и имени модели. После проверки перенесите те же значения в постоянную конфигурацию выше.

export TOKENHUB_API_KEY="sk-..."

Проверьте подключение

Сначала используйте read-only prompt, чтобы убедиться, что модель читает контекст и не меняет файлы. Потом проверяйте редактирование и agent tasks.

Прочитай README проекта и кратко опиши его в трех предложениях. Не изменяй файлы.

После успешного prompt проверьте в логах TokenHub имя модели, endpoint, расход tokens и billing group.

Устранение неполадок

Симптом	Что сделать
401 или ошибка аутентификации	Проверьте, что `TOKENHUB_API_KEY` действителен и сохранен в том же terminal, IDE или профиле клиента.
404 или модель не найдена	Используйте model ID, который есть в рабочей области TokenHub и подходит выбранному протоколу.
Неверный endpoint	Оставьте Base URL точно как указано выше. OpenAI-compatible tools обычно требуют `/v1`; Claude-compatible tools обычно нет.
Таймаут запроса	Проверьте сеть до `https://us-api.tokenhub.com`, proxy settings и allowlist рабочей области.
Инструмент использует другую модель	Проверьте все поля chat, edit, apply, fast и autocomplete.

На этой странице