|

Zed хочет сменить модель? Подключение к APIYI через OpenAI-совместимую конечную точку: 2 варианта конфигурации провайдера

ОтShark
Zed хочет сменить модель? Подключение к APIYI через OpenAI-совместимую конечную точку: 2 варианта конфигурации провайдера

Примечание автора: разберём три пути Agent в Zed, затем подключим APIYI к Zed через два кастомных Provider — OpenAI-compatible и Anthropic-compatible — и отдельно проговорим Base URL, ID моделей, стоимость и ключевые моменты диагностики.

Вы пишете код в Zed через панель Agent или Inline Assistant, хотите переключиться на другую модель — и видите в настройках несколько разделов: LLM Providers, External Agents, потоки терминала. Непонятно, куда вписывать ключ. Ещё чаще бывает так: указали сторонний шлюз, а в ответ стабильно приходит 404 или ошибка аутентификации. В этой статье — полный порядок действий по подключению стороннего шлюза моделей к Zed через кастомный Provider (OpenAI-compatible / Anthropic-compatible). На примере APIYI проходим настройку от начала до конца.

Это не очередная шпаргалка в духе «скопировал конфиг — и готово». Сначала разберём, где проходит граница подключения моделей для каждого из трёх AI-путей Zed, а затем дадим два маршрута, которые можно повторить шаг за шагом. Отдельно остановимся на самой частой ошибке: когда в Base URL нужно добавлять /v1, а когда — нет.

Главное: после статьи вы поймёте, какой именно уровень конфигурации вам нужно править, и сможете за 5 минут подключить к Zed Agent такие модели, как claude-opus-5-5 и claude-sonnet-5-5. А если что-то сломается — будете знать, что проверять первым.

zed-custom-llm-provider-openai-compatible-apiyi-ru-image-0

Смена модели в Zed: главное — сначала разобраться с тремя путями Agent

Zed — высокопроизводительный редактор для совместной работы, созданный командой, стоявшей за Atom / Tree-sitter. По состоянию на 13.11.2026 в репозитории zed-industries/zed на GitHub около 94 884 звёзд (по данным GitHub API). На официальной странице релизов указано, что 11.11.2026 стабильная версия — 1.28.1, а Preview в тот же день — 1.29.1. Версии для macOS, Linux и Windows можно скачать напрямую; веб-версия пока официально недоступна.

Прежде чем менять модель в Zed, важно понять одну вещь: в официальной документации AI-возможности разделены на три пути, и у каждого свой способ подключения моделей и аутентификации. Если указать настройки не в том месте, конфигурация не сработает, а ключ из одного пути не будет доступен другому.

Путь Откуда берётся модель Кто отвечает за аутентификацию Типичное использование
Zed Agent LLM Providers (хостинг Zed, ключ провайдера, подписка, шлюз, локальные модели) Сам Zed; ключ хранится в системном хранилище ключей Панель Agent, Inline Assistant, встроенные инструменты / profiles / skills / MCP
External Agents (ACP) Внешний Agent сам выбирает модель Внешний Agent сам управляет аутентификацией Запуск Claude Agent, Codex, OpenCode, Copilot, Cursor и др. в потоках Zed
Terminal Threads Определяется CLI / TUI, который вы запускаете Собственная конфигурация CLI Запуск разных Agent CLI прямо в терминальных потоках

Где проходит граница между Zed Agent и External Agent

«Сменить модель для Zed Agent» означает настроить LLM Providers, то есть уровень API Access, — это главная тема статьи. Официально поддерживаются основные провайдеры: Anthropic, OpenAI, Google AI, Mistral, DeepSeek, xAI и OpenCode; кроме того, есть два типа пользовательских эндпоинтов — Anthropic-compatible и OpenAI-compatible. Сторонние шлюзы подключаются именно через эти два типа пользовательских эндпоинтов.

Если вам нужно просто использовать Claude Agent или OpenCode в панели, это относится к External Agent и работает через Agent Client Protocol (ACP). В этом случае потоками управляет Zed, а за среду выполнения, аутентификацию и выбор модели обычно отвечает сам внешний Agent. Ключ, указанный в LLM Providers, не передаётся ему автоматически: Claude Agent нужно выполнить /login в своём потоке. Внешние Agent устанавливаются из реестра, который открывается командой zed: acp registry в палитре команд. По официальной документации, Zed не взимает отдельную плату за External Agents — счёт выставляет поставщик Agent.

zed-custom-llm-provider-openai-compatible-apiyi-ru-image-1

Ключевые моменты настройки кастомного провайдера в Zed

Разница между двумя типами кастомных эндпоинтов — прежде всего в формате запросов. OpenAI-compatible использует Chat Completions, Anthropic-compatible — Messages API (/v1/messages). Это различие напрямую определяет, как записывать Base URL, и заодно решает, получится ли воспользоваться тарификацией с Prompt Cache.

Параметр конфигурации OpenAI-compatible Anthropic-compatible
Формат запроса /v1/chat/completions /v1/messages
APIYI api_url https://api.apiyi.com/v1 https://api.apiyi.com (без /v1)
Поле модели available_models[].name + max_tokens available_models
Переключатели возможностей по умолчанию tools=true, images=false, chat_completions=true можно задать capabilities.prompt_caching
Тарификация кеша по документации APIYI не работает работает в нативном формате Messages
Подходящие сценарии один провайдер для нескольких моделей основная модель — Claude, длинный контекст, нужен кеш

Почему к одному Base URL добавляется /v1, а к другому — нет

Согласно Base URL FAQ APIYI (проверено по документации 2026-11-13), OpenAI-совместимый клиент просто дописывает /chat/completions к api_url, поэтому api_url нужно указывать до уровня /v1. Клиент на стороне Anthropic сам дописывает /v1/messages, так что там допустимо указывать только корневой домен. Если написать https://api.apiyi.com/v1, итоговый запрос превратится в /v1/v1/messages и сразу вернёт 404.

Есть ещё два момента, о которых стоит помнить. API Key в Zed хранится в системной связке ключей (keychain) и не записывается в settings.json; если соответствующая переменная окружения непустая, она имеет приоритет над связкой ключей. Кроме того, для моделей, поддерживающих только Responses API, нужно установить capabilities.chat_completions в false — иначе Zed будет обращаться к ним через Chat Completions.

Быстрый старт: подключаем Zed к APIYI

Из двух вариантов ниже можно выбрать один или настроить оба и переключаться между ними в списке моделей. Перед началом подготовьте ключ.

🚀 Быстрый старт: после входа создайте токен на странице токенов APIYI api.apiyi.com/token. Для Zed лучше сделать отдельный — так удобнее отслеживать расход и при необходимости отозвать его. В документации быстрого старта docs.apiyi.com/getting-started также есть skill.md / llms.txt, чтобы агент мог прочитать описание платформы.

Вариант A: подключаем Zed через OpenAI-совместимую конечную точку

  1. Откройте настройки агента: выполните в палитре команд agent: open settings. В разных версиях название пункта может немного отличаться — ориентируйтесь на блок LLM Providers на странице настроек AI / Agent.
  2. В блоке LLM Providers нажмите Add Provider и выберите тип OpenAI-compatible.
  3. Название провайдера придумайте сами, например apiyi. В settings.json ему соответствует language_models.openai_compatible.apiyi.
  4. В поле API URL укажите https://api.apiyi.com/v1. Здесь обязательно нужен /v1 — именно так указано на странице совместимости APIYI с OpenAI.
  5. Вставьте в API Key только что созданный токен — Zed сохранит его в системном хранилище ключей.
  6. Добавьте модель: в поле name укажите реальный ID из общего списка моделей APIYI, например claude-opus-5-5, claude-sonnet-5-5, можно также добавить claude-fable-5-2. max_tokens заполните по документации модели; если не уверены — начните с консервативного значения, а после успешного запуска увеличьте.
  7. Переключатели возможностей оставьте по умолчанию (tools=true). Если нужно отправлять изображения, включите images вручную.
  8. Вернитесь на панель Agent и найдите в списке моделей apiyi или название модели. В недавних версиях выбор модели поддерживает нечёткий поиск; после выбора отправьте сообщение для проверки.

Преимущество этого варианта в том, что один Provider может обслуживать модели от нескольких поставщиков. В документации APIYI указано: на OpenAI-совместимой конечной точке /v1/chat/completions достаточно изменить одну строку с названием модели, чтобы переключить модель.

Маршрут B: подключение Zed через эндпоинт Anthropic-compatible

  1. Точно так же зайдите в LLM Providers → Add Provider и выберите тип Anthropic-compatible.
  2. В поле API URL укажите https://api.apiyi.com, только корневой домен, без /v1. Фактический запрос пойдёт на нативный Anthropic-эндпоинт APIYI https://api.apiyi.com/v1/messages.
  3. Вставьте тот же токен или создайте отдельный специальный токен.
  4. В available_models добавьте claude-opus-5-5, claude-sonnet-5-5 и другие ID.
  5. Если хотите, чтобы длинные диалоги с большим контекстом использовали кеш, включите capabilities.prompt_caching. Как указано на странице возможностей Claude от APIYI, оплата кеша действует только в нативном формате Messages.
  6. В селекторе моделей выберите эту модель и отправьте сообщение для проверки.

💡 Совет по выбору: если в повседневной работе у вас в основном Claude, диалоги длинные и вы часто перечитываете одни и те же файлы, маршрут B выгоднее. Если нужно часто переключаться между несколькими моделями, маршрут A проще. Оба маршрута могут работать с одним и тем же токеном APIYI, а в селекторе моделей Zed можно переключаться в зависимости от задачи.

zed-custom-llm-provider-openai-compatible-apiyi-ru-image-2

Справочник цен на модели Claude (данные на 2026-11-13)

Данные взяты из сводной таблицы моделей APIYI и сверены с документацией на 2026-11-13. Единица — доллары США за 1M tokens, оплата по факту использования.

ID модели Ввод Вывод Чтение кэша Поддерживаемые эндпоинты Доступные платформы
claude-opus-5-5 $4 $20 $0.2 chat + messages APIYI apiyi.com
claude-opus-5-5-thinking как у opus-5-5 как у opus-5-5 как у opus-5-5 по сводной таблице APIYI apiyi.com
claude-sonnet-5-5 $2 $10 $0.1 по сводной таблице APIYI apiyi.com
claude-fable-5-2 $8 $40 $0.2 по сводной таблице APIYI apiyi.com

Модель и цены — по списку моделей платформы. Перед настройкой можно открыть docs.apiyi.com/models и проверить актуальные на сегодня цифры и группы (в сводной таблице у claude-opus-5-5 есть группы ClaudeCode, Claude_Reverse, Claude_Enterprise, Default, SVIP и другие).

Что касается ограничений использования claude-opus-5-5, в новости о запуске APIYI (2026-09-23) упоминаются три момента: thinking нельзя перевести в disabled; если задать tool_choice как any / tool, вернётся 400; effort по умолчанию — medium. Если в Zed Agent при вызове инструментов появляется 400, в первую очередь проверьте эти пункты.

Устранение частых ошибок при использовании кастомных эндпоинтов в Zed

Когда кастомный провайдер выдаёт ошибку, чаще всего проблема кроется в одном из трёх мест: URL, ключ или название модели. В таблице ниже они отсортированы по частоте — можно проверять по пунктам.

Симптом Частая причина Что делать
404 Not Found В Anthropic-compatible указан /v1, путь стал /v1/v1/messages Вернуть корневой домен https://api.apiyi.com
404 / неверный путь В OpenAI-compatible пропущен /v1 Указать https://api.apiyi.com/v1
401 / ошибка аутентификации Неверный токен, токен удалён или переменная окружения перекрыла связку ключей Перепроверить на api.apiyi.com/token, очистить конфликтующие переменные окружения
Модель не существует Опечатка в ID или использован псевдоним Скопировать исходный ID с docs.apiyi.com/models
400 (вызов инструментов) tool_choice равен any / tool, или попытка отключить размышления Настроить согласно актуальной документации
Невалидные изображения В OpenAI-compatible по умолчанию images=false Включить images в capabilities
Ошибка моделей, поддерживающих только Responses Всё ещё вызывается через Chat Completions Установить capabilities.chat_completions в false

🎯 Совет по отладке: если получили 404, сначала дословно сверьте api_url из настроек Zed с Base URL FAQ APIYI (docs.apiyi.com/faq/base-url-config). В большинстве случаев дело в лишнем или недостающем /v1.

zed-custom-llm-provider-openai-compatible-apiyi-ru-image-3

Предупреждение о рисках использования кастомного Provider в Zed

  • Неофициальный хостинг: кастомные Provider, совместимые с OpenAI / Anthropic, — это универсальная возможность подключения, которую предоставляет Zed; сторонние шлюзы не входят в официальные хостинговые сервисы Zed. При проблемах с сервисом нужно обращаться к оператору шлюза.
  • Ключи и оплата — на вас: токены и оплата за использование привязаны к вашему аккаунту. Советуем создать для Zed отдельный токен, регулярно проверять расход и не записывать Key в settings.json с последующим коммитом в репозиторий. По умолчанию Zed хранит данные в связке ключей, что само по себе снижает этот риск.
  • Условия External Agent определяет его провайдер: подписки, квоты и условия использования внешних агентов вроде Claude Agent и Codex определяются их провайдерами и не зависят от конфигурации Provider для Zed Agent.
  • Различия между версиями: описание интерфейса в этой статье основано на официальной документации и информации из releases для 1.28.x / 1.29.x (дата наблюдения — 2026-11-13); в последующих версиях названия пунктов меню могут измениться.

Частые вопросы (FAQ)

Вопрос 1: что такое OpenAI-совместимый эндпоинт в Zed?

Это тип кастомного провайдера в разделе LLM Providers. Если серверная сторона реализует интерфейс Chat Completions, её можно подключить к Zed Agent через `api_url` и список моделей — ждать официальной поддержки от Zed не придётся.

Вопрос 2: ключ, прописанный в LLM Providers, можно сразу использовать в Claude Agent?

Нет. Claude Agent — это External Agent, авторизацией он управляет сам, поэтому нужно выполнить `/login` в его потоке. Ключ из LLM Providers используется только для Zed Agent.

Вопрос 3: какой вариант выбрать — OpenAI-compatible или Anthropic-compatible?

Если основная работа на Claude и нужен биллинг с учётом кеша — выбирайте Anthropic-compatible. Если хочется через одного провайдера подключить несколько моделей — OpenAI-compatible. Согласно документации APIYI, кеш-биллинг работает только в нативном формате Messages.

Вопрос 4: какой ID модели указывать?

Указывайте исходный ID из сводной таблицы моделей платформы, например `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-fable-5-2`. Лучше копировать прямо со страницы docs.apiyi.com/models, чтобы из-за опечатки не получить ошибку «模型不存在» («модель не найдена»).

Вопрос 5: после настройки стабильно приходит 404 — как разобраться?

Сначала проверьте `/v1`: в OpenAI-compatible он обязателен, в Anthropic-compatible его быть не должно. Если с путём всё в порядке, сверьте ID модели со списком моделей APIYI.

Вопрос 6: где хранится API Key? Попадёт ли он в репозиторий?

Zed хранит ключ в системной связке ключей и не записывает его в settings.json, так что при передаче файла настроек ключ с собой не уйдёт. Но есть нюанс: если одноимённая переменная окружения не пустая, она имеет приоритет над связкой ключей — при диагностике 401 не забудьте проверить переменные окружения.

Вопрос 7: какие известные ограничения есть у такой конфигурации?

В OpenAI-compatible по умолчанию не включены возможности работы с изображениями; у `claude-opus-5-5` нельзя отключить «размышления», а `tool_choice` со значениями any / tool возвращает 400. Кроме того, кастомный провайдер — это не официальный хостинг Zed, и стабильность зависит от стороны шлюза.

Zed и APIYI: ключевые моменты

  • Сначала разберитесь с путями: Zed Agent работает через LLM Providers, а External Agent сам отвечает за аутентификацию.
  • Два типа эндпоинтов: OpenAI-compatible использует chat, Anthropic-compatible — messages.
  • Правило для URL: для OpenAI-совместимого указывайте /v1, для нативного Claude — только корневой домен.
  • ID модели: копируйте исходные ID вроде claude-opus-5-5 из сводной таблицы моделей APIYI.
  • Кэширование и биллинг: если нужен кэш, используйте Anthropic-compatible и включите prompt_caching.
  • Порядок диагностики: последовательно проверяйте /v1, токен, ID модели и параметры инструментов.
  • Как начать: создайте отдельный токен на api.apiyi.com/token — вся настройка занимает 5 минут.

Итог

Чтобы сменить модель в Zed, главное — понять, какой именно уровень вы меняете:

  1. Смена модели для Zed Agent: в LLM Providers нажмите Add Provider и добавьте эндпоинт OpenAI-compatible или Anthropic-compatible.
  2. External Agent: Claude Agent, OpenCode и другие аутентифицируются самостоятельно, их ключ не общий с Zed Agent.
  3. Base URL: для OpenAI-совместимого указывайте https://api.apiyi.com/v1, для Anthropic-совместимого — https://api.apiyi.com; лишний или пропущенный /v1 даст 404.

Перед настройкой сверьте актуальные модели и цены на docs.apiyi.com/models, а затем создайте отдельный ключ для Zed на странице токенов. Сначала добейтесь работоспособности на claude-sonnet-5-5, а потом переключайтесь на claude-opus-5-5 в зависимости от задачи. Через APIYI на apiyi.com можно с одним и тем же токеном сравнить результат работы обоих провайдеров.

📚 Справочные материалы

  1. Репозиторий Zed на GitHub: исходный код и количество звёзд (по состоянию на 2026-11-13)
  2. Ссылка: github.com/zed-industries/zed

  3. Пояснение: основная лицензия — GPL-3.0-or-later, также есть компоненты под Apache-2.0

  4. Zed AI Overview: официальное описание трёх способов работы с AI

  5. Ссылка: zed.dev/docs/ai/overview

  6. Пояснение: границы между Zed Agent, External Agents и Terminal Threads

  7. Zed Use API Access: настройка собственного Provider

  8. Ссылка: zed.dev/docs/ai/use-api-access

  9. Пояснение: поля OpenAI-compatible / Anthropic-compatible и хранение в связке ключей

  10. Zed External Agents: внешние Agent по ACP

  11. Ссылка: zed.dev/docs/ai/external-agents

  12. Пояснение: способы подключения Claude Agent, Codex, OpenCode и других

  13. Zed Releases: записи об обновлениях версий

  14. Ссылка: zed.dev/releases/stable

  15. Пояснение: содержимое обновлений стабильной версии 1.28.1 и Preview

  16. Сводная таблица моделей APIYI: ID моделей и цены

  17. Ссылка: docs.apiyi.com/models.md

  18. Пояснение: цены за ввод / вывод / чтение кэша; сверяйтесь со списком на текущий день

  19. FAQ по настройке Base URL в APIYI: правила /v1

  20. Ссылка: docs.apiyi.com/faq/base-url-config.md

  21. Пояснение: различия в записи Base URL для OpenAI-совместимого варианта и нативного Claude

  22. Страница возможностей Claude в APIYI: нативные и совместимые эндпоинты

  23. Ссылка: docs.apiyi.com/api-capabilities/claude.md

  24. Пояснение: биллинг кэша действует только в формате Messages

  25. Новость о запуске claude-opus-5-5 в APIYI: ограничения использования

  26. Ссылка: docs.apiyi.com/live/2026-09/claude-opus-5-5.md
  27. Пояснение: описание значений по умолчанию для режима размышления, tool_choice и effort

Автор: техническая команда APIYI
Техническая поддержка: если возникнут проблемы с настройкой, загляните в центр документации docs.apiyi.com или свяжитесь с нами через главную страницу сайта APIYI

Читайте также

Похожие записи