Zed с Claude и GPT: настройка через свой API-ключ

Коротко

Чтобы использовать Zed с APIVAI, откройте Agent Settings (команда agent: open settings), нажмите Add Provider в разделе LLM Providers и добавьте OpenAI-совместимого провайдера с API URL https://api.apivai.com/v1, вашим ключом APIVAI и ID модели, например claude-sonnet-4-6 или gpt-5.5; в settings.json это запись language_models.openai_compatible. Для Claude в родном формате можно вместо этого добавить Anthropic-совместимого провайдера с адресом https://api.apivai.com без /v1, потому что Zed сам добавляет /v1/messages. На 2026-10-10 Claude Sonnet 4.6 через APIVAI стоит $1.15 / $5.74 за миллион входных / выходных токенов против официальных $3.00 / $15.00. Оплата идёт за токены с предоплаченного баланса, без подписки.

Что такое Agent Panel в Zed и зачем подключать свой API?

Zed — быстрый редактор кода с открытым исходным кодом и встроенным AI-агентом. Zed Agent работает в Agent Panel: читает проект, правит файлы, вызывает инструменты и показывает каждое изменение, чтобы вы могли его проверить или откатить. Те же настройки моделей используются для Inline Assistant, генерации сообщений коммитов в Git и кратких сводок тредов.

Zed умеет работать со своими размещёнными моделями, но принимает и любого провайдера с API-ключом. Здесь и пригодится APIVAI: один ключ даёт доступ к моделям Claude и GPT с оплатой за токены (для большинства моделей ниже официальных цен), с баланса, который вы пополняете по мере необходимости. Ключ работает и в формате OpenAI, и в формате Anthropic, поэтому подходит для обоих типов пользовательских провайдеров Zed.

Какой тип провайдера выбрать в Zed?

В Zed есть два вида пользовательских эндпоинтов, которые работают с APIVAI:

	OpenAI-compatible	Anthropic-compatible
Ключ в настройках	`openai_compatible`	`anthropic_compatible`
API URL	`https://api.apivai.com/v1`	`https://api.apivai.com` (без `/v1`)
Модели	Claude и GPT	Только Claude
Что вызывает Zed	`/chat/completions`	`/v1/messages`
Лучше всего для	Одного провайдера для всех моделей	Claude в родном формате Messages, кэширования промптов

Начните с OpenAI-compatible: один провайдер покрывает Claude и GPT, а модель переключается одним щелчком в Agent Panel. Добавьте ещё и Anthropic-compatible, если в основном работаете с Claude и хотите родной формат запросов Claude в Zed, включая кэширование промптов. Оба провайдера можно настроить одновременно с одним и тем же ключом.

Как настроить Zed с APIVAI по шагам?

Шаг 1: Создайте ключ APIVAI

Зарегистрируйтесь на apivai.com по email.
Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Бесплатного пробного периода нет: вы платите только за использование.
Откройте Панель, создайте ключ и скопируйте его. Ключу можно задать собственный лимит бюджета, чтобы агент никогда не потратил больше запланированного.

Шаг 2: Добавьте OpenAI-совместимого провайдера

Быстрее всего через интерфейс настроек:

Выполните agent: open settings из палитры команд (или откройте Settings → AI → LLM Providers).
Нажмите Add Provider и заполните имя провайдера, API URL, ID модели и размер контекстного окна по таблице ниже.
Вставьте ключ APIVAI в поле ключа провайдера. Zed хранит его в системной связке ключей, а не в settings.json.

Поле	Значение
Имя провайдера	`apivai`
API URL	`https://api.apivai.com/v1`
API-ключ	Ваш ключ APIVAI
ID модели	`claude-sonnet-4-6` (или любой ID из `GET /v1/models`)
Контекстное окно	`200000`

Если вам удобнее править settings.json, тот же провайдер с двумя моделями выглядит так:

{
  "language_models": {
    "openai_compatible": {
      "apivai": {
        "api_url": "https://api.apivai.com/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-6",
            "display_name": "Claude Sonnet 4.6 (APIVAI)",
            "max_tokens": 200000,
            "max_output_tokens": 16384
          },
          {
            "name": "gpt-5.5",
            "display_name": "GPT-5.5 (APIVAI)",
            "max_tokens": 128000,
            "max_output_tokens": 16384
          }
        ]
      }
    }
  }
}

Важны три детали. В Zed max_tokens — это контекстное окно, а не длина ответа; лимит ответа задаёт max_output_tokens. api_url должен заканчиваться на /v1 ровно один раз, потому что Zed добавляет к нему /chat/completions. А ключ никогда не пишется в settings.json: введите его в интерфейсе или задайте переменную окружения, которую Zed выводит из ID провайдера (верхний регистр плюс _API_KEY, то есть apivai превращается в APIVAI_API_KEY), и перезапустите Zed.

Чтобы узнать, какие ID моделей доступны вашему ключу, выполните:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

Список моделей со временем меняется, поэтому копируйте ID из этого ответа или со страницы цен, а не из старых инструкций.

Шаг 3 (по желанию): Anthropic-совместимый провайдер для Claude

В Add Provider выберите Anthropic и укажите https://api.apivai.com как API URL, либо добавьте рядом с блоком выше:

"anthropic_compatible": {
  "apivai-claude": {
    "api_url": "https://api.apivai.com",
    "available_models": [
      {
        "name": "claude-sonnet-4-6",
        "display_name": "Claude Sonnet 4.6 (APIVAI native)",
        "max_tokens": 200000,
        "max_output_tokens": 16384,
        "capabilities": {
          "tools": true,
          "images": false,
          "prompt_caching": true
        }
      }
    ]
  }
}

Не добавляйте здесь /v1. Клиент Anthropic в Zed сам дописывает к API URL /v1/messages, поэтому https://api.apivai.com/v1 превратится в /v1/v1/messages и вернёт 404. Параметр prompt_caching заставляет Zed отправлять точки кэширования, и повторяющийся контекст оплачивается по цене чтения из кэша ($0.12 за 1M для Claude Sonnet 4.6). Ключ введите в интерфейсе настроек провайдера. Подробнее об этом формате — на странице прокси для Claude API.

Шаг 4: Выберите модель в Agent Panel

Откройте Agent Panel и нажмите на селектор модели в редакторе сообщения. Модели APIVAI отображаются под выбранным вами именем провайдера; убедитесь, что выбираете запись APIVAI, а не модель с тем же названием от другого провайдера. Чтобы сделать её моделью по умолчанию, задайте agent.default_model в settings.json с именем провайдера и ID модели.

Какую модель выбрать в Zed?

Агент отправляет запрос на каждом шаге, поэтому цена токена важна. Цены за 1M входных / выходных токенов на 2026-10-10:

ID модели	Цена (вход / выход)	Для чего
`claude-sonnet-4-6`	$1.15 / $5.74	Выбор по умолчанию для повседневного кода
`claude-sonnet-5-5`	$0.77 / $3.82	Повседневный код, более новый Sonnet
`claude-opus-5-5`	$1.54 / $7.65	Сложные баги, крупный рефакторинг
`claude-haiku-4-5`	$0.38 / $1.92	Inline Assistant, сообщения коммитов, мелкие правки
`gpt-5.5`	$0.77 / $4.56	Альтернатива на GPT, второе мнение
`gpt-6-luna`	$0.0144 / $0.0768	Очень дешёвые простые задачи

Практичная схема: Claude Sonnet 4.6 или Claude Sonnet 5.5 для агента, Claude Opus 5.5, когда задача раз за разом не получается, и Claude Haiku 4.5 для быстрых правок через Inline Assistant. Модели GPT работают только через OpenAI-совместимого провайдера.

Сколько стоит Zed с APIVAI?

Каждый шаг агента заново отправляет тред и прочитанные файлы, поэтому основную часть счёта составляют входные токены. Два реалистичных примера с Claude Sonnet 4.6:

Одна средняя задача, например исправление бага в нескольких файлах: около 15 запросов по 25 000 входных и 1 500 выходных токенов. Стоимость: $0.56 с APIVAI, $1.46 по официальным ценам.
Рабочий месяц по две такие задачи в день в течение 22 дней (660 запросов): $24.66 с APIVAI, $64.35 по официальным ценам.

Тот же месяц на Claude Haiku 4.5 обойдётся в $8.17. В расчётах не учтено кэширование промптов, а токены размышлений включены в число выходных, поскольку оплачиваются как выходные. В Панели видны все запросы с токенами и стоимостью, так что уже через день вы сможете заменить эти допущения своими цифрами. Более широкое сравнение — в статье цены Claude API в 2026 году.

Как исправить частые ошибки Zed?

401 Unauthorized: ключ не задан, скопирован не полностью, удалён или исчерпал бюджет. Введите его заново в настройках провайдера. Непустая переменная окружения имеет приоритет над значением из связки ключей, так что проверьте и APIVAI_API_KEY.
404 Not Found: почти всегда дело в /v1. Для OpenAI-compatible нужен https://api.apivai.com/v1 (без /chat/completions в конце); для Anthropic-compatible — https://api.apivai.com без /v1.
Модель не найдена: name должен быть точным ID, например claude-sonnet-4-6, а не отображаемым названием. Сверьте его с GET /v1/models.
Пустые или оборванные ответы: размышления включены по умолчанию и расходуют выходные токены. Увеличьте max_output_tokens до 8192 или больше (минимум 4096).
429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ. Длинные задачи агента могут упереться в лимит; подождите немного или попросите поддержку его увеличить.

Общие правила форматов — на странице OpenAI-совместимый API и в документации.

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

Можно ли использовать Claude и GPT в Zed с одним ключом?

Да. Добавьте одного OpenAI-совместимого провайдера с обоими ID моделей в available_models и переключайтесь между ними в селекторе модели.

Какой API URL указывать в Zed?

https://api.apivai.com/v1 для OpenAI-совместимого провайдера и https://api.apivai.com для Anthropic-совместимого, потому что Zed сам добавляет /v1/messages.

Работает ли это для Edit Prediction в Zed?

Нет. У Edit Prediction своя настройка провайдера; провайдеры из этой статьи обслуживают Zed Agent, Inline Assistant, сообщения коммитов и сводки тредов.

Хранит ли APIVAI мой код?

Нет. Содержимое запросов и ответов не записывается. Для биллинга сохраняются только данные об использовании: модель, число токенов и стоимость.

Можно ли использовать тот же ключ в других редакторах?

Да. Тот же ключ работает в Cline, Continue и терминальных агентах вроде OpenCode. Отдельный ключ для каждого инструмента упрощает чтение Панели.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Zed.