> ## Documentation Index
> Fetch the complete documentation index at: https://polza.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenCode Desktop

> Подключение настольного приложения OpenCode к Polza.ai на macOS и Windows

С Polza.ai вы можете использовать модели Claude, GPT, DeepSeek и другие через единый API-ключ — без отдельных аккаунтов у каждого провайдера.

В этой инструкции покажем, как подключить Polza.ai к настольному приложению OpenCode на macOS и Windows.

> [!NOTE]
>
> **Совместимость:** Windows 10/11 и macOS, OpenCode Desktop 2.x. Инструкция проверена на версии 2.2.0.

> [!NOTE]
>
> Это инструкция для настольного приложения OpenCode. Терминальный вариант (CLI) — отдельная страница: [OpenCode](https://polza.ai/docs/integracii/opencode.md).

## Что понадобится

* Установленное приложение [OpenCode](https://opencode.ai/).
* Аккаунт Polza.ai с положительным балансом.
* API-ключ Polza.ai.
* Терминал на macOS или PowerShell на Windows — стандартные инструменты обеих систем.

**1. Получите API-ключ Polza.ai**

Войдите в личный кабинет [Polza.ai](https://polza.ai/).

1. Перейдите в раздел «API-ключи».
2. Создайте новый ключ или используйте существующий.

Сохраните ключ — он понадобится для подключения OpenCode.

> [!WARNING]
>
> **Важно:** не передавайте API-ключ другим пользователям и не публикуйте его в открытом доступе.

**2. Создайте файл конфигурации OpenCode**

> [tab] macOS
>
> Откройте приложение «Терминал» на macOS и выполните команду:
>
> ```bash theme={null}
> mkdir -p ~/.config/opencode
> touch ~/.config/opencode/opencode.json
> open -e ~/.config/opencode/opencode.json
> ```
>
> Команды создадут папку конфигурации, если её ещё нет, и откроют файл `opencode.json` в TextEdit.

> [tab] Windows
>
> Нажмите `Win` + `X` и выберите «Терминал» или «Windows PowerShell». Права администратора не требуются.
>
> Выполните следующую команду:
>
> ```powershell theme={null}
> New-Item -ItemType Directory -Force "$HOME\.config\opencode" | Out-Null
> ```
>
> Она создаст папку конфигурации OpenCode, если её ещё нет.
>
> Теперь создайте файл `opencode.json`, если он отсутствует, и откройте его в Блокноте:
>
> ```powershell theme={null}
> $file = "$HOME\.config\opencode\opencode.json"
> if (!(Test-Path $file)) {
>     New-Item -ItemType File -Path $file | Out-Null
> }
> notepad $file
> ```

Файл конфигурации будет находиться по адресу:

> [tab] macOS
>
> ```text theme={null}
> ~/.config/opencode/opencode.json
> ```

> [tab] Windows
>
> ```text theme={null}
> %USERPROFILE%\.config\opencode\opencode.json
> ```
>
> Например:
>
> ```text theme={null}
> C:\Users\Username\.config\opencode\opencode.json
> ```

> [!NOTE]
>
> **Обратите внимание:** OpenCode использует файл `opencode.json` или `opencode.jsonc`. Файл `service.json` для этой настройки не подходит. Если файл `opencode.json` уже существует, не удаляйте его содержимое. Провайдера Polza.ai нужно добавить к текущим настройкам.

**3. Добавьте провайдера Polza.ai**

Если файл `opencode.json` пустой, вставьте в него следующую конфигурацию:

```json theme={null}
{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "polza": {
      "name": "Polza.ai",
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": {
        "baseURL": "https://polza.ai/api/v1",
        "apiKey": "{file:~/.config/opencode/provider-key}"
      },
      "models": {
        "claude-sonnet-5": {
          "name": "Claude Sonnet 5",
          "modelID": "anthropic/claude-sonnet-5"
        },
        "deepseek-v4-flash": {
          "name": "DeepSeek V4 Flash",
          "modelID": "deepseek/deepseek-v4-flash"
        }
      }
    }
  }
}
```

Сохраните файл — `Cmd` + `S` на macOS или `Ctrl` + `S` на Windows.

В конфигурации указаны две модели для примера. Вы сможете добавить другие модели из каталога Polza.ai.

> [!WARNING]
>
> Если у вас уже настроены другие провайдеры, добавьте объект `polza` внутрь существующего раздела `providers`, не заменяя остальные настройки.

**4. Подключите API-ключ Polza.ai**

Для безопасности сохраним API-ключ отдельно от основного файла конфигурации.

> [tab] macOS
>
> Вернитесь в Терминал и выполните:
>
> ```bash theme={null}
> touch ~/.config/opencode/provider-key
> open -e ~/.config/opencode/provider-key
> ```
>
> В открывшийся файл вставьте API-ключ Polza.ai.
>
> В файле должен находиться только ключ — без кавычек и дополнительных символов.
>
> Сохраните файл и закройте TextEdit.
>
> Теперь ограничьте доступ к файлу с ключом:
>
> ```bash theme={null}
> chmod 600 ~/.config/opencode/provider-key
> ```
>
> > [!NOTE]
> >
> > **Готово!** OpenCode будет автоматически считывать API-ключ из этого файла.

> [tab] Windows
>
> Вернитесь в PowerShell и выполните:
>
> ```powershell theme={null}
> notepad "$HOME\.config\opencode\provider-key"
> ```
>
> Если Windows сообщит, что файл не найден, согласитесь создать новый.
>
> В открывшийся Блокнот вставьте API-ключ Polza.ai.
>
> В файле должен находиться только ключ — без кавычек, пробелов и дополнительного текста.
>
> Нажмите `Ctrl` + `S` и закройте Блокнот.
>
> Храните файл в личной папке пользователя и не предоставляйте к нему общий доступ.

Теперь API-ключ хранится в отдельном файле:

> [tab] macOS
>
> ```text theme={null}
> ~/.config/opencode/provider-key
> ```

> [tab] Windows
>
> ```text theme={null}
> %USERPROFILE%\.config\opencode\provider-key
> ```

OpenCode будет автоматически считывать его благодаря настройке:

```json theme={null}
{
  "apiKey": "{file:~/.config/opencode/provider-key}"
}
```

> [!WARNING]
>
> **Важно:** не переименовывайте файл в `provider-key.txt`. Убедитесь, что его название — именно `provider-key`, без расширения.

**5. Перезапустите OpenCode**

После перезапуска проверьте подключение:

1. Полностью закройте приложение OpenCode.
2. Запустите его повторно.
3. Откройте меню выбора AI-моделей.
4. Найдите провайдера **Polza.ai**.
5. Выберите Claude Sonnet 5 или DeepSeek V4 Flash.

На macOS закройте приложение через `Cmd` + `Q`.

Отправьте тестовый запрос, например:

> «Привет! Расскажи, как ты можешь помочь мне с разработкой».

> [!NOTE]
>
> Если модель отвечает, подключение работает.

## Как добавить другие модели

Вы можете использовать дополнительные модели из [каталога Polza.ai](https://polza.ai/).

> [tab] macOS
>
> Для этого откройте `opencode.json` и добавьте нужную модель в раздел `models` провайдера `polza`.

> [tab] Windows
>
> Для этого откройте конфигурацию через PowerShell:
>
> ```powershell theme={null}
> notepad "$HOME\.config\opencode\opencode.json"
> ```
>
> Внутри раздела `models` добавьте новую запись:

```json theme={null}
{
  "providers": {
    "polza": {
      "models": {
        "my-model": {
          "name": "Название модели",
          "modelID": "provider/model-id"
        }
      }
    }
  }
}
```

Замените `provider/model-id` на точный идентификатор модели из каталога Polza.ai.

Поле `my-model` определяет локальный идентификатор модели в OpenCode, а `name` — её отображаемое название.

> [!NOTE]
>
> При добавлении записей соблюдайте синтаксис JSON: соседние объекты должны разделяться запятыми.

После сохранения файла перезапустите приложение.

## Если подключение не работает

> [accordion] Polza.ai не появляется в списке моделей
>
> Убедитесь, что:
>
> * Файл называется `opencode.json`, а не `opencode.json.txt`.
> * Он находится в `%USERPROFILE%\.config\opencode\` на Windows или `~/.config/opencode/` на macOS.
> * Конфигурация содержит раздел `providers`.
> * В JSON нет синтаксических ошибок.
> * Используется OpenCode Desktop 2.x.

> [accordion] Ошибка авторизации
>
> Проверьте правильность API-ключа в файле `provider-key`. Убедитесь, что он действителен и не содержит лишних символов.

> [accordion] Модель отображается, но не отвечает
>
> Проверьте баланс Polza.ai, доступность выбранной модели и правильность её идентификатора `modelID`.

> [accordion] Пропали ранее настроенные провайдеры
>
> Проверьте, не заменили ли вы существующий раздел `providers` целиком. Все провайдеры должны находиться внутри одного объекта `providers`.

## Готово!

Теперь вы можете работать с моделями Polza.ai прямо в OpenCode.

Запросы оплачиваются по фактическому использованию токенов, без отдельной подписки на каждую модель. Расходы можно отслеживать в личном кабинете Polza.ai.

## Следующие шаги

> [card] [OpenCode Desktop](https://polza.ai/docs/integracii/opencode-desktop.md)
>
> Настольное приложение OpenCode — подключение к Polza.ai по шагам

> [card] [Выбор провайдера](https://polza.ai/docs/gaidy/provider-selection.md)
>
> Как выбирать и переключаться между провайдерами моделей

Если при подключении возникнут вопросы, напишите в поддержку Polza.ai — поможем разобраться.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.