# Обзор ACP

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

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | зависят от подключаемого агента: Claude Agent / Claude Code (ветка Anthropic) ✅ · GPT ✅ (агенты типа Codex) · китайские модели ✅ · Gemini — по агенту |
| Протокол и Base URL | настраивается **в самом агенте**: ветка Anthropic — `https://api.qcode.cc/api` для Claude-семейства |
| Где настраивается | окружение и собственный конфиг агента; хост его только запускает |
| Официальная документация | [Agent Client Protocol](https://agentclientprotocol.com)
**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](/docs/ide/zed) |
| Devin Desktop (ранее Windsurf) | Поддержка с 2026-06-02, в Agent Command Center | [Подключение Devin Desktop](/docs/ide/devin-desktop) |
| IDE JetBrains | Через плагин ACP | [JetBrains IDE](/docs/ide/jetbrains) |

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

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

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

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

```bash
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`.
> См. [Переменные окружения](/docs/getting-started/environment).

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

Codex настраивается через TOML, `base_url` заканчивается на `/openai`. См. [руководство по Codex](/docs/ide/codex).

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

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

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

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

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

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

```bash
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](https://probe.qcode.cc) — введите свой API-ключ, чтобы убедиться, что они действительно приходят.

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

- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths) — таблица «протокол × семейство моделей»
- [Переменные окружения](/docs/getting-started/environment)
- [Подключение Zed](/docs/ide/zed) · [Подключение Devin Desktop](/docs/ide/devin-desktop) · [JetBrains IDE](/docs/ide/jetbrains)