# Zed в России: агент редактора на своём ключе

> Zed подключает любой OpenAI-совместимый API как провайдера моделей. Добавьте Polza.ai в настройках агента — и Agent Panel работает на Claude, GPT, Qwen и ещё 400 моделях, без подписки Zed и без VPN.

- Без подписки Zed Pro
- Провайдер за минуту
- Карта РФ и СБП
- 400+ моделей одним ключом

Zed — редактор кода с открытым исходным кодом, написанный на Rust. Его делают с упором на скорость и отзывчивость интерфейса, а не на набор плагинов. Работает на macOS, Linux и Windows.

ИИ в Zed встроен в сам редактор: Agent Panel для задач, которые агент выполняет сам, Inline Assistant для правок по месту и предсказания правок по мере набора. Модели берутся у провайдера, которого вы выбираете в настройках.

Провайдером может быть подписка Zed Pro, ключ вендора или любой OpenAI-совместимый API. Последний вариант и закрывает вопрос с Россией: ключ Polza.ai работает без VPN и оплачивается в рублях.

## Почему ИИ в Zed не работает из России

Сам редактор скачивается и работает свободно. Упирается всё в провайдера моделей: встроенные ведут к зарубежным API и подписке Zed.

- **Zed Pro не оплатить.** Модели от самого Zed оплачиваются подпиской, а она оформляется зарубежной картой. Решение: Свой провайдер, карта РФ или СБП.
- **Встроенные провайдеры молчат.** Штатные API Anthropic, OpenAI и Google не обслуживают российские адреса: агент открывается, но на первом запросе отдаёт ошибку. Решение: Адрес Polza.ai отвечает из РФ напрямую.
- **Ключ на каждого вендора.** Чтобы сравнить Claude с GPT, нужны два провайдера, два ключа и два баланса. Решение: Один провайдер, весь каталог моделей.
- **Агент быстро тратит лимиты.** Агент читает десятки файлов за задачу, и лимиты тарифов кончаются быстрее, чем в обычном чате. Решение: Оплата за токены, лимиты не сгорают.
- **Юрлицу не провести оплату.** Зарубежную подписку не примет бухгалтерия, закрывающих документов нет. Решение: Договор, счёт, УПД и НДС.
- **Расход не отслеживается.** Zed показывает токены текущего треда, но не то, во что обошёлся месяц работы. Решение: Статистика по ключам и моделям в кабинете.

## Как подключить Zed к Polza.ai

Провайдер добавляется в интерфейсе за минуту. Ручная настройка в settings.json нужна, если хочется описать несколько моделей и их возможности.

Что нужно:

- **Zed.** macOS, Linux или Windows. Аккаунт Zed для своего ключа не нужен.
- **Ключ Polza.ai.** Создаётся в кабинете за минуту. Пополняется картой РФ, через СБП или по счёту для юрлица.
- **Модель с вызовом инструментов.** Агенту нужны tools — подойдут Claude, GPT, Qwen, GLM и DeepSeek из каталога.

### 1. Установите Zed

Скачайте редактор со страницы zed.dev/download — есть сборки для macOS, Linux и Windows. Также подойдут Homebrew, winget или скрипт установки:

Терминал · установка:

```
$ brew install --cask zed                     # macOS
$ winget install -e --id ZedIndustries.Zed    # Windows
$ curl -f https://zed.dev/install.sh | sh     # macOS и Linux
```

### 2. Добавьте провайдера

Откройте палитру команд и выполните `agent: open settings`. В разделе `LLM Providers` нажмите `Add Provider` и заполните поля. Ключ Zed сохранит в системной связке ключей:

Add Provider:

```
Provider name   polza
API URL         https://polza.ai/api/v1
API key         ваш ключ из кабинета
Model ID        anthropic/claude-sonnet-5.5
Context window  1000000
```

### 3. Или опишите в settings.json

Несколько моделей удобнее задать в `settings.json` в блоке `language_models.openai_compatible`. Ключ туда не пишите — Zed возьмёт его из связки ключей или из переменной `POLZA_API_KEY`, имя которой строится из ID провайдера:

settings.json:

```
{ "language_models": { "openai_compatible": {
  "polza": {
    "api_url": "https://polza.ai/api/v1",
    "available_models": [{
      "name": "anthropic/claude-sonnet-5.5",
      "display_name": "Claude Sonnet 5.5",
      "max_tokens": 1000000,
      "capabilities": { "tools": true, "images": true,
        "parallel_tool_calls": false, "prompt_cache_key": false }
}] } } } }
```

### 4. Выберите модель в Agent Panel

Откройте панель значком ✨ в строке состояния или командой `agent: new thread`. В выборе модели под полем ввода возьмите Claude Sonnet 5.5 у провайдера polza. Профиль `Write` даёт агенту право править файлы и запускать команды.

Agent Panel:

```
> вынеси разбор конфига в отдельный модуль и добавь тесты

  ✓ изменено 3 файла, тесты проходят
```

**Автодополнение настраивается отдельно.** Провайдер из `LLM Providers` обслуживает Agent Panel, Inline Assistant, сообщения коммитов и сводки тредов. Предсказания правок (Edit Prediction) задаются в отдельном блоке `edit_predictions`, и OpenAI-совместимый вариант там требует эндпоинт `/v1/completions`. В API Polza.ai его нет — модели работают через Chat Completions, поэтому для предсказаний остаются Zeta от Zed (входит в Zed Pro), GitHub Copilot или локальная модель через Ollama. [Открыть каталог моделей](https://polza.ai/models)

## Что умеет агент Zed

Agent Panel — основной ИИ-инструмент редактора. С провайдером Polza.ai он работает так же, как со встроенными моделями.

- **Правит код и запускает команды.** В профиле Write агент читает файлы, вносит правки и выполняет команды в терминале проекта.
- **Вопросы без правок.** Профиль Ask отвечает по кодовой базе только на чтение — удобно разбираться в чужом проекте.
- **Переключение моделей.** Модель меняется в выборе под полем ввода. Избранные помечаются звёздочкой и перебираются горячей клавишей.
- **Inline Assistant и коммиты.** Тот же провайдер работает во встроенном ассистенте правок и пишет сообщения коммитов.
- **MCP-серверы.** Агент подключает внешние инструменты через MCP: базы данных, трекеры задач, документацию.
- **Ключ не в конфиге.** Zed хранит ключ в системной связке ключей, а не в settings.json — файл настроек можно спокойно синхронизировать.

- **Add Provider в настройках.** Пять полей и одна модель — самый быстрый способ попробовать. Ключ сразу уходит в системную связку ключей.
- **Блок в settings.json.** Несколько моделей, их контекст и возможности: картинки, параллельные вызовы инструментов, глубина рассуждений. Ключ — через переменную `POLZA_API_KEY`.

## Zed, VS Code с Cline или OpenCode

Три способа работать с ИИ-агентом на своём ключе. Разница в том, где он живёт: в редакторе, в расширении или в терминале.

- **Zed.** Быстрый редактор со встроенным агентом. Подходит, если вы готовы сменить редактор или уже в нём работаете.
- **Cline.** Агент-расширение для VS Code и Cursor — если переезжать из привычного редактора не хочется. Под него есть отдельная страница.
- **OpenCode.** Терминальный агент, который работает рядом с любым редактором, включая Zed. Под него есть отдельная страница.

## Модели от Zed или свой ключ

| Из России | Модели от Zed | Zed со своим ключом |
| --- | --- | --- |
| Оплата | Зарубежная карта, в долларах | Карта РФ, СБП, счёт для юрлиц |
| Аккаунт Zed | Нужен вход | Не нужен |
| Модель оплаты | Подписка Zed Pro | За токены, лимиты не сгорают |
| Выбор моделей | Набор Zed | Claude, GPT, Qwen и ещё 400 |
| Agent Panel | Работает | Работает |
| Edit Prediction | Zeta в Zed Pro | Отдельный провайдер |
| Документы | Нет | Договор, счёт, УПД, НДС |

## Сколько стоит ИИ в Zed

Редактор бесплатный и с открытым кодом, подписка Zed Pro для своего ключа не нужна. Polza.ai берёт оплату только за израсходованные токены — по ценам каталога и в рублях.

- **Сложные задачи.** Claude Sonnet 5.5 и GPT-6.1 Sol — агентные правки по проекту, рефакторинг, отладка.
- **Универсальные.** Qwen 3.8 Max с окном на миллион токенов и GLM 5.3 — уверенная работа с инструментами, GLM заметно дешевле.
- **Экономичный режим.** DeepSeek V4.1 Flash — Inline Assistant, коммиты и короткие вопросы в разы дешевле.

- [anthropic/claude-sonnet-5.5](https://polza.ai/models/anthropic/claude-sonnet-5.5.md) — основная рабочая модель
- [openai/gpt-6.1-sol](https://polza.ai/models/openai/gpt-6.1-sol.md) — универсальная
- [qwen/qwen3.8-max](https://polza.ai/models/qwen/qwen3.8-max.md) — агентные задачи, окно 1M
- [z-ai/glm-5.3](https://polza.ai/models/z-ai/glm-5.3.md) — работа с кодом подешевле
- [deepseek/deepseek-v4.1-flash](https://polza.ai/models/deepseek/deepseek-v4.1-flash.md) — коммиты и короткие задачи

## Если агент не отвечает

Четыре причины, на которые приходится почти вся переписка с поддержкой.

- **Модель не появилась в выборе.** Проверьте, что провайдер сохранён в `LLM Providers`, а в `settings.json` нет синтаксических ошибок. Выбирайте модель именно у провайдера polza — он отмечен в списке отдельно.
- **Ошибка 401.** Ключ не сохранён, или в переменной `POLZA_API_KEY` старое значение: непустая переменная окружения важнее ключа из настроек. Уберите её и перезапустите Zed. Проверьте и баланс.
- **Модель не найдена.** В `name` нужен ID из каталога целиком: `anthropic/claude-sonnet-5.5`. Адрес — https://polza.ai/api/v1, без `/chat/completions` на конце.
- **Агент отвечает, но не правит файлы.** Выбран профиль `Ask` или `Minimal`, либо у модели выключены `tools`. Переключите профиль на `Write`.

## Частые вопросы

### Что такое Zed?

Редактор кода с открытым исходным кодом, написанный на Rust: быстрый, со встроенным ИИ-агентом и совместной работой. Есть сборки для macOS, Linux и Windows.

### Как скачать Zed?

Со страницы zed.dev/download, через Homebrew, winget или скрипт установки. Редактор бесплатный, а для работы с моделями по своему ключу аккаунт Zed не нужен.

### Нужна ли подписка Zed Pro?

Нет. Zed Pro — это модели, оплаченные через Zed. Со своим провайдером агент работает без подписки и без входа в аккаунт, а токены Polza.ai списывает с баланса в рублях.

### Какой адрес указывать?

https://polza.ai/api/v1 в поле API URL или в api_url. Путь /chat/completions Zed допишет сам.

### Где хранится ключ?

В системной связке ключей, если ввести его в настройках, или в переменной окружения POLZA_API_KEY. Непустая переменная важнее ключа из связки.

### Почему агент не вызывает инструменты?

У модели выключен tools или модель их не поддерживает. Claude, GPT, Qwen, GLM и DeepSeek из каталога Polza.ai инструменты поддерживают.

### Работает ли автодополнение через Polza.ai?

Нет: OpenAI-совместимый Edit Prediction требует эндпоинт /v1/completions, а API Polza.ai работает через Chat Completions. Для предсказаний используйте Zeta, Copilot или локальную модель.

### Можно ли прикладывать скриншоты?

Да, если в capabilities модели указать images: true. По умолчанию Zed считает, что OpenAI-совместимая модель картинки не принимает.

## Читать дальше

- [API нейросетей: единый ключ для ChatGPT, Claude и 400+ моделей](https://polza.ai/blog/api-neyrosetei.md)
- [Claude Sonnet 5: обзор модели — цены и бенчмарки](https://polza.ai/blog/claude-sonnet-5.md)
- [Агрегатор нейросетей: что это и лучшие сервисы 2026](https://polza.ai/blog/agregator-nejrosetej.md)

## Ссылки

- Быстрый старт: https://polza.ai/docs/glavnoe/quickstart
- Страница: https://polza.ai/integrations/zed
- Обновлено: 2026-11-05