Обзор ACP

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

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

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

Кратко¶

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

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

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

Агенты, говорящие на ACP¶

Из заметных — 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-сессия внутри редактора не проходит авторизацию.

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

1. Запускать редактор из терминала (например, zed .), чтобы он унаследовал текущее окружение
2. Записать настройки в собственный конфиг агента, а не в 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-ключ, чтобы убедиться, что они действительно приходят.

Как ACP запускает агента: почему переменные окружения «наследуются»¶

По состоянию на 2026-10-15, согласно официальному описанию транспорта ACP: ACP кодирует сообщения в JSON-RPC, и при рекомендуемом транспорте stdio клиент (редактор) запускает агента как подпроцесс; агент читает сообщения JSON-RPC со стандартного ввода, пишет сообщения в стандартный вывод (разделитель — перевод строки) и может писать журнал в стандартный поток ошибок (stderr). Протокол также запрещает агенту писать в stdout что-либо, кроме корректных сообщений ACP.

Для диагностики отсюда два практических вывода:

• Подпроцесс по умолчанию наследует окружение того, кто его запустил, поэтому действие ANTHROPIC_BASE_URL, заданной в shell, зависит от того, как был запущен сам редактор (см. выше ловушку с запуском из графической оболочки).
• Если вы оборачиваете агента собственным скриптом, не выводите в нём приветствия или отладочные сообщения в stdout через echo, иначе они будут сочтены некорректными сообщениями; такой вывод направляйте в stderr.

Ключевые параметры¶

Частые ошибки и диагностика¶

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

Нужно ли настраивать QCode отдельно в каждом редакторе?¶

Нет. Настраивается сам агент (например, Claude Code), а редактор лишь запускает его. Когда агент подключён к QCode, сессии ACP в Zed, Devin Desktop и JetBrains используют ту же конфигурацию.

Как ACP связан с LSP?¶

Идея похожа: LSP отделяет редакторы от языковых серверов, а ACP — редакторы от ИИ-агентов. Редактор, говорящий на ACP, может подключить любого агента, говорящего на ACP, без отдельной интеграции под каждого.

Как проверить, что редактор, запущенный из Dock, получил переменные окружения?¶

Откройте в редакторе сессию ACP, отправьте одно сообщение, затем введите ключ на probe.qcode.cc и посмотрите, есть ли этот запрос. Если нет, переменные не дошли до агента — пропишите настройки в блок env файла ~/.claude/settings.json.

Можно ли использовать GPT в сессиях ACP?¶

Зависит от подключённого агента. Агенты семейства Claude работают только через интерфейс Anthropic — с Claude и китайскими моделями. Для GPT подключите агента типа Codex и направьте его base_url на https://api.qcode.cc/openai, как того требует Codex. QCode сейчас не предоставляет модели Gemini.

Какой домен использовать из материкового Китая?¶

Замените api.qcode.cc на asia.qcode.cc (азиатская точка доступа); ключ остаётся прежним. При нестабильности вернитесь обратно.

Смежные документы¶

• Точки доступа и форматы API — таблица «протокол × семейство моделей»
• Переменные окружения
• Подключение Zed · Подключение Devin Desktop · JetBrains IDE

Enterprise →