---
title: "Подключение OpenCode к AI-агентам"
description: "Подробная информация о подключении AI-агента или AI Gateway к OpenCode в справочном центре Timeweb Cloud. Установка OpenCode, настройка провайдера, базового URL, моделей и API-ключа через терминал или десктопное приложение."
---

> Полный индекс документации для ИИ-агентов: [llms.txt](https://timeweb.cloud/llms.txt).

OpenCode — это AI-ассистент для разработки. С его помощью можно задавать вопросы по проекту, редактировать код и выполнять команды без переключения в отдельный интерфейс.

К OpenCode можно подключить как AI-агента, так и AI Gateway. В первом случае вы работаете с уже настроенным агентом, во втором — обращаетесь к модели напрямую.

## Установка OpenCode

OpenCode можно установить на Windows, Linux или macOS. Доступны два варианта: TUI/CLI и десктопное приложение.

Чтобы установить TUI/CLI-версию, используйте один из способов:

curl

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

npm

```bash
npm i -g opencode-ai
```

bun

```bash
bun add -g opencode-ai
```

brew

```bash
brew install anomalyco/tap/opencode
```

paru

```bash
paru -S opencode
```

Десктопную версию можно установить через Homebrew:

```bash
brew install --cask opencode-desktop
```

Также можно скачать бинарный файл с [официального сайта OpenCode](https://opencode.ai/ru/download) и установить его вручную.

## Предварительные требования

Подключить к OpenCode можно как AI-агента, так и AI Gateway.

Если вы хотите подключить AI-агента, вам потребуется:

-   [Базовый URL агента](https://timeweb.cloud/docs/ai-agents/api-usage/openai-compatible-api#bazovyj-url);
    
-   [API-ключ](https://timeweb.cloud/docs/ai-agents/manage-agents/api-access-key).
    

Для подключения AI Gateway понадобится:

-   Базовый URL: `https://api.timeweb.ai/v1`;
    
-   [API-ключ](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#sozdanie-api-klucha).
    

## Настройка подключения через терминал

Этот способ подойдет, если вы используете TUI/CLI-версию OpenCode.

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

Файл можно разместить:

-   в корне проекта — настройки будут применяться только для этого проекта;
    
-   глобально по пути `~/.config/opencode/opencode.json` — настройки будут доступны во всех проектах.
    

В файле укажите конфигурацию для подключения:

```js
{
 "$schema": "https://opencode.ai/config.json",
 "provider": {
   "timeweb-cloud": {
     "npm": "@ai-sdk/openai-compatible",
     "name": "Timeweb Cloud",
     "options": {
       "baseURL": "https://api.timeweb.ai/v1"
     },
     "models": {
       "openai/gpt-5-mini": {
         "name": "openai/gpt-5-mini"
       }
     }
   }
 },
 "model": "openai/gpt-5-mini"
}
```

В конфигурации измените:

-   `baseURL` — если хотите использовать AI-агента, укажите базовый URL вашего агента. При использовании AI Gateway менять не нужно;
    
-   `models` — укажите модели, которые будут доступны в OpenCode;
    
-   `model` — если используете AI-агента, укажите имя модели из настроек агента. При использовании AI Gateway укажите имя нужной модели, например `openai/gpt-5-nano`. Корректное имя модели можно найти в разделе «[Подключение](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#poluchenie-parametrov-podklucheniya)»;
    
-   `name` — при необходимости измените отображаемое имя провайдера.
    

Сохраните и закройте файл.

Теперь необходимо указать API-ключ. Для этого запустите OpenCode в терминале:

```bash
opencode
```

В открывшемся TUI-интерфейсе выполните команду:

```bash
/connect
```

С помощью стрелок прокрутите список провайдеров вниз и выберите пункт «Other».

Укажите идентификатор провайдера. Он должен совпадать с названием провайдера в `opencode.json`, в нашем примере — `timeweb-cloud`.

Вставьте API-ключ в поле ввода.

OpenCode сохранит ключ в зашифрованном глобальном файле авторизации.

После этого можно начать использовать OpenCode. Запустите агента снова, если ранее выходили из него. Чтобы выбрать добавленную модель, введите:

```bash
/model
```

В поиске укажите имя провайдера, которое вы задали при добавлении. Затем проверьте подключение, отправив любое сообщение в чат.

## Настройка подключения в десктопном приложении

Чтобы подключить провайдера в десктопном приложении:

1.  Нажмите на иконку шестеренки.
    
2.  Перейдите во вкладку «Провайдеры».
    
3.  Пролистайте меню вниз и выберите пункт «Пользовательский провайдер».
    
4.  Нажмите «Подключить».
    

![Настройки OpenCode](https://content.timeweb.com/assets/c7bdc033-6fd5-4fcb-8faf-05a53b3e4b63.png?width=2536&height=1510)

_Интерфейс настройки [OpenCode](https://opencode.ai/)_

Укажите параметры подключения:

-   ID провайдера — произвольное имя, по которому можно будет найти провайдера;
    
-   Отображаемое имя — название провайдера в интерфейсе;
    
-   Базовый URL — базовый URL агента или AI Gateway;
    
-   API-ключ — ключ для доступа к агенту или AI Gateway;
    
-   Модели — список моделей, которые будут доступны для выбора.
    

При использовании AI Gateway имя модели нужно указать в формате AI Gateway, например `openai/gpt-5-nano`. Корректное имя модели можно найти в разделе «[Подключение](https://timeweb.cloud/docs/ai-agents/api-usage/ai-gateway#poluchenie-parametrov-podklucheniya)».

При использовании AI-агента можно указать произвольное имя модели.

![Настройка OpenCode](https://content.timeweb.com/assets/6637fd58-0bb0-4a2f-b5f5-6e446ea5b02b.png?width=2548&height=1506)

_Интерфейс настройки [OpenCode](https://opencode.ai/)_

Нажмите «Отправить», чтобы сохранить настройки.

После этого найдите и выберите модель в чате. Проверьте, что подключение настроено корректно, отправив произвольный запрос.