OpenCode

OpenCode поддерживает кастомных провайдеров: сервис Codex Proxy можно подключить через файл конфигурации.

ПодготовкаКопировать ссылку на якорь

На официальном сайте OpenCode есть официальный установочный скрипт, а также установка через npm, bun, brew и другие способы.

• Если используете официальный установочный скрипт напрямую, обычно вручную настраивать npm заранее не нужно
• Если планируете установку через npm, сначала установите Node.js и npm
• Если планируете установку через bun, сначала установите bun

Установка Node.js (способ через npm)Копировать ссылку на якорь

Официальная страница загрузки Node.js: https://nodejs.org/en/download

• macOS / Windows: скачайте и установите LTS-версию
• Linux: установите способом для своего дистрибутива, указанным на этой странице

Если на macOS уже установлен Homebrew, можно просто выполнить:

brew install node

Это установит и Node.js, и npm.

Рекомендуется заранее убедиться, что команда, соответствующая выбранному способу установки, доступна. Например, для npm-способа сначала проверьте:

node -v
npm -v

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

УстановкаКопировать ссылку на якорь

Рекомендуется использовать установочную команду с официального сайта OpenCode:

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

На сайте OpenCode также доступны установка через npm, bun, brew и другие способы.

Задание API KeyКопировать ссылку на якорь

Используйте собственный механизм подключения и аутентификации OpenCode:

opencode auth login

Либо запустите /connect в интерактивном интерфейсе и сохраните этот сервис как кастомного провайдера.

Если вам привычнее переменные окружения, достаточно, чтобы opencode.json читал официальное общее имя переменной, например:

export OPENAI_API_KEY="your_api_key_here"

Настройка opencode.jsonКопировать ссылку на якорь

Создайте opencode.json в корне проекта или в глобальном каталоге конфигурации:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "aicentos": {
      "npm": "@ai-sdk/openai",
      "name": "aicentos",
      "options": {
        "baseURL": "https://aicentos.com/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4o": {
          "name": "gpt-4o"
        }
      }
    }
  },
  "model": "aicentos/gpt-4o"
}

ПроверкаКопировать ссылку на якорь

После запуска OpenCode выполните:

/models

Достаточно увидеть модели в разделе aicentos.

ПримечанияКопировать ссылку на якорь

• Рекомендуемый порядок: сначала ручной файл конфигурации (opencode.json), затем переменные окружения, и только потом инструмент cc-switch (https://github.com/farion1231/cc-switch/releases)
• Если идёте через /v1/responses, официальная документация OpenCode рекомендует @ai-sdk/openai
• Если ваше подключение поддерживает только /v1/chat/completions, тогда берите @ai-sdk/openai-compatible
• Дополнительные приватные переменные проекта вроде CODEX_PROXY_API_KEY не нужны

Полезные ссылкиКопировать ссылку на якорь

• Официальный сайт: https://opencode.ai/