# magpie: QCode для Claude Code и Codex

> **Последняя проверка**: 2026-10-27 · 📄 По официальной документации (magpie v0.1.1680, выпуск 2026-10-27) · Подключение QCode проверено на magpie 0.1.1677 (✅ Claude Code 2.1.311, Codex CLI 0.164.0)

## Кратко

| Параметр | Описание |
|---|---|
| Доступные модели | Claude ✅ (через адрес `anthropic`) · GPT ✅ (через `chat` / `responses`) · китайские модели ✅ (через `anthropic` / `chat`) · Gemini ❌: QCode не предоставляет серию Gemini, используйте Claude, GPT или китайскую модель |
| Три адреса | `anthropic`: `https://api.qcode.cc/api` · `chat`: `https://api.qcode.cc/openai/v1` · `responses`: `https://api.qcode.cc/openai` |
| Где настраивать | Ссылка импорта (приложение / веб-ссылка) · одна команда `magpie provider add` · в приложении Providers → Add provider |
| Официальная документация | [usemagpie.ai](https://usemagpie.ai) · [Docs](https://usemagpie.ai/docs) · [Import links](https://usemagpie.ai/docs/import) |

## Что такое magpie и чем он отличается от CC Switch

magpie запускает шлюз на вашем компьютере (`127.0.0.1:3425`). Он поддерживает API OpenAI, Anthropic и Gemini и переводит запросы между ними, включая потоковую передачу и вызовы инструментов. Когда вы выбираете модель для агента в magpie, magpie записывает её в собственный файл конфигурации этого агента. Поэтому Claude Code и Codex подключаются к локальному шлюзу; ключ QCode остаётся в magpie, а шлюз передаёт каждый запрос в QCode.

Структурное отличие от [CC Switch](/docs/ide/cc-switch) состоит в одном: CC Switch записывает эндпоинт и ключ в конфигурацию каждого клиента, и клиент подключается к провайдеру напрямую; magpie направляет клиент на локальный шлюз, который пересылает запросы.

## Какой протокол использовать

| Поле magpie | Что оно означает в magpie | Значение QCode |
|---|---|---|
| `anthropic` | base URL Anthropic Messages, корень без `/v1` | `https://api.qcode.cc/api` |
| `chat` (в CLI — `url`) | base URL OpenAI Chat Completions, оканчивается на `/v1` | `https://api.qcode.cc/openai/v1` |
| `responses` | base URL OpenAI Responses | `https://api.qcode.cc/openai` |

**Claude работает только через `/api`; адреса, совместимые с OpenAI, Claude не обслуживают.** Если отправить `claude-*` в chat или responses, QCode вернёт `model_not_available_on_endpoint`; эта проверка выполняется до аутентификации. GPT использует оба пути OpenAI, а китайские модели работают и через chat, и через anthropic.

Для азиатской или североамериканской точки доступа замените домен на `asia.qcode.cc` или `us.qcode.cc`; пути не меняются. Все три домена имеют одинаковые возможности и различаются только сетевым маршрутом.

В официальном описании magpie параметр `responses` — это base URL, оканчивающийся на `/v1`. Для QCode укажите `https://api.qcode.cc/openai` (так же, как base_url в конфигурации Codex для QCode); это проверено на magpie 0.1.1677 2026-10-27.

## Установка

Официальный установщик:

```bash
curl -fsSL https://usemagpie.ai/install.sh | sh
```

Установщик кладёт команду `magpie` в `~/.local/bin`, а приложение — на положенное место: `/Applications` на Mac, меню приложений в Linux. В Windows `magpie.exe` принимает те же команды; если нужна только терминальная версия, возьмите `magpie-cli-windows-amd64.exe` из последнего релиза. magpie работает на macOS, Windows и Linux как приложение в строке меню, окно, TUI, веб-интерфейс и CLI.

## Добавление QCode

**Вариант A: ссылка импорта (приложение и веб)**

magpie требует URL-кодировать каждое значение параметра. Вот ссылка для QCode без ключа:

```
magpie://import?name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=claude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5%2Cgpt-6.1-sol%2Cgpt-5.6-sol&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard
```

В вебе используйте кликабельную форму с теми же параметрами после `#` (браузер не отправляет фрагмент на сервер; если magpie не установлен, ссылка предложит загрузку):

```
https://usemagpie.ai/import#name=QCode&anthropic=https%3A%2F%2Fapi.qcode.cc%2Fapi&chat=https%3A%2F%2Fapi.qcode.cc%2Fopenai%2Fv1&responses=https%3A%2F%2Fapi.qcode.cc%2Fopenai&models=claude-opus-5-5%2Cclaude-sonnet-5-5%2Cclaude-haiku-5-5%2Cgpt-6.1-sol%2Cgpt-5.6-sol&website=https%3A%2F%2Fqcode.cc&keys=https%3A%2F%2Fqcode.cc%2Fdashboard
```

Если в ссылке нет ключа, пользователь вставляет ключ в диалог magpie, как сказано в официальной документации; ничего не сохраняется до нажатия Add. В терминале `magpie import` без ключа только показывает, что будет добавлено, и ничего не сохраняет (проверено 2026-10-27), поэтому в терминале используйте вариант B. Чтобы заменить ключ уже сохранённого провайдера, выполните `magpie provider key qcode cr_xxx`.

**Вариант B: одна команда в терминале (проверено)**

```bash
magpie provider add QCode anthropic=https://api.qcode.cc/api url=https://api.qcode.cc/openai/v1 responses=https://api.qcode.cc/openai key=cr_xxx
```

**Вариант C: приложение**

Откройте вкладку Providers, нажмите ＋ Add provider, выберите Custom (официальная подпись: `Custom · any compatible URL`), укажите имя, base URL, совместимый с OpenAI (оканчивается на `/v1`), и/или base URL, совместимый с Anthropic (корень), затем ключ и сохраните.

## Выбор моделей

```bash
magpie claude qcode/claude-sonnet-5-5        # основная модель
magpie claude opus qcode/claude-opus-5-5     # слот opus в Claude Code
magpie codex qcode/gpt-6.1-sol               # Codex
magpie claude default                        # вернуть прежнюю конфигурацию Claude Code
magpie codex default                         # вернуть прежнюю конфигурацию Codex
```

magpie записывает в `~/.claude/settings.json` адрес локального шлюза (`ANTHROPIC_BASE_URL` равен `http://127.0.0.1:3425`) и токен `magpie`; ключ QCode остаётся в magpie и не попадает в конфигурацию Claude Code. Если задать только основную модель, слот opus тоже получит ту же модель; чтобы в слоте opus был Opus, отдельно выполните `magpie claude opus qcode/claude-opus-5-5`. Слот haiku magpie автоматически устанавливает в `qcode/claude-haiku-5-5`.

Если при добавлении провайдера не указать `models=`, magpie покажет только первые 24 модели из списка (в проверке вывод был `24 of 29 models`). Выберите нужные модели командой `magpie provider models qcode <id> <id> …`, например:

```bash
magpie provider models qcode claude-opus-5-5 claude-sonnet-5-5 claude-haiku-5-5 gpt-6.1-sol gpt-5.6-sol
```

Рекомендуемые ID: `claude-opus-5-5`, `claude-sonnet-5-5`, `claude-haiku-5-5`, `gpt-6.1-sol` и `gpt-5.6-sol`. Актуальный список моделей — на https://qcode.cc/models. Оплата по токенам, цена каждой модели указана на https://qcode.cc/models.

## Проверка

```bash
magpie healthcheck
magpie provider test qcode
```

`magpie healthcheck` завершается с кодом 0, пока шлюз отвечает. `magpie provider test qcode` отправляет по одному крошечному запросу в chat, responses и anthropic и показывает задержку.

Если первая модель в `models` — модель Claude, строки chat и responses покажут `✗ 400 · Model 'claude-opus-5-5' is not available on this endpoint.` Это штатное поведение QCode: Claude обслуживается только на эндпоинте Anthropic Messages, поэтому строка anthropic с ✓ означает, что Claude работает. Чтобы проверить GPT, выполните `magpie codex qcode/gpt-6.1-sol` и отправьте реальный запрос.

Затем отправьте «ping» в Claude Code и попросите Codex прочитать файл. По состоянию на 2026-10-27 запросы Claude через magpie практически совпадают с прямым подключением к QCode, кэширование промптов работает как обычно, а Codex использует Responses API.

## Частые вопросы

### Claude Code не подключается, когда шлюз не запущен

Сначала выполните `magpie healthcheck`; код выхода 0 означает, что шлюз отвечает. Шлюз работает вместе с приложением, и после закрытия окна остаётся в строке меню или трее. Можно также запустить только шлюз командой `magpie serve` или оставить его службой через `magpie daemon install` (systemd в Linux, launchd в macOS).

### Строки chat и responses в `magpie provider test qcode` показывают 400 — это ошибка настройки?

Нет, если строка anthropic отмечена ✓. QCode обслуживает модели Claude только на эндпоинте Anthropic Messages, поэтому тест с той же моделью Claude получает 400 в chat и responses по замыслу. GPT проверяется так: выполните `magpie codex qcode/gpt-6.1-sol` и отправьте запрос.

### Почему видно только часть моделей?

Если при добавлении не указать `models=`, magpie покажет только первые 24. Выберите нужные ID командой `magpie provider models qcode …`; актуальный список — на https://qcode.cc/models.

### Как вернуть прежнюю конфигурацию Claude Code?

Выполните `magpie claude default` или выберите собственную модель агента в списке моделей. magpie удалит то, что записал, и восстановит заменённые значения.

### Как изменить уровень рассуждений Codex?

Используйте `magpie codex effort <уровень>`, например `magpie codex effort high`; `magpie codex effort` показывает текущее значение. Можно указать только уровень, например `magpie codex xhigh`.

### Что такое маскировка приватности и включена ли она по умолчанию?

По умолчанию она выключена; включите её в Settings → Privacy. После включения API-ключи, закрытые ключи, токены, адреса электронной почты, а также номера карт и документов с верной контрольной суммой заменяются заполнителями (например, `{{API_KEY_k3v9x2mq}}`) до того, как запрос покинет ваш компьютер, и восстанавливаются в ответе; значения хранятся только в памяти.

### Как отключить анонимную статистику?

Отключите Count me as a user в Settings → Privacy или задайте `DO_NOT_TRACK=1` / `MAGPIE_NO_STATS=1`. Раз в сутки выпущенная версия magpie отправляет один анонимный пакет: случайный ID, созданный на вашем компьютере, версию и систему, а также внутренние ID используемых агентов, провайдеров и моделей.

## Связанная документация

- [CC Switch](/docs/ide/cc-switch): настольный инструмент, который записывает эндпоинт и ключ в конфигурацию каждого клиента
- [Codex](/docs/ide/codex): вариант Responses в `~/.codex/config.toml`
- [Точки доступа и форматы API](/docs/getting-started/endpoints-and-api-paths): три протокола и три домена доступа
- [Переменные окружения](/docs/getting-started/environment): как используются `ANTHROPIC_BASE_URL` и подобные переменные