Перейти к основному содержимому

OpenCode

OpenCode — открытый агент для терминала, IDE и десктопа, работающий с произвольными провайдерами моделей.

Установка​

Linux и macOS:

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

Также доступны установка через Homebrew и npm.

Windows. Предпочтительный способ — установка в WSL тем же скриптом. При нативной установке используйте пакетный менеджер: winget, scoop, choco или npm.

Настройка провайдера​

Создайте или отредактируйте файл конфигурации:

  • Linux и macOS — ~/.config/opencode/opencode.json;
  • Windows — %USERPROFILE%\.config\opencode\opencode.json.
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "itg-aiaas": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "ITG AIaaS",
      "options": {
        "baseURL": "https://<адрес_шлюза>/v1",
        "apiKey": "<ВАШ_КЛЮЧ>"
      },
      "models": {
        "opr.deepseek4_flash.chat_completions": {
          "name": "opr.deepseek4_flash.chat_completions"
        },
        "opr.claude-sonnet5.chat_completions": {
          "name": "opr.claude-sonnet5.chat_completions"
        }
      }
    }
  },
  "model": "itg-aiaas/opr.deepseek4_flash.chat_completions",
  "small_model": "itg-aiaas/opr.deepseek4_flash.chat_completions"
}

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

Через интерактивный режим​

Вместо правки файла можно завести провайдера из самого агента:

  1. Запустите opencode.
  2. Введите /connect и выберите Other.
  3. Укажите идентификатор провайдера — itg-aiaas.
  4. Введите ключ.
  5. Дополните конфигурацию базовым URL и списком моделей, как показано выше.

Проверка​

cd /путь/к/проекту
opencode

В интерфейсе введите /models — провайдер itg-aiaas и его модели должны быть в списке.

Если не работает​

СимптомПричина и что делать
opencode: command not foundАгент не установлен или каталог не в PATH. Переустановите и перезапустите терминал
401 UnauthorizedКлюч неверен, отозван или используется на другой площадке
Провайдера нет в /modelsПроверьте, что файл конфигурации лежит по нужному пути и содержит корректный JSON
Ответ обрывается на длинных задачахУвеличьте таймаут клиента — см. рекомендуемые таймауты