OpenCode: настройка API и подключение моделей — полное руководство по терминальному AI-инструменту

Что такое OpenCode

OpenCode — инструмент для ИИ-кодирования в терминале с открытым исходным кодом, аналог Claude Code. Главное отличие — OpenCode поддерживает любой LLM через пользовательские API-эндпоинты, давая свободу выбора провайдера и модели.

Через OfoxAI можно подключить все доступные модели — Claude, GPT, Gemini, Kimi и другие — используя один API Key. В этом руководстве разберём три способа настройки, рекомендуемые модели и решение типичных проблем.

Установка

# macOS / Linux
curl -fsSL https://opencode.ai/install | bash

# или установка через Go
go install github.com/opencode-ai/opencode@latest

После установки команда opencode станет доступна в терминале.

Способ 1: переменные окружения OpenAI (рекомендуется)

Самый простой способ подключения. OpenCode поддерживает OpenAI-совместимый режим через стандартные переменные:

# Добавьте в ~/.zshrc (или ~/.bashrc)
export OPENAI_API_KEY=<Ваш OFOXAI_API_KEY>
export OPENAI_BASE_URL=https://api.ofox.ai/v1

Примените изменения:

source ~/.zshrc

Через OpenAI-совместимый режим доступны все модели каталога OfoxAI — Claude, GPT, Gemini, Qwen и другие.

Способ 2: переменные окружения Anthropic

Если вы преимущественно используете модели Claude, можно настроить режим Anthropic:

# Добавьте в ~/.zshrc (или ~/.bashrc)
export ANTHROPIC_API_KEY=<Ваш OFOXAI_API_KEY>
export ANTHROPIC_BASE_URL=https://api.ofox.ai/anthropic

Примените изменения:

source ~/.zshrc

Режим Anthropic обеспечивает нативную поддержку протокола Anthropic для моделей Claude.

Способ 3: файл конфигурации config.toml

Для точного контроля над провайдерами и моделью по умолчанию используйте файл конфигурации OpenCode:

# ~/.config/opencode/config.toml

[providers.ofoxai]
api_key = "<Ваш OFOXAI_API_KEY>"
base_url = "https://api.ofox.ai/v1"

[models.default]
provider = "ofoxai"
model = "anthropic/claude-sonnet-4.6"

Этот способ позволяет задать провайдера и модель по умолчанию в одном месте, без переменных окружения.

Проверка

opencode "Здравствуйте, как дела?"

Если ответ получен — настройка выполнена успешно.

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

Claude Sonnet 4.6 — оптимальный выбор для повседневной работы: качественный код, разумная скорость, адекватная стоимость. Для архитектурных решений и сложного рефакторинга подключайте Claude Opus 4.6. Для быстрых вопросов и простых задач — Kimi K2.5.

Практические сценарии

Генерация кода

OpenCode умеет генерировать код по описанию. Просто опишите задачу:

opencode "Напиши HTTP-сервер на Go с middleware для логирования"

Рефакторинг

Откройте OpenCode в каталоге проекта и опишите, что нужно изменить:

cd your-project
opencode "Перепиши обработчики ошибок с использованием кастомных типов"

Работа с существующим кодом

OpenCode читает файлы проекта и может отвечать на вопросы по кодовой базе:

opencode "Объясни архитектуру этого проекта"

Когда какой способ настройки выбрать

Переменные окружения OpenAI — самый универсальный вариант. Работает с любыми моделями из каталога OfoxAI. Подходит для большинства пользователей.

Переменные окружения Anthropic — если вы работаете исключительно с Claude и хотите нативный протокол Anthropic.

Файл config.toml — когда нужен точный контроль: явное указание провайдера, модели по умолчанию, возможность хранить конфигурацию в файле вместо переменных окружения.

Решение типичных проблем

Ошибка 401 Unauthorized

Проблема с API-ключом. Проверьте:

1. Ключ скопирован без лишних пробелов и переносов строк
2. Ключ не истёк и не отозван
3. Base URL соответствует типу ключа
4. Переменная окружения загружена — выполните echo $OPENAI_API_KEY

Ошибка подключения

Убедитесь, что Base URL указан верно: https://api.ofox.ai/v1 для OpenAI режима или https://api.ofox.ai/anthropic для Anthropic.

Модель не найдена

Проверьте формат ID модели: provider/model-name. Правильно: anthropic/claude-sonnet-4.6. Неправильно: claude-sonnet-4.6.

Важное замечание

Конкретные параметры конфигурации OpenCode могут меняться с обновлениями версий. Если что-то не работает — проверьте официальную документацию OpenCode на GitHub.

Итог

OpenCode — открытый терминальный AI-инструмент с поддержкой любого LLM. Три способа настройки на выбор: переменные окружения OpenAI (https://api.ofox.ai/v1), переменные Anthropic (https://api.ofox.ai/anthropic) или файл ~/.config/opencode/config.toml. Рекомендуемая модель для повседневной работы — anthropic/claude-sonnet-4.6.

Подробнее — в документации по интеграции OpenCode. API Key можно создать на ofox.ai.