Подключение редактора Zed

Подключите QCode.cc к Claude Code в редакторе Zed через Agent Client Protocol (ACP) и используйте agent panel с Opus 4.7 и контекстом 1M

Подключение редактора Zed¶

Zed — это высокопроизводительный современный редактор кода, написанный на Rust. С Q1 2026 он нативно поддерживает Agent Client Protocol (ACP) — открытый стандарт, который разделяет коммуникацию между IDE и AI-агентом, аналогично тому, как LSP работает с языковыми серверами. Через ACP Zed интегрирует Claude Code и предоставляет agent panel для оркестрации многошаговых задач по работе с кодом. В этом руководстве описано, как настроить QCode.cc в качестве вышестоящего шлюза для Claude Code в Zed.

Зачем использовать Zed¶

• Нативная интеграция ACP: открывайте сессии Claude Code в agent panel и наблюдайте за рассуждениями агента и вызовами инструментов прямо в редакторе
• Контекст 1M: режим BYOK поддерживает полное окно контекста 1M токенов для Opus 4.7
• Производительность Rust: чрезвычайно быстрый холодный старт; потребление памяти на порядок ниже, чем у редакторов на VS Code/Electron
• Многопанельная компоновка: редактор + терминал + agent panel в три колонки рядом — компактный рабочий процесс

Предварительные требования¶

• Установлен Zed (macOS / Linux)
• Установлен Claude Code CLI (интеграция ACP в Zed использует CLI как бэкенд)
• Имеется API Key QCode.cc (начинается с cr_), полученный в личном кабинете
• Claude Code CLI настроен с переменными окружения QCode (см. Быстрый старт)

Шаги настройки¶

Шаг 1. Сначала убедитесь, что Claude Code CLI работает в терминале¶

Zed запускает ACP, спавня процесс claude, поэтому сначала проверьте работу в терминале:

export ANTHROPIC_BASE_URL="http://103.236.53.153/api"
export ANTHROPIC_AUTH_TOKEN="cr_xxxxxxxx"
claude --version   # должен вывести номер версии
echo "ping" | claude   # простой echo-тест

Сохраните эти две переменные окружения в конфиге shell (~/.zshrc / ~/.bashrc), чтобы Zed мог их унаследовать при запуске.

Шаг 2. Откройте agent panel в Zed¶

• macOS: Cmd + ?
• Linux: Ctrl + ?

При первом открытии будет предложено выбрать agent provider — выберите Claude Code (не выбирайте BYOK Anthropic API: этот путь не использует CLI и требует отдельной настройки base URL в параметрах Zed).

Шаг 3. Проверьте сессию агента¶

В поле ввода agent panel введите: «Перечислить экспортируемые символы текущего файла». Zed передаст текущий открытый файл в качестве контекста Claude Code, агент вызовет инструменты read / grep для анализа и даст ответ.

Если agent panel сообщает, что не может найти команду claude, добавьте в настройках Zed (Cmd+,) параметр agent.path, указывающий на полный путь к бинарнику CLI:

{
  "agent": {
    "path": "/usr/local/bin/claude"
  }
}

Резервные эндпоинты¶

При проблемах с доступом к основному узлу можно переключить ANTHROPIC_BASE_URL:

Полный список эндпоинтов (включая резервные узлы в Северной Америке / Европе / Азии) см. в разделе Эндпоинты и форматы API.

Общая квота¶

Агент Claude Code в Zed использует тот же API Key QCode, что и CLI / Claude Desktop / Codex CLI, и расходует общую квоту — двойного списания не происходит. Подробнее см. в разделе Биллинг.

Ограничения и замечания¶

• Режим BYOK Anthropic в Zed использует встроенный в Zed Anthropic provider и не идёт через Claude Code CLI; для него потребуется вручную указать assistant.providers.anthropic.api_url со значением эндпоинта QCode в настройках Zed. В этом руководстве рассматривается режим ACP / Claude Code, который рекомендуется как более предпочтительный — он сохраняет полный набор инструментов CLI (hooks, skills, MCP).
• Интеграция ACP находится в стадии Public Beta (с 2026-04), некоторые API могут ещё меняться. При обнаружении различий в поведении ориентируйтесь на официальную документацию Zed.
• Пользователи Linux с песочницей: если Zed установлен через Flatpak, спавн дочернего процесса claude может быть ограничен песочницей. Рекомендуется использовать пакеты .deb / AppImage / Homebrew напрямую.

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

Agent panel выдаёт ошибку «Failed to start agent»¶

• Запускается ли claude вручную в терминале? Сначала исключите проблемы конфигурации самого CLI
• Унаследовал ли Zed переменные окружения ANTHROPIC_*? Запуск через open -a Zed из терминала гарантирует наследование (macOS)
• Существует ли путь, указанный в agent.path в настройках? Проверьте через which claude

Чем отличается от режима BYOK Anthropic¶

Дальнейшие шаги¶

• Полное руководство по Claude Code — все возможности CLI
• Эндпоинты и форматы API — полная таблица пяти доменов
• Интеграция с VS Code — сравнение с редакторами на базе Electron
• Биллинг — правила общей квоты