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

Требования

macOS / Linux / WSL / Windows + современный терминал
curl в 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-3.7-flash":    { "name": "Gemini Flash" }
      }
    }
  }
}

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

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

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

cd /path/to/your/project
opencode

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

opencode run -m hubris/google/gemini-3.7-flash "Ответь одним словом: ок"

OpenCode ищет opencode.json не только в текущей папке, но и во всех родительских. Если в ответ на запуск приходит «Configuration is invalid» с путём к чужому файлу — уберите или переименуйте его.

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

Команда	Что делает
`Tab`	переключение агентов Build ↔ Plan: в Plan модель только описывает, что собирается делать
`@filename`	подключить файл в контекст текущего запроса
`/init`	создать или обновить `AGENTS.md` — правила проекта для агента
`/models`	переключить активную модель
`/undo` / `/redo`	откатить или повторить последнее изменение
`/share`	поделиться сессией через ссылку

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

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

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

`Error: Неверный API-ключ` при первом запуске

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

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

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

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

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

Проверено на OpenCode 1.18.29, 9 сентября 2026.

Что дальше

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

Обновлено: 9 сентября 2026 г.

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

OpenCode