OpenCode: что это, как установить и подключить любые модели по API

Что такое OpenCode

OpenCode это открытый агент для работы с кодом в терминале. Он показывает план, правит файлы, запускает тесты и объясняет изменения. По смыслу это аналог Claude Code и Codex CLI, но с открытым исходным кодом и без привязки к одному провайдеру.

Свобода в выборе модели здесь главное. Агент общается по OpenAI-совместимому протоколу, поэтому ему можно подсунуть любой шлюз: от локального сервера до облачного каталога.

Установка и конфиг

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

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "llmmart": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LLM Mart",
      "options": {
        "baseURL": "https://llmmart.ru/api/v1",
        "apiKey": "{env:LLM_MART_API_KEY}"
      },
      "models": {
        "anthropic/claude-sonnet-5.5": { "name": "Claude Sonnet 5.5" },
        "z-ai/glm-5.3": { "name": "GLM 5.3" },
        "qwen/qwen3-coder-plus": { "name": "Qwen3 Coder Plus" }
      }
    }
  }
}

Ключ подставляется из переменной окружения, поэтому в файле секрета нет и его можно держать в репозитории как пример.

export LLM_MART_API_KEY="sk-…"

Какие модели подключать

Агенту нужна модель с устойчивым вызовом инструментов, а не просто с хорошим текстом. Если модель иногда забывает формат, агент уходит в цикл и тратит токены без результата.

Для кода хорошо подходят модели, обученные на нём: Qwen3 Coder Plus с миллионом токенов контекста или специализированные версии Kimi. Универсальные флагманы тоже работают, но стоят дороже на том же объёме.

Агент читает файлы на каждом шаге, поэтому расход растёт быстро. Кэширование ввода помогает: системный промпт и содержимое файлов повторяются от запроса к запросу.

Чем отличается от Claude Code и Codex CLI

OpenCode не привязан к вендору, и это его главное преимущество. Claude Code надёжен с моделями Anthropic, Codex CLI работает через Responses API, а OpenCode говорит по OpenAI-совместимому протоколу и принимает любую модель из каталога.

Второе отличие: открытый код. Можно посмотреть, как агент собирает контекст, и поправить поведение под свой проект. У закрытых инструментов такой возможности нет.

Третье: настройка через один JSON. Не нужно держать несколько конфигов под разные вендоры: список моделей задаётся в одном месте.

Подробная инструкция с разбором ошибок лежит в документации по OpenCode, а сравнение агентов есть в статье про Claude Code и Codex.