Подключите Zed к Claude через шлюз

Zed работает быстро, а его ассистент действительно полезен, но настройка собственного адреса Claude находится не там, где большинство пользователей ищет её в первую очередь. Встроенный провайдер Anthropic не позволяет переопределить базовый URL, поэтому удобный способ подключения к шлюзу — через блок openai_compatible в Zed.

Почему не провайдер Anthropic

В Zed есть встроенный провайдер Anthropic, и естественно сначала попробовать направить его на шлюз. Но у этого провайдера нет настройки api_url, поэтому нет поддерживаемого поля, позволяющего перенаправить его со стандартного хоста Anthropic.

Именно из-за этого ограничения многие заходят в тупик. Вместо попыток его обойти направьте запросы к Claude через универсальный механизм openai_compatible: он позволяет задать базовый URL и предназначен именно для сторонних адресов API.

Полезно представить встроенный провайдер как жёстко привязанный к одному адресу, а провайдер openai_compatible — как настраиваемый. Для многомодельного шлюза настраиваемый вариант в любом случае предпочтителен: один и тот же блок может обеспечивать доступ к Claude и любой другой модели шлюза через единый api_url. Это позволяет держать все настройки моделей редактора в одном месте, а не распределять их между двумя механизмами провайдеров с разными правилами. Это решение определяет всю дальнейшую настройку, поэтому стоит разобраться с ним до внесения изменений. Когда вы примете, что блок openai_compatible — поддерживаемый способ подключения, останется лишь заполнить поля.

Добавьте блок openai_compatible

В settings.json, в разделе language_models.openai_compatible, добавьте именованный провайдер. Задайте в его api_url адрес шлюза с /v1 в конце; Zed добавляет к нему /chat/completions, поэтому на запросы отвечает совместимый с OpenAI интерфейс шлюза.

Имя можно выбрать произвольно: оно станет названием в меню моделей Zed. Один блок может обслуживать несколько моделей Claude, каждую из которых вы объявите на следующем шаге.

Суффикс /v1 здесь критически важен: Zed строит путь chat-completions непосредственно относительно значения api_url, поэтому без /v1 запросы уйдут по неверному адресу, а завершающий слеш может привести к дублированию пути. Укажите ровно адрес хоста с /v1, и маршрутизация будет работать корректно. Быстрая перезагрузка настроек после изменения позволяет убедиться, что Zed разобрал блок без ошибок. Если провайдер не появился, сначала проверьте блок на синтаксическую ошибку JSON.

Объявите available_models

Zed не обнаруживает модели автоматически по пользовательскому адресу API, поэтому перечислите их вручную в available_models. Каждая запись должна содержать name, совпадающее с идентификатором модели на шлюзе, display_name для меню и значение max_tokens, соответствующее модели.

Используйте claude-sonnet-4-5 для повседневной помощи и добавьте claude-opus-4-8 второй записью для самых сложных задач. Поскольку вы перечисляете модели явно, в меню отображается только заданный вами набор.

Поле name должно посимвольно совпадать с идентификатором модели на шлюзе, а display_name влияет только на отображение и может содержать любое удобное название для меню. Неверное name — частая причина того, что модель появляется в меню, но выдаёт ошибку при использовании, поэтому копируйте идентификатор непосредственно со шлюза, а не вводите его по памяти. Если перечислить только те модели, которыми вы действительно пользуетесь, меню останется коротким, а выбор в повседневной работе — очевидным. Чтобы добавить модель позже, достаточно изменить одну строку, поэтому нет необходимости объявлять все модели заранее.

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

API-ключ не помещают в settings.json. Zed хранит его в системном хранилище ключей или считывает из переменной окружения, названной по имени провайдера, например AIPRIME_API_KEY, чтобы секрет не попадал в синхронизируемую конфигурацию.

После сохранения откройте ассистента, выберите своего провайдера в меню и введите ключ, когда появится запрос. После этого Zed использует ключ из системного хранилища для аутентификации, а файл настроек остаётся без учётных данных.

Такое разделение действительно полезно, если вы синхронизируете настройки Zed между компьютерами или сохраняете их в репозитории dotfiles: конфигурацию можно свободно переносить, поскольку в ней нет секретов, а каждый компьютер предоставляет собственный ключ через системное хранилище или окружение. Это удобнее, чем в инструментах, которые записывают ключ прямо в файл конфигурации. По той же причине конфигурацией Zed безопасно делиться с коллегой: он использует собственный ключ, а ваш никуда не передаётся. Это также относится к сохранению настроек в репозитории dotfiles.

Нативное подключение через ACP

Если вам нужно именно нативное поведение Anthropic, а не совместимый с OpenAI интерфейс, Zed поддерживает Agent Client Protocol с Claude Code. Вы запускаете Claude Code в качестве агента, а Zed взаимодействует с ним по ACP.

В такой конфигурации Claude Code использует собственный ANTHROPIC_BASE_URL, направленный на шлюз, поэтому Zed не нужен собственный api_url для Anthropic. Это самый удобный способ получить полноценное нативное поведение Messages внутри редактора.

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

// Zed settings.json
{
  "language_models": {
    "openai_compatible": {
      "aiprime": {
        "api_url": "https://aiprimetech.io/v1",
        "available_models": [
          { "name": "claude-sonnet-4-5",
            "display_name": "Claude Sonnet",
            "max_tokens": 200000 }
        ]
      }
    }
  }
}
// Key goes in the keychain / AIPRIME_API_KEY env var, NOT this file.

Часто задаваемые вопросы

AI Prime Tech — независимый API-шлюз. Он не связан с Anthropic, не одобрен этой компанией и не является её реселлером. Claude и названия связанных моделей — товарные знаки их соответствующих владельцев.