Skip to Content
ToolsOpenCode

Настройка OpenCode

OpenCode  — это ИИ-агент для программирования с открытым исходным кодом, доступный как терминальный TUI, десктопное приложение и расширения для IDE. Ofox встроен в каталог провайдеров OpenCode (данные из models.dev ), поэтому настраивать собственный Base URL не нужно — выберите Ofox, вставьте API-ключ, и вы сможете работать с GPT, Claude, Gemini, DeepSeek и другими моделями.

Предварительные требования

# Выберите один вариант 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» (Популярные провайдеры).

Settings → Providers

2. Найдите и выберите Ofox

Введите ofox в поле поиска и нажмите Ofox.

Поиск Ofox

3. Введите API-ключ

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

Ввод API-ключа Ofox

Ofox в списке Connected providers

4. Включите модели Ofox

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

Settings → Models, включение моделей Ofox

5. Выберите модель и начните диалог

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

Выбор модели в группе Ofox

Способ 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 или если вы не хотите хранить ключ в локальном файле:

~/.zshrc
export OFOX_API_KEY=<ваш OFOXAI_API_KEY>

Чтобы сделать модель Ofox моделью по умолчанию, добавьте её в opencode.json в корне проекта или в ~/.config/opencode/:

opencode.json
{ "$schema": "https://opencode.ai/config.json", "model": "ofox/anthropic/claude-sonnet-4.6" }

Идентификаторы моделей имеют формат ofox/<ID модели OfoxAI>; полный список см. в Маркетплейсе моделей .

Протоколы: встроенный провайдер и пользовательский провайдер

При использовании встроенного провайдера Ofox каждая модель по умолчанию работает по своему нативному протоколу — выбирать ничего не нужно:

МоделиПротоколЭндпоинт
Claude (anthropic/*)Нативный Anthropichttps://api.ofox.ai/anthropic/v1
Gemini (google/*)Нативный Geminihttps://api.ofox.ai/gemini/v1beta
GPT (openai/*)OpenAIhttps://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 URLhttps://api.ofox.ai/v1
API key (API-ключ)Ваш API-ключ OfoxAI
Models (Модели)ID — это ID модели OfoxAI (например, anthropic/claude-sonnet-4.6), имя на ваше усмотрение; нажмите «Add model» (Добавить модель), чтобы добавить ещё

Пользовательский провайдер: вызов Claude по протоколу OpenAI

После добавления в селекторе моделей появится новая группа Ofox (OpenAI protocol); все модели в ней вызываются через OpenAI-совместимый протокол.

Или определите его в opencode.json

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.

Рекомендуемые модели

Рекомендуемые модели см. в Маркетплейсе моделей .

Last updated on