OpenCode — open-source AI-агент, работающий прямо в терминале как полноценный TUI. Понимает контекст проекта, помогает писать и править код, держит историю команд. Подключается к любому OpenAI-совместимому провайдеру через opencode.json в корне проекта.

Требования

macOS / Linux / WSL / Windows + современный терминал
curl и jq в PATH
Аккаунт на hubris.pw и API-ключ

Установка

Самый простой способ — curl-инсталлятор:

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

Альтернативы: npm i -g opencode-ai, Homebrew, Chocolatey, Docker-образ. Полный список — в официальной документации OpenCode.

Подключение к Hubris

OpenCode читает конфиг из opencode.json в корне проекта (или ~/.config/opencode/opencode.json глобально).

Создайте файл со следующим содержимым:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "hubris": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.hubris.pw/v1",
        "apiKey": "{env:HUBRIS_API_KEY}"
      },
      "models": {
        "anthropic/claude-haiku-4.5": { "name": "Claude Haiku" },
        "openai/gpt-4o-mini":         { "name": "GPT-4o mini" },
        "google/gemini-2.0-flash":    { "name": "Gemini Flash" }
      }
    }
  }
}

Ключ кладите в переменную окружения (безопаснее, чем в файл):

export HUBRIS_API_KEY="sk-gw-..."

Запустите агента из папки проекта:

cd /path/to/your/project
opencode

Команды и режимы

Команда	Что делает
`Tab`	переключение Plan Mode ↔ Execute Mode
`@filename`	подключить файл в контекст текущего запроса
drag-and-drop изображения	передать картинку как вход для мультимодальной модели
`/init`	сгенерировать стартовый план проекта
`/models`	переключить активную модель
`/undo` / `/redo`	откатить или повторить последнее изменение
`/share`	поделиться сессией через ссылку

Контроль расходов

Plan Mode (через Tab) — модель только описывает, что собирается делать, не исполняет. Хороший способ оценить сложность задачи и стоимость до запуска.
Отдельный API-ключ для OpenCode с дневным лимитом в настройках.
Расход за сессию виден в «Расходах».

Решение проблем

`Invalid API key` при первом запуске

Перепроверьте, что переменная HUBRIS_API_KEY экспортирована в текущей shell-сессии: echo $HUBRIS_API_KEY.
Ключ должен начинаться с sk-gw-.

Модели не показываются в `/models`

Проверьте, что секция models в opencode.json содержит ID, существующие в нашем каталоге.
Перезапустите opencode после правки конфига.

Запрос «висит» / нет ответа

Тяжёлые модели на сложных задачах могут думать минуты. Если зависло дольше — Ctrl+C и попробуйте более быструю модель.

Что дальше

Каталог моделей — список доступных IDs.
Управление API-ключами — отдельный ключ под OpenCode.
Расходы — детализация сессий.
Cline, Roo Code — агенты для VS Code.

Обновлено: 22 мая 2026 г.

ID	Когда подходит
`anthropic/claude-haiku-4.5`	быстрая работа над типовыми задачами
`openai/gpt-4o-mini`	универсальный выбор, недорого
`google/gemini-2.0-flash`	мультимодальные сценарии (drag-and-drop изображений)

OpenCode