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

OpenCode это открытый ИИ-агент для кода. Он читает проект, правит файлы и запускает команды, а модель под него вы подбираете сами. Поставить его можно одной командой в терминале или готовым приложением. Дальше: установка на macOS, Linux и Windows, что в OpenCode платно и что бесплатно, и подключение ключа codexkey с готовым конфигом.

OpenCode: что это и чем он отличается от Claude Code

Проект OpenCode описывает себя как открытого ИИ-агента для кода. Он работает в терминале, в десктопном приложении и как расширение для IDE, лицензия MIT. Старый адрес репозитория sst/opencode теперь открывается как anomalyco/opencode, а звёзд у него около 223 тысяч на 29 октября 2026.

Главное отличие от Claude Code лежит в привязке к моделям. OpenCode не держится за одного вендора: к нему подключают модели разных компаний и меняют их командой /models. Claude Code строится вокруг моделей Claude, про его аналоги и сравнения мы писали отдельно. Если нужно гонять разные модели по одному репозиторию и не менять ради этого инструмент, мы бы взяли OpenCode.

Установка OpenCode на macOS, Linux и Windows

Сначала предупреждение: веток у OpenCode две. Документация рассказывает про обе, но главная страница и страница загрузок уже показывают команды второй. Консольная команда у них общая, opencode, так что вместе они не уживутся.

На Windows основная документация советует WSL, а также упоминает scoop install opencode и choco install opencode. В документации второй ветки сказано, что пакетные менеджеры Windows она не поддерживает и нужен отдельный бинарный файл. Результат установки проверяется командой opencode --version.

Какую ветку взять. Конфиг codexkey из этой статьи написан под OpenCode 1, поэтому ставьте её: npm install -g opencode-ai. Формат файла у второй ветки иной: ключ верхнего уровня providers, поля package, settings.baseURL и env. Если у вас уже стоит OpenCode 2, перенесите адрес, ключ и ID моделей по примеру из документации второй ветки на opencode.ai/v2/docs.

Десктопное приложение

Установщики лежат на странице opencode.ai/download: для macOS на Apple Silicon и Intel, для Windows x64 и ARM64, для Linux пакеты .deb и .rpm. На macOS можно обойтись Homebrew: brew install --cask opencode-desktop.

Zen, Go и бесплатные модели: провайдеры в OpenCode

Добавить модель можно двумя способами: командой /connect в интерфейсе или записью в opencode.json. Всё, что вы ввели через /connect, OpenCode складывает в ~/.local/share/opencode/auth.json.

OpenCode Zen это отобранный командой каталог моделей с оплатой по факту: вы пополняете баланс в консоли OpenCode и тратите его на запросы. На пополнение накладывается комиссия 4.6% плюс $0.31. Среди моделей есть OpenAI, Anthropic, Google, xAI, Qwen, DeepSeek, Kimi и другие, а ID пишутся как opencode/<model-id>.

OpenCode Go продаёт подписку на популярные открытые модели для кода. Go стоит $10 в месяц, Go Plus $40, Go Teams $20 за каждого участника. Лимиты заданы в долларах на конкретную модель: 5-часовое окно даёт 20% месячной суммы, неделя 50%. К примеру, на Go по Kimi K3 доступно $15 в месяц. Список моделей меняется, и документация предупреждает об этом отдельно.

Теперь о бесплатных моделях Zen. В документации на 29 октября 2026 перечислены GLM-5.3-Flash Free, DeepSeek V4.1 Flash Free, MiMo-V2.6-Flash Free, несколько моделей Nemotron и Big Pickle, и все они доступны ограниченное время. Спрятать их можно переменной OPENCODE_DISABLE_FREE_MODELS=1. Сама программа бесплатна, вы платите только за токены или подписку. Принимает ли консоль OpenCode оплату из России и какими способами, в документации не сказано, мы это не проверяли.

Подключение OpenCode к codexkey по API-ключу

codexkey отдаёт OpenAI-совместимый адрес https://api.codexkey.ru/v1 и один ключ sk_cdx_... на все модели. Платить можно картой РФ, через СБП или криптой. Аккаунт OpenCode и подписка Zen для этого не нужны. Ниже конфиг из гайда по OpenCode, без правок: ключ заменён только на заглушку.

Файл лежит в ~/.config/opencode/opencode.json, а в Windows в %USERPROFILE%\.config\opencode\opencode.json. Вставьте в него:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "codexkey-claude/claude-sonnet-5",
  "provider": {
    "codexkey-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "codexkey · Claude",
      "options": { "baseURL": "https://api.codexkey.ru/v1", "apiKey": "sk_cdx_YOUR_KEY" },
      "models": {
        "claude-opus-5-5": { "name": "Claude Opus 5.5", "limit": { "context": 1000000, "output": 128000 } },
        "claude-sonnet-5": { "name": "Claude Sonnet 5", "limit": { "context": 1000000, "output": 32000 } }
      }
    },
    "codexkey": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "codexkey · GPT, Gemini and others",
      "options": { "baseURL": "https://api.codexkey.ru/v1", "apiKey": "sk_cdx_YOUR_KEY" },
      "models": {
        "gpt-6-astra": { "name": "GPT-6 Astra", "limit": { "context": 1000000, "output": 128000 } },
        "gemini-3.1-pro": { "name": "Gemini 3.1 Pro", "limit": { "context": 1000000, "output": 65000 } },
        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash", "limit": { "context": 1000000, "output": 131072 } }
      }
    }
  }
}

Запустите opencode и выберите модель через /models, например codexkey/gpt-6-astra. Несколько правил.

• Блок limit нужен: без него OpenCode не знает размер контекста и не умеет сжимать историю.
• Имя модели собирается из провайдера, слэша и названия. Модели Claude описаны в провайдере codexkey-claude, остальные в codexkey.
• Если назвать файл opencode.jsonc, в нём разрешены комментарии.
• Ключ храните в глобальном файле. Проектный opencode.json обычно лежит в репозитории и перекрывает глобальный, так что ключ из него легко случайно закоммитить.
• Новая модель добавляется в нужный блок models по образцу соседей, а ID берётся из каталога или из ответа на GET https://api.codexkey.ru/v1/models.

Конфиги OpenCode объединяются, а не заменяют друг друга, и при конфликте сильнее проектный файл. Значит, в репозитории хватит минимального opencode.json без ключа, а провайдеры и ключ придут из глобального:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "codexkey/deepseek-v4.1-flash"
}

Модели нет в списке /models? Проверьте три места: валидность JSON (одна лишняя запятая ломает весь файл), наличие модели в блоке models нужного провайдера и совпадение ID с ответом GET /v1/models символ в символ.

Какую модель взять в OpenCode

Лучшей модели на все случаи нет, есть разные цены за разные задачи. Цены в таблице взяты из прайса codexkey на 29 октября 2026, актуальные смотрите на странице моделей.

Схема собрана по цене и роли, бенчмарка за ней нет. Проверить на своём репозитории просто: 10 типовых задач с тестами, каждая на двух-трёх моделях, затем сравнить долю решённых и цену за решённую задачу. Методику подробнее разбирает статья о выборе нейросети для программирования.

Снизить расход помогает small_model: OpenCode отдаёт ей лёгкие задачи вроде названий сессий. Добавьте "small_model": "codexkey/deepseek-v4.1-flash" рядом с model, и служебную работу возьмёт дешёвая модель. Другие способы сэкономить собраны в материале о том, как сократить счёт за Claude Code втрое. Если вместо OpenCode нужен агент для чатов, смотрите OpenClaw.

В каталоге codexkey есть и бесплатные модели: deepseek-v4.1-flash-1017-free, minimax-m3-free и qwen3.8-flash-free. Условия и лимиты смотрите на странице моделей, цифр мы тут не придумываем. Подключаются они тем же блоком models в провайдере codexkey.

FAQ

OpenCode бесплатный?

Сам OpenCode бесплатен, исходники открыты под MIT. Платите вы за модели: за токены через Zen или со своим ключом, за подписку Go ($10 в месяц) либо через шлюз вроде codexkey. Бесплатные модели в Zen есть, но временные.

Как установить OpenCode на Windows?

Основная документация советует WSL и упоминает scoop install opencode, choco install opencode и npm install -g opencode-ai. Для OpenCode 2 готовые установщики лежат на странице загрузок. Проверка: opencode --version.

Что такое OpenCode Zen?

Набор моделей, проверенных командой OpenCode, с оплатой по факту через консоль OpenCode. Подключается через /connect, имена выглядят как opencode/<model-id>. При пополнении баланса берётся комиссия 4.6% плюс $0.31.

Что такое OpenCode Go?

Подписка на популярные открытые модели для кода: Go стоит $10 в месяц, Go Plus $40, Go Teams $20 за участника. Лимит считается в долларах на каждую модель по окнам: 5 часов, неделя, месяц. Подключается командой /connect.

Как подключить свой API-ключ или модель к OpenCode?

Впишите провайдера в ~/.config/opencode/opencode.json: пакет @ai-sdk/openai-compatible, baseURL и список моделей. Для codexkey готовый конфиг дан выше, в нём два провайдера и один ключ sk_cdx_....

Есть ли десктопное приложение OpenCode?

Есть. Установщики для macOS, Windows и Linux лежат на opencode.ai/download, а на macOS доступен ещё и cask в Homebrew.

Чем OpenCode отличается от Claude Code?

OpenCode открыт, работает с моделями разных вендоров и переключает их на лету. Claude Code строится вокруг Claude и подключается к ним через переменные ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN и ANTHROPIC_DEFAULT_*, в том числе через codexkey. Решать стоит по тому, нужна ли вам привязка к одной семье моделей.