magpie: QCode для Claude Code и Codex

Подключение QCode к magpie: адреса anthropic, chat и responses, добавление через ссылку импорта или одну команду и выбор моделей.

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

Последняя проверка: 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)

Кратко¶

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

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

Структурное отличие от CC Switch состоит в одном: CC Switch записывает эндпоинт и ключ в конфигурацию каждого клиента, и клиент подключается к провайдеру напрямую; magpie направляет клиент на локальный шлюз, который пересылает запросы.

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

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.

Установка¶

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

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: одна команда в терминале (проверено)

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 (корень), затем ключ и сохраните.

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

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> …, например:

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.

Проверка¶

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: настольный инструмент, который записывает эндпоинт и ключ в конфигурацию каждого клиента
• Codex: вариант Responses в ~/.codex/config.toml
• Точки доступа и форматы API: три протокола и три домена доступа
• Переменные окружения: как используются ANTHROPIC_BASE_URL и подобные переменные

Enterprise →