# Вайб-кодинг в zed dev: Настройка AI агентов через RouterAI (Claude, GPT-5)

**В этой статье** мы превращаем **[Zed](https://zed.dev/)** — самый быстрый редактор современности — в **интеллектуальный центр** разработки. Мы подключим любые ИИ-модели (на примере **Claude Sonnet 5.5**, **Claude Haiku 5.5**, **Gemini 3.1 Pro**, **DeepSeek V4 Flash**, **GPT-5.5**) напрямую в нативный интерфейс Zed без установки тяжелых плагинов. Вы получите агента с оплатой в рублях, который глубоко понимает контекст проекта, работает со скоростью 120 FPS и доступен без VPN.

## 1. Введение: Zed + AI. Скорость имеет значение {#1-zed-ai-speed}

Если вы перешли на Zed, вы уже знаете, что такое скорость. Мгновенный запуск, рендеринг на GPU и отзывчивость, о которой VS Code может только мечтать. Но современный кодинг — это не только скорость набора текста, это работа с ИИ.

В Zed функционал ИИ-ассистента встроен прямо в ядро редактора. Не нужно устанавливать сторонние расширения вроде Copilot или Continue. Однако, как и везде, есть нюансы:

* **Ограниченный выбор из коробки:** По умолчанию Zed предлагает использовать OpenAI или Anthropic, что требует зарубежных карт и VPN.
* **Vendor Lock-in:** Вы не можете гибко переключаться между новыми моделями, которые выходят каждую неделю (например, попробовать DeepSeek или Qwen), если они официально не добавлены в интерфейс.
* **Сложности с оплатой:** Для разработчиков из РФ оплата подписки на Claude или ChatGPT API — это сложный квест.

### Решение: Native Zed + RouterAI

Мы будем использовать  **нативный интерфейс Zed** (Agent Panel и Inline Assistant), а доступ ко всем моделям подключим через **[RouterAI](/ "RouterAI")**.

Это дает идеальную связку:

1. **Zed:** Обеспечивает интерфейс, контекст проекта и молниеносную работу.
2. **RouterAI:** Предоставит топовые модели (GPT-5.5, Claude 5.5, Gemini 3.1, DeepSeek V4 и др.) через единый API-ключ.

Вы получаете доступ к лучшим мировым моделям без VPN, с оплатой российскими картами и в самом быстром редакторе мира.

## 2. Что такое Zed Assistant? {#2-what-is-zed-assistant}

В отличие от VS Code, где AI — это плашка сбоку, в Zed это часть workflow. Инструмент закрывает два основных сценария:

* **Agent Panel (команда `agent: new thread` или значок ✨ в строке состояния):** Полноценный чат-агент, который читает и редактирует файлы проекта, запускает команды и управляет контекстом. Это как ChatGPT, но который живет внутри вашего редактора и знает о ваших файлах.
* **Inline Assistant (Ctrl+Enter):** Вы пишете промпт прямо в коде, и нейросеть генерирует или правит код в реальном времени, показывая diff перед принятием.

## 3. RouterAI: получаем ключ ко всем моделям {#3-routerai-key}

Чтобы Zed использовал Claude 5.5 или DeepSeek, нам нужен шлюз. **[RouterAI](/ "RouterAI")** агрегирует доступ к сотням моделей.

На RouterAI есть [список доступных моделей](/models "Список доступных моделей"). Вы можете использовать любые идентификаторы оттуда (например, `anthropic/claude-sonnet-5.5`, `google/gemini-3.1-pro-preview`).

**Почему это маст-хэв для Zed в РФ?**

* **OpenAI Compatible:** Zed умеет работать с любым API, который поддерживает формат OpenAI.
* **Доступ без VPN:** Вам доступны модели Anthropic (Claude), Google (Gemini), xAI (Grok) и другие напрямую.
* **Оплата:** Российские карты, СБП и **безнал для юрлиц** с закрывающими документами.
* **Командные аккаунты:** Можно выдать ключи всей команде разработчиков и следить за бюджетом в одном месте.

**Алгоритм действий:**

1. Переходим на [RouterAI](/ "RouterAI").
2. Регистрируемся и пополняем баланс (для теста хватит минимальной суммы).
3. В разделе **«Ключи API»** создаем новый ключ.

> **Важно:** Скопируйте ключ (`sk-...`) сразу, больше его не покажут.

## 4. Техническая часть: Настройка Zed {#4-tech-setup-zed}

В Zed всё настраивается через JSON-конфиги. Разберемся как открыть и настроить конфиг.

В меню жмем на "Zed" -> "Open Settings" -> "Edit in settings.json"

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/store/pages/zed_config.png)

Ниже пример моего `settings.json`. Можете заменить свой полностью или частично.

```json
{
  "agent": {
    "default_model": {
      "provider": "RouterAI",
      "model": "anthropic/claude-sonnet-5.5"
    },
    "model_parameters": []
  },
  "language_models": {
    "openai_compatible": {
      "RouterAI": {
        "api_url": "https://routerai.ru/api/v1",
        "available_models": [
          {
            "name": "anthropic/claude-sonnet-5.5",
            "display_name": "Claude Sonnet 5.5 (RouterAI)",
            "max_tokens": 1000000,
            "max_output_tokens": 32000,
            "max_completion_tokens": 200000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "anthropic/claude-haiku-5.5",
            "display_name": "Claude Haiku 5.5 (RouterAI)",
            "max_tokens": 1000000,
            "max_output_tokens": 32000,
            "max_completion_tokens": 200000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "google/gemini-3.1-pro-preview",
            "display_name": "Gemini 3.1 Pro (RouterAI)",
            "max_tokens": 1048576,
            "max_output_tokens": 32000,
            "max_completion_tokens": 200000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "deepseek/deepseek-v4-flash",
            "display_name": "DeepSeek V4 Flash (RouterAI)",
            "max_tokens": 1048576,
            "max_output_tokens": 32000,
            "max_completion_tokens": 100000,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          },
          {
            "name": "openai/gpt-5.5",
            "display_name": "GPT-5.5 (RouterAI)",
            "max_tokens": 1050000,
            "max_output_tokens": 32000,
            "max_completion_tokens": 200000,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          }
        ]
      }
    }
  }
}
```

**Разбор параметров:**

* `api_url`: `https://routerai.ru/api/v1`.
* `available_models`: Мы перечисляем модели, которые хотим видеть в выпадающем списке Zed.
* `name`: Идентификатор модели из [каталога RouterAI](/models "каталога RouterAI").
* `display_name`: То, как модель будет называться в интерфейсе.
* `max_tokens`: Размер контекстного окна модели (значения взяты из каталога RouterAI).

Чтобы все заработало нам осталось указать ключ от RouterAI, ключ можно задать через переменную окружения ROUTERAI_API_KEY=\<your api key> (Zed формирует имя переменной из названия провайдера в `settings.json`), либо через интерфейс Zed как на скриншоте ниже.

Откроем правую панель хоткеем Ctrl + Alt + B, либо через меню View -> "Toggle Right Dock".

![Настройка routerai api key в редакторе zed.dev](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/store/pages/zed_config2.png)В правой панели жмем на "..." -> "Settings" -> "RouterAI" -> прописываем ключ.

В актуальных версиях Zed ключ можно ввести и на странице настроек агента: выполните в палитре команд `agent: open settings` и найдите провайдера в разделе LLM Providers. Ключ, сохранённый через интерфейс, хранится в системной связке ключей, а не в `settings.json`.

Настройка завершена. Теперь в нижней части правой панели мы можем выбрать AI агента с которым готовы начать работу.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/store/pages/zed_select_model.png)

### Работа с правилами в Zed.

Правила это текстовые инструкции на естественном языке о которых Zed всегда "помнит" и применяет ко всем вашим взаимодействиям с агентами. Правила заставляют агента вести себя одинаково в разных сессиях и помнить о важных деталях.

Чтобы добавить правила в проект создайте файл `.rules` в корне проекта и Zed автоматически будет применять его. В актуальных версиях Zed такие инструкции называются Instructions: файл `.rules` по-прежнему поддерживается, а также можно использовать `AGENTS.md`.

Вот пример файла с правилами.

```
- приложение работает через docker compose в контейнере web, учитывай это когда нужно выполнить команды в консоли
- вся документация по проекту лежит в папке docs, не забывай актуализировать документацию если что то меняешь
- никогда не используй hardcoded строки на русском в коде
- эталонная локаль - русская (ru)
- После изменений в файлах локали запускай скрипт для проверки bin/compare_locales.rb
```

Подробнее об инструкциях для агента читайте в [официальной документации](https://zed.dev/docs/ai/instructions "официальной документации").

## 5. Workflow: Как это работает на практике {#5-workflow}

Теперь у вас есть супер-быстрый ИИ. Разберем сценарии.

### А. Agent Panel (Умный чат)

Откройте панель агента. Выберите модель (рекомендую **Claude Sonnet 5.5** для сложной логики).

**Кейс: Контекстный поиск**

* **Промпт:** `Добавь в админку возможность поиска по Email в разделе со счетами.`
* **Результат:** Zed отправляет содержимое файлов через RouterAI, а модель возвращает ответ с подсветкой синтаксиса.

**![Пример работы zed.dev через RouterAI](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/store/pages/zed_example.png)**

### Б. Inline Assistant (Рефакторинг на лету)

Это самая мощная фишка Zed. Поставьте курсор в любое место кода или выделите фрагмент.

1. Нажмите `Ctrl + Enter`.
2. Появится небольшое окно ввода.
3. Напишите: Добавь параметр назначение платежа.

![1.00](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/store/pages/zed_inline_example.png)

Zed покажет **Diff** (разницу) прямо в редакторе. Вы увидите, что удаляется и что добавляется. Нажмите `Tab`, чтобы принять изменения, или `Esc`, чтобы отменить.

## 6. Нюансы работы ("Short-lived sessions") {#6-sessions}

Как и в любой работе с нейросетями, в Zed важно следить за чистотой контекста. Zed хранит историю чата в Agent Panel. Если вы полдня обсуждаете разные задачи в одном чате, вы:

1. Тратите лишние токены (деньги).
2. Запутываете модель и получаете плохие результаты.

**Правило:** Новая задача = Кнопка "New thread" (значок плюса или `Cmd+N` / `Ctrl+N` в панели агента).

Также, на странице [статистики в RouterAI](/settings/activity "Статистика RouterAI") вы всегда можете проверить, какая модель обходится вам дешевле, и скорректировать свой выбор в `settings.json`.

## 7. Заключение {#7-conclusion}

Связка **Zed + RouterAI** — это выбор прагматичного разработчика. Вы получаете:

1. **Производительность:** Интерфейс не лагает, даже когда ИИ генерирует простыни кода.
2. **Свободу выбора:** Хотите Claude для рефакторинга, а DeepSeek для написания тестов? Просто выберите их в списке.
3. **Комфорт:** Все работает из РФ, оплата в рублях, никаких VPN и блокировок.

Эра "Copy-Paste Driven Development" уходит в прошлое. Теперь ИИ — это часть вашего редактора. Попробуйте настроить этот конфиг за 5 минут, и вы удивитесь, насколько приятнее станет процесс написания кода.

Приятного вайб-кодинга! 🚀