# Zed Agent

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

Language: ru

> Подключение aicentos в Agent Panel редактора Zed через OpenAI-совместимого провайдера

В Zed встроен OpenAI-совместимый тип провайдеров: достаточно объявить эндпоинт, модели и длину контекста в `settings.json`, и Agent Panel сможет использовать модели, подключённые к aicentos.

## Подготовка

Сначала создайте на странице «API Key» в консоли отдельный ключ для Zed (рекомендуемое имя `zed-agent`).

* Консоль: [https://aicentos.com](https://aicentos.com)
* Создание ключа: [https://aicentos.com/keys](https://aicentos.com/keys)
* Пополнение кошелька: [https://aicentos.com/wallet](https://aicentos.com/wallet)

Zed не записывает API Key в `settings.json`, а читает одноимённую переменную окружения: ID провайдера переводится в верхний регистр в стиле snake\_case с суффиксом `_API_KEY`. Поэтому если ID провайдера — `aicentos`, переменная окружения будет называться `AICENTOS_API_KEY`.

## Конфигурация для заполнения

| Поле                            | Значение                                  |
| ------------------------------- | ----------------------------------------- |
| Provider ID                     | произвольный, например `aicentos`         |
| `api_url`                       | `https://aicentos.com/v1`                 |
| `available_models[].name`       | имя модели из «витрины моделей» в консоли |
| `available_models[].max_tokens` | контекстное окно модели                   |
| API Key                         | переменная окружения `AICENTOS_API_KEY`   |

## Шаги настройки

* Откройте `settings.json` Zed (команда `zed: open settings` в палитре команд).
* Добавьте конфигурацию `language_models.openai_compatible`:

```json
{
  "language_models": {
    "openai_compatible": {
      "aicentos": {
        "api_url": "https://aicentos.com/v1",
        "available_models": [
          {
            "name": "gpt-5",
            "display_name": "GPT-5 (aicentos)",
            "max_tokens": 128000,
            "max_output_tokens": 16384,
            "capabilities": {
              "tools": true,
              "images": false,
              "chat_completions": true
            }
          }
        ]
      }
    }
  }
}
```

* Экспортируйте переменную окружения (добавьте в `~/.zshrc` и перезагрузите его):

```bash
export AICENTOS_API_KEY="sk-ваш-aicentos-ключ"
```

* Откройте Agent Panel и выберите в выпадающем списке модель этого провайдера.

Также можно нажать **Add Provider** в настройках агента и заполнить название провайдера, API URL, ID модели и контекстное окно через графический интерфейс.

## Проверка

После настройки создайте новый диалог в Agent Panel и сначала выполните лёгкий тест простым коротким промптом, убедившись, что ответ приходит корректно, и только потом переходите к вызовам инструментов.

## Примечания

* В `api_url` указывайте только `https://aicentos.com/v1`, не дописывайте полный путь `/chat/completions`; Zed соберёт его сам.
* API Key нельзя записывать прямо в `settings.json` — используйте переменную окружения (или сохраните ключ в системный keychain через интерфейс настроек провайдера); непустая переменная окружения имеет приоритет над keychain.
* `max_tokens` — это контекстное окно; рекомендуется указывать фактическое значение модели, иначе управление контекстом будет работать некорректно.
* Вызовы инструментов включены по умолчанию (`capabilities.tools`); подача изображений и параллельные вызовы инструментов по умолчанию выключены — включайте вручную при необходимости.
* Официальная документация: [https://zed.dev/docs/ai/llm-providers](https://zed.dev/docs/ai/llm-providers)
* Подробнее — на сайте документации: [https://docs.aicentos.com](https://docs.aicentos.com)