Обзор ACP

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

Обзор ACP¶

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¶

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

Распространённые — Claude Code, Codex CLI, OpenCode, а также любые агенты с собственной реализацией 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-ключ, чтобы убедиться, что они действительно приходят.

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

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