Настройка OpenCode
OpenCode — это ИИ-агент для программирования с открытым исходным кодом, доступный как терминальный TUI, десктопное приложение и расширения для IDE. Ofox встроен в каталог провайдеров OpenCode (данные из models.dev ), поэтому настраивать собственный Base URL не нужно — выберите Ofox, вставьте API-ключ, и вы сможете работать с GPT, Claude, Gemini, DeepSeek и другими моделями.
Предварительные требования
- Аккаунт OfoxAI и API-ключ (получить здесь )
- Установленный OpenCode:
# Выберите один вариант
curl -fsSL https://opencode.ai/install | bash
npm i -g opencode-ai@latest
brew install anomalyco/tap/opencodeДесктопное приложение доступно на странице opencode.ai/download .
Способ 1: Десктопное приложение
1. Откройте настройки провайдеров
Откройте OpenCode, нажмите Settings → Providers (Настройки → Провайдеры) в левой боковой панели, затем нажмите Show more providers (Показать больше провайдеров) внизу списка «Popular providers» (Популярные провайдеры).

2. Найдите и выберите Ofox
Введите ofox в поле поиска и нажмите Ofox.

3. Введите API-ключ
Вставьте свой API-ключ OfoxAI и нажмите Continue (Продолжить). После подключения Ofox появится в разделе «Connected providers» (Подключённые провайдеры).


4. Включите модели Ofox
Перейдите в Settings → Models (Настройки → Модели), найдите ofox и включите нужные модели переключателями. В селекторе моделей сессии отображаются только включённые модели.

5. Выберите модель и начните диалог
Создайте новую сессию, откройте селектор моделей под полем ввода и выберите модель в группе Ofox. Кнопка Manage models (Управление моделями) внизу в любой момент вернёт вас к шагу 4.

Способ 2: Терминальный TUI
Запустите OpenCode в директории проекта и введите /connect:
opencode/connectНайдите Ofox в списке провайдеров, нажмите Enter и вставьте API-ключ. Затем введите /models и выберите модель в разделе Ofox.
Учётные данные хранятся в ~/.local/share/opencode/auth.json и используются совместно десктопным приложением и терминалом, поэтому настроить это нужно только один раз.
Войти и проверить всё можно и полностью из командной строки:
opencode auth login # выберите Ofox, вставьте API-ключ
opencode models ofox # список доступных моделей Ofox
opencode run -m ofox/anthropic/claude-sonnet-4.6 "Привет, расскажи о себе"Опционально: переменная окружения и файл конфигурации
OpenCode автоматически читает переменную окружения OFOX_API_KEY — удобно для CI или если вы не хотите хранить ключ в локальном файле:
export OFOX_API_KEY=<ваш OFOXAI_API_KEY>Чтобы сделать модель Ofox моделью по умолчанию, добавьте её в opencode.json в корне проекта или в ~/.config/opencode/:
{
"$schema": "https://opencode.ai/config.json",
"model": "ofox/anthropic/claude-sonnet-4.6"
}Идентификаторы моделей имеют формат ofox/<ID модели OfoxAI>; полный список см. в Маркетплейсе моделей .
Протоколы: встроенный провайдер и пользовательский провайдер
При использовании встроенного провайдера Ofox каждая модель по умолчанию работает по своему нативному протоколу — выбирать ничего не нужно:
| Модели | Протокол | Эндпоинт |
|---|---|---|
Claude (anthropic/*) | Нативный Anthropic | https://api.ofox.ai/anthropic/v1 |
Gemini (google/*) | Нативный Gemini | https://api.ofox.ai/gemini/v1beta |
GPT (openai/*) | OpenAI | https://api.ofox.ai/v1 |
| Остальные модели (DeepSeek, Qwen, GLM и др.) | OpenAI-совместимый | https://api.ofox.ai/v1 |
Если вам нужно самостоятельно выбрать протокол — например, вызывать Claude по протоколу OpenAI — встроенный провайдер этого не позволяет. Добавьте пользовательского провайдера и вручную укажите Base URL, API-ключ и модели.
Добавление пользовательского провайдера в десктопном приложении
Перейдите в Settings → Providers → Show more providers (Настройки → Провайдеры → Показать больше провайдеров), выберите Custom OpenAI-compatible provider (Пользовательский OpenAI-совместимый провайдер), заполните поля ниже и нажмите Submit (Отправить):
| Поле | Значение |
|---|---|
| Provider ID (ID провайдера) | Любое, например ofox-openai (не должно совпадать со встроенным ofox) |
| Display name (Отображаемое имя) | Любое, например Ofox (OpenAI protocol) |
| Base URL | https://api.ofox.ai/v1 |
| API key (API-ключ) | Ваш API-ключ OfoxAI |
| Models (Модели) | ID — это ID модели OfoxAI (например, anthropic/claude-sonnet-4.6), имя на ваше усмотрение; нажмите «Add model» (Добавить модель), чтобы добавить ещё |

После добавления в селекторе моделей появится новая группа Ofox (OpenAI protocol); все модели в ней вызываются через OpenAI-совместимый протокол.
Или определите его в opencode.json
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"ofox-openai": {
"npm": "@ai-sdk/openai-compatible",
"name": "Ofox (OpenAI protocol)",
"options": {
"baseURL": "https://api.ofox.ai/v1",
"apiKey": "{env:OFOX_API_KEY}"
},
"models": {
"anthropic/claude-sonnet-4.6": { "name": "Claude Sonnet 4.6" }
}
}
}
}Обращайтесь к этой модели как ofox-openai/anthropic/claude-sonnet-4.6.
Рекомендуемые модели
Рекомендуемые модели см. в Маркетплейсе моделей .