# OpenCode

Источник: https://docs.aicentos.com/ru/clients/opencode

Language: ru

> Использование aicentos в 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](https://nodejs.org/en/download)

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

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

```bash
brew install node
```

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

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

```bash
node -v
npm -v
```

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

## Установка

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

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

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

## Задание API Key

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

```bash
opencode auth login
```

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

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

```bash
export OPENAI_API_KEY="your_api_key_here"
```

## Настройка opencode.json

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

```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](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/](https://opencode.ai/)