Claude Code в Zed: подключение внешнего агента к своему ключу

В редакторе Zed Claude Code можно запустить тремя способами, и у каждого свои правила авторизации. Если вы хотите, чтобы агент ходил на ваш шлюз и тратил ваш баланс в долларах, нужно понимать, какой из способов читает какие настройки. Ниже разбираем Zed и Claude Code по документации Zed на 18 октября 2026 и подключаем каждый вариант к ключу fetch_....

Названия команд и пунктов меню Zed быстро меняются. Если что-то на вашем экране выглядит иначе, сверяйтесь с разделом AI в документации Zed.

Что такое Zed AI и где здесь агенты

Zed — редактор с панелью агентов (Agent Panel) и боковой панелью потоков (Threads Sidebar). По документации, у ИИ-части три «дорожки»:

Если коротко, что такое Zed AI: это не одна кнопка, а набор способов подключить агента. А для вашей задачи ключевое правило такое: Zed не передаёт свои ключи внешним агентам и терминальным потокам, они берут настройки у себя.

Сначала подготовьте Claude Code по инструкции Zukko↗.

Общая часть: настройка самого Claude Code

Самый надёжный способ для всех трёх вариантов — положить подключение в пользовательские настройки Claude Code, а не в Zed. Файл ~/.claude/settings.json:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.zukko.pro",
    "ANTHROPIC_AUTH_TOKEN": "fetch_ваш_ключ",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5"
  }
}

Три правила, на которых чаще всего спотыкаются:

• адрес без /v1: Claude Code добавляет путь сам, а при лишнем /v1 запросы уйдут на /v1/v1/messages и вернут 404;
• ключ передаётся через ANTHROPIC_AUTH_TOKEN, а не через переменную с API_KEY в названии;
• в моделях указывайте id из каталога Zukko, актуальный список отдаёт GET /v1/models.

Если Claude Code всё равно просит войти в Anthropic, разберите причину по статье Claude Code просит войти↗.

Способ 1: терминальный поток (проще всего)

Terminal Thread запускает обычный CLI прямо в Zed. Документация говорит, что авторизация, провайдер модели, ключи и MCP принадлежат самому CLI, а ключи из настроек провайдеров Zed в терминал не копируются. Для шлюза это удобно: всё определяется файлом выше или переменными окружения вашей оболочки.

1. В Agent Panel откройте меню нового потока (кнопка агента слева или значок + справа в панели) и выберите Terminal.
2. В терминале выполните claude.
3. Спросите модель, какая она, и сверьте с кабинетом (раздел «Использование»): запрос должен появиться в расходах вашего ключа.

Чтобы Claude Code стартовал автоматически в каждом новом терминальном потоке, в настройках Zed есть параметр:

{
  "agent": {
    "terminal_init_command": "claude"
  }
}

Команда уходит в оболочку так, будто вы набрали её руками. Ещё одна мелочь из документации Zed: чтобы получать уведомление, когда Claude Code закончил задачу, в пользовательских настройках Claude Code задаётся "preferredNotifChannel": "terminal_bell".

Способ 2: Claude Agent как внешний агент (ACP)

Claude Agent ставится из реестра ACP: откройте реестр командой zed: acp registry или через настройки агентов (пункт External Agents, Add Agent, Install from Registry). После установки он появится в меню нового потока.

Что важно из документации: Claude Agent сам отвечает за авторизацию и оплату, а ключ Anthropic, настроенный для Zed Agent, на него не распространяется. Внутри потока команда /login позволяет выбрать способ входа. В описании сказано, что Claude Agent может использовать авторизацию и нативную конфигурацию Claude Code, а файлы вроде CLAUDE.md читает сам.

Поэтому для шлюза разумно действовать так: оставить подключение в ~/.claude/settings.json (см. выше), запустить поток и сразу проверить, что запрос виден в расходах ключа в кабинете. В документации Zed нет гарантии, что Claude Agent подхватывает именно этот блок env. Если запрос ушёл не на шлюз, переходите к способу 1: терминальный поток читает те же настройки наверняка.

Способ 3: Zed Agent с Anthropic-совместимым провайдером

Здесь Claude Code не участвует: работает встроенный агент Zed, а Zukko подключается как провайдер. В документации Zed для этого есть раздел об Anthropic-совместимых эндпоинтах: сервис должен реализовывать Messages API (/v1/messages), и вы задаёте адрес, модель и ключ. Через settings.json:

{
  "language_models": {
    "anthropic_compatible": {
      "Zukko": {
        "api_url": "https://api.zukko.pro",
        "available_models": [
          {
            "name": "claude-sonnet-5-5",
            "display_name": "Claude Sonnet 5.5 (Zukko)",
            "max_tokens": 1000000,
            "max_output_tokens": 32000,
            "capabilities": {
              "tools": true,
              "images": true,
              "prompt_caching": true
            }
          }
        ]
      }
    }
  }
}

Ключ вводится в интерфейсе провайдера либо берётся из переменной окружения, имя которой Zed строит по имени провайдера: для «Zukko» это ZUKKO_API_KEY. В settings.json ключи класть не нужно, так сказано в документации. Параметр prompt_caching включает явные точки кэша; если запросы начнут отклоняться, его можно выключить.

Если нужны модели вроде gpt-6.1-sol или deepseek-v4.1-flash, добавьте раздел openai_compatible с api_url https://api.zukko.pro/v1. Для Claude в агентной работе предпочтительнее Anthropic-формат: так шлюз видит чтение и запись кэша и считает их по своим ценам, а в OpenAI-формате весь вход идёт по цене входа.

Сколько это стоит

Цены на 18 октября 2026, доллары за 1M токенов. claude-sonnet-5-5: вход 0.4, выход 2, чтение кэша 0.05, запись 0.5. Для сравнения, claude-opus-5-5: вход 0.8, выход 4.

Сессия агента, в которой 200K токенов пришло свежими, 3M прочитано из кэша, 150K записано в кэш, а модель выдала 60K токенов:

• Anthropic-формат: 0.2 × 0.4 + 3 × 0.05 + 0.15 × 0.5 + 0.06 × 2 = 0.08 + 0.15 + 0.075 + 0.12 = $0.425;
• тот же объём в OpenAI-формате: (0.2 + 3 + 0.15) × 0.4 + 0.06 × 2 = 1.34 + 0.12 = $1.46.

Реальные цифры зависят от вашей сессии, но разница показывает, зачем для Claude выбирать Anthropic-формат. Подробный расчёт — в статье Сколько стоит агент Claude Code↗. Чтобы агент не потратил лишнего, заведите отдельный ключ под редактор и задайте ему дневной лимит.

Если что-то не работает

Доступ из России — через шлюз, оплата СБП (платёжная страница добавляет 8,5% сверху), картой MasterCard или криптой. Создайте ключ в кабинете↗ и подключите любой из способов выше. Если вам нужно только дополнение к Zed Agent без Claude Code, посмотрите настройку ИИ-ассистента в Zed↗.

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

Какой способ выбрать, если нужен именно Claude Code?

Терминальный поток: он запускает настоящий claude и читает ваши настройки. Внешний агент через ACP удобнее по интерфейсу, но его поведение с вашим ключом проверьте по расходам в кабинете.

Нужен ли Claude Code для работы Zed с моделями?

Нет. Встроенный Zed Agent работает без Claude Code: ему нужен провайдер с ключом и моделью (способ 3).

Можно ли взять не-Claude модель в Claude Code?

Шлюз принимает любую модель в формате Anthropic, но Claude Code рассчитан на модели Claude, так что поведение других моделей проверяйте на своих задачах. Для моделей с id без префикса claude- Claude Code может неверно определить окно контекста; для GLM с окном 128K посмотрите переменную CLAUDE_CODE_MAX_CONTEXT_TOKENS в документации Claude Code.

Zed платный?

Условия и тарифы Zed смотрите на его сайте: мы их не приводим, они меняются. Оплата токенов шлюза от этого не зависит.