Source: https://aiprimetech.io/ru/learn/use-claude-api-with-zed/

[Главная](/ru/) / [Обучение](/ru/learn/) / Подключите Zed к Claude через шлюз 

# Подключите 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.
```

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

 Почему я не могу задать базовый URL Claude в Zed?

У встроенного провайдера Anthropic в Zed нет поля api_url. Используйте блок openai_compatible, в котором есть api_url, и укажите в нём https://aiprimetech.io/v1. Где указать api_url?

В language_models.openai_compatible.<name>.api_url, с /v1 в конце. Zed добавляет к этому адресу /chat/completions. Где указать API-ключ?

Не в settings.json — Zed хранит его в системном хранилище ключей или в переменной окружения, названной по имени провайдера, например AIPRIME_API_KEY. Как получить нативное поведение Anthropic?

Используйте ACP с Claude Code в качестве агента; Claude Code использует ANTHROPIC_BASE_URL для подключения к шлюзу, поэтому Zed не нужен api_url для Anthropic.  

Начните использовать Claude за несколько минут

Получите ключ API — учётная запись Anthropic и запись в лист ожидания не нужны.[Получить ключ API](/register) 

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

## Другие руководства по Claude API

[Как получить ключ Claude API](/ru/learn/how-to-get-a-claude-api-key/)[Как устроены цены Claude API](/ru/learn/claude-api-pricing-explained/)[Самый дешевый способ использования API Claude](/ru/learn/cheapest-way-to-use-claude-api/)[Безлимитный Cursor с API Claude](/learn/use-claude-api-with-cursor/)[Безлимитный доступ к Claude Code](/ru/learn/use-claude-api-with-claude-code/)[Шлюз API Claude и прямой доступ к Anthropic: сравнение](/ru/learn/claude-api-vs-anthropic-direct/)[Использование Claude через API, совместимый с OpenAI](/ru/learn/openai-compatible-claude-api/)[Объяснение моделей Claude: сравнение Claude Opus, Sonnet, Haiku и Fable — все модели Claude API, названия моделей Anthropic и цены (2026)](/ru/learn/claude-api-models-compared/)[Оплата API Claude криптовалютой](/ru/learn/claude-api-with-crypto-payment/)[Доступ к API Claude без листа ожидания](/ru/learn/claude-api-without-waitlist/)[Как сократить расход токенов Claude](/ru/learn/how-to-reduce-claude-token-usage/)[Безлимитный Cline с API Claude](/ru/learn/use-claude-api-with-cline/)[Безлимитный Roo Code с API Claude](/ru/learn/use-claude-api-with-roo-code/)[Безлимитный Claude в IDE JetBrains](/ru/learn/use-claude-api-with-jetbrains/)[Aider без ограничений с Claude API](/ru/learn/use-claude-api-with-aider/)[Безлимитный Claude в VS Code](/ru/learn/use-claude-api-with-vscode/)[Конфигурация OpenCode для Claude: настройка opencode.json, модели и распространённые ошибки](/ru/learn/use-claude-api-with-opencode/)[Запуск агента Hermes без ограничений на Claude](/ru/learn/run-hermes-agent-with-claude-api/)[Запуск OpenClaw с Claude без ограничений](/ru/learn/run-openclaw-with-claude-api/)[Что означает API, совместимый с Anthropic](/ru/learn/anthropic-compatible-api/)[Ключ API Claude Code — ANTHROPIC_API_KEY: как получить, настроить и когда вместо него использовать claude setup-token](/ru/learn/claude-code-api-key-setup/)[Расходы на API Claude Code — цены и способы их снизить](/ru/learn/claude-code-api-costs/)[Объяснение ошибок API Claude: ошибка сервера 500, перегрузка 529, лимит запросов 429, некорректный запрос 400 — и исправление каждой из них](/ru/learn/claude-api-errors-troubleshooting/)[Как купить кредиты Claude API — и почему кредиты Claude лучше любого предложения «купить аккаунт Claude»](/ru/learn/buy-claude-api-credits/)[Бесплатный API Claude: существует ли бесплатный ключ API Claude и что действительно бесплатно в 2026?](/ru/learn/claude-api-free-trial/)[API Claude или подписка Claude Pro/Max — что выбрать](/ru/learn/claude-api-vs-subscription/)[Запуск Codex CLI на Claude](/ru/learn/use-claude-api-with-codex/)[Подключение Claude к n8n](/ru/learn/use-claude-api-with-n8n/)[Маршрутизация LiteLLM к Claude](/ru/learn/use-claude-api-with-litellm/)[Использование Claude в Kilo Code](/ru/learn/use-claude-api-with-kilo-code/)[Подключение Claude к GitHub Copilot](/ru/learn/use-claude-api-with-github-copilot/)[Подключите Cherry Studio к Claude](/ru/learn/use-claude-api-with-cherry-studio/)[ChatAnthropic в LangChain: импорт, base_url, потоковая передача, инструменты и ошибки](/ru/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: установка, настройка base_url, потоковая передача и обработка ошибок](/ru/learn/anthropic-python-sdk/)[Claude с Vercel AI SDK: baseURL в createAnthropic, потоковая передача и устранение проблем](/ru/learn/use-claude-api-with-vercel-ai-sdk/)[Используйте Factory Droid с Claude](/ru/learn/use-claude-api-with-factory-droid/)[Как устроен API Claude Code](/ru/learn/claude-code-api/)[Интеграция API Claude в ваше приложение](/ru/learn/claude-api-integration/)[Как пользоваться Claude без ограничений — и почему «взломанного Claude Code» не существует](/ru/learn/get-unlimited-claude-usage/)