Обзор ACP

Agent Client Protocol: одна настройка работает в Zed, Devin Desktop и JetBrains — запускайте Claude Code как ACP-агент с окружением, направленным на QCode

Обновлено 2026-09-18

Содержание

Кратко
Хосты с поддержкой ACP
Агенты, говорящие на ACP
Настройка: один раз — работает везде
- Claude Code (протокол Anthropic)
- Codex CLI (протокол OpenAI Responses)
🔴 Частая ловушка: редактор, запущенный из GUI, не видит переменные оболочки
Как проверить, что трафик доходит до QCode
Смежные документы

Последняя проверка: 2026-09-18 · 📄 По официальной документации (agentclientprotocol.com, проверено в тот же день)

Кратко ¶

Параметр	Описание
Доступные модели	зависят от подключаемого агента: Claude Agent / Claude Code (ветка Anthropic) ✅ · GPT ✅ (агенты типа Codex) · китайские модели ✅ · Gemini — по агенту
Протокол и Base URL	настраивается в самом агенте: ветка Anthropic — `https://api.qcode.cc/api` для Claude-семейства
Где настраивается	окружение и собственный конфиг агента; хост его только запускает
Официальная документация	Agent Client Protocol
Agent Client Protocol (ACP) — открытый стандарт, разделяющий редактор и AI-агента, по аналогии с LSP для языковых серверов. Любой редактор, говорящий на ACP, может подключить любого агента, говорящего на ACP, без отдельной интеграции под каждого.

Для пользователей QCode отсюда следует очень практичный вывод:

🔑 Настройте на QCode самого агента (например, Claude Code CLI) — и все хосты подхватят это автоматически. ACP-хосты запускают агента как дочерний процесс, поэтому он наследует ваше окружение. После установки ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN сессии в Zed, Devin Desktop и JetBrains идут через QCode — настраивать каждый редактор отдельно не нужно.

Хосты с поддержкой ACP ¶

Хост	Примечание	Наша документация
Zed	Нативная поддержка; сессии в agent panel	Подключение Zed
Devin Desktop (ранее Windsurf)	Поддержка с 2026-06-02, в Agent Command Center	Подключение Devin Desktop
IDE JetBrains	Через плагин ACP	JetBrains IDE

Из заметных — Claude Agent (именно так он называется в официальном реестре: ACP-обёртка Claude Agent SDK, claude-agent-acp) и OpenCode; полный каталог — на agentclientprotocol.com. Подключить можно любой агент, реализующий ACP. У каждого хоста свой адаптер и команда запуска, поэтому точные команды смотрите в документации хоста.

Настройка: один раз — работает везде ¶

Claude Code (протокол Anthropic)¶

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_ваш_ключ_QCode"

Сохраните в ~/.zshrc / ~/.bashrc. Из материкового Китая используйте https://asia.qcode.cc/api.

Того же эффекта можно добиться, прописав их в блоке env файла ~/.claude/settings.json. См. Переменные окружения.

Codex CLI (протокол OpenAI Responses)¶

Codex настраивается через TOML, base_url заканчивается на /openai. См. руководство по Codex.

🔴 Частая ловушка: редактор, запущенный из GUI, не видит переменные оболочки ¶

В macOS и Linux редактор, запущенный из Dock, лаунчера или ярлыка, не читает ~/.zshrc. Симптом: в терминале claude подключается к QCode, а ACP-сессия внутри редактора не проходит авторизацию.

Два способа решения:

Запускать редактор из терминала (например, zed .), чтобы он унаследовал текущее окружение
Записать настройки в собственный конфиг агента, а не в profile оболочки (для Claude Code — блок env в ~/.claude/settings.json)

Второй вариант надёжнее: он не зависит от способа запуска.

Как проверить, что трафик доходит до QCode ¶

KEY="cr_ваш_ключ_QCode"
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01"
# 400 = путь и ключ в порядке (отсутствие тела ожидаемо); 401 = проблема с ключом

Если точка отвечает корректно, а хост всё равно не работает, причина в том, как хост запускает агента (обычно это описанная выше ловушка с окружением), а не в QCode.

Все запросы через QCode попадают в probe.qcode.cc — введите свой API-ключ, чтобы убедиться, что они действительно приходят.