Claude Desktop

Подключите Claude Desktop к Mixen — оплата с баланса в рублях, протокол Anthropic Messages с tool calling, стримингом и prompt caching.

Claude Desktop — приложение Anthropic с тремя вкладками: Chat, Cowork и Code. Кастомный API-эндпоинт в нём настраивается не переменными окружения (приложение не читает ни ANTHROPIC_BASE_URL, ни settings.json — в отличие от CLI, см. Claude Code), а через встроенную конфигурацию стороннего inference-провайдера (Third-Party Inference). Mixen реализует протокол Anthropic Messages, поэтому подключается как таковой провайдер; через шлюз работают локальные сессии разработки (вкладка Code). Аккаунт Anthropic не обязателен — порядок действий одинаков для авторизованных и неавторизованных.

Настройка

Откройте Help → Troubleshooting → Enable Developer Mode — приложение перезапустится с меню Developer.
Откройте Developer → Configure Third-Party Inference…
В секции Connection выберите Inference provider → Gateway.
В карточке Gateway credentials заполните:

Поле	Значение
Gateway base URL	`https://api.mixen.ai`
Gateway API key	ключ `mxn-…` из кабинета
Credential kind	Static API key
Gateway auth scheme	Bearer (по умолчанию) или x-api-key — Mixen принимает оба

Нажмите Apply Changes (в старых сборках — Apply locally) и полностью перезапустите приложение: Quit в меню, а не закрытие окна.

Ключевые моменты:

Base URL — без суффикса /v1 и без слэша на конце: приложение само подставляет /v1/messages в путь запроса.
Требования к шлюзу — POST /v1/messages со стримингом и tool use; всё это Mixen поддерживает (та же поверхность, что и для Claude Code).
GET /v1/models для автодискавери моделей опционален. Если пикер моделей пуст или в нём нет нужной — задайте модели явно, полными ID из каталога: anthropic/claude-sonnet-5.5 и так далее. Голые псевдонимы вроде sonnet без дискавери не разрешаются.

Ограничения

С активным шлюзом приложение запускает сессии только локально: пикер окружений не предлагает SSH-хосты и облачные среды Anthropic, а Remote Control недоступен. Если нужен агент на удалённой машине — запустите там CLI с переменными из инструкции Claude Code.

MCP-сервер Mixen

Gateway (Connection) и MCP-сервер — два независимых канала, не дубликаты: первый — сам inference (модели сессий через наш /v1/messages), второй — инструменты внутри любой сессии. Варианты сетапа:

Connection	MCP	Что получается
Mixen	Mixen	всё через один баланс: сессии на наших моделях + тулы (рекомендуемый)
подписка Anthropic	Mixen	Claude-сессии платит Anthropic, а `mixen_chat`/картинки/баланс — наши
Mixen	—	только сессии на наших моделях, без тулов

Вкладка Code (и Cowork) умеет подключать MCP-инструменты прямо из конфигурации Third-Party Inference: Developer → Configure Third-Party Inference… → Connectors → MCP servers → Add MCP servers → Blank (ручной сервер с нуля; остальные пункты списка — пресеты). Добавьте туда MCP-сервер Mixen — и агент в сессии получит инструменты без единой строчки интеграции:

Поле	Значение
Name	`mixen`
Transport	Streamable HTTP (или просто HTTP; не STDIO и не legacy SSE)
URL	`https://api.mixen.ai/v1/mcp`
Заголовок	`Authorization` = `Bearer mxn-…` (тот же ключ, что и шлюз)

Как заполняется форма Blank: в секции Headers кнопка add подставляет строку-заглушку X-Tenant-ID — имя редактируется: сотрите его и впишите Authorization, в поле значения — Bearer mxn-…. Сам X-Tenant-ID Mixen не нужен. Переключатель OAuth ниже не включайте — у Mixen статический ключ, а не OIDC-флоу.

Транспорт — Streamable HTTP. Главное при Claude-only-пикере: агент в сессии вызывает любые модели каталога через mixen_chat (модель — параметр вызова) и генерирует картинки через mixen_generate_image — паттерн «дорогой ведущий + дешёвые исполнители» расписан в гайде по MCP.

Полный список инструментов и биллинг — в гайде по MCP.

Ключу нужны соответствующие области доступа (scopes): chat для текста, images для картинок и так далее — MCP-вызовы проходят те же гейты, что и обычные запросы к API.

Что поддерживается

Через шлюз доступна та же поверхность Mixen, что и для Claude Code (протокол Anthropic Messages):

Возможность	Статус
Текст, system, images (vision-модели)	✅
Tools / tool-use	✅
Streaming SSE (`stream: true`)	✅
`POST /v1/messages/count_tokens`	✅ (оценка без похода к модели)
Prompt caching (`cache_control`)	✅
Extended thinking (`thinking`)	✅

Проверка подключения

Ключ и баланс проверяются минимальным генерирующим запросом:

curl https://api.mixen.ai/v1/chat/completions \
  -H "Authorization: Bearer ваш-api-ключ" \
  -H "Content-Type: application/json" \
  -d '{"model":"z-ai/glm-5.3-flash","messages":[{"role":"user","content":"ping"}],"max_tokens":5}'

200 — ключ и баланс рабочие; 401 — ключ скопирован не целиком или это не API-ключ Mixen; 402 — на балансе нет средств. Если приложение при старте показывает Gateway was unreachable — оно не смогло достучаться до base URL: проверьте адрес (без /v1) и сеть.

Задача	Модель	Вход / выход
Быстрые вопросы, рутина, черновики	GLM 5.3 Flash (`z-ai/glm-5.3-flash`)	0.50 / 20.60 ₽
Правки в знакомом коде, длинные задачи	GLM 5.3 (`z-ai/glm-5.3`)	74.80 / 235.20 ₽
Сложные агентные сессии, незнакомая кодовая база	Claude Sonnet 5.5 (`anthropic/claude-sonnet-5.5`)	213.80 / 1069.20 ₽

Кэш и экономия сессий

Промпт-кэш включён на стороне Mixen всегда, клиент настраивать не нужно:

повторный контекст в течение 5 минут считается по ~10% цены входа (у claude-sonnet-5.5 — 21.4 ₽ за 1M вместо 213.8 ₽), каждое попадание продлевает окно ещё на 5 минут;
пауза дольше 5 минут обнуляет кэш — следующий ход платит полную цену входа, дальше скидка накапливается снова;
не редактируйте правила проекта (CLAUDE.md, AGENTS.md) посреди сессии — изменение префикса сбрасывает кэш;
лимит — 120 RPM на ключ.

Типичные проблемы

Gateway was unreachable — приложение не смогло достучаться до base URL на старте: проверьте, что адрес указан без /v1, и что сеть не режет api.mixen.ai.
Gateway rejected the configured credential (HTTP 403) — при сохранении Desktop проверяет ключ пробным запросом к POST /v1/messages с моделью anthropic/claude-haiku-4.5 (поле probedModel в ошибке). Если у ключа задан список разрешённых моделей и её там нет — Mixen вернёт 403 model_not_allowed, и приложение решит, что ключ отвергнут. Добавьте anthropic/claude-haiku-4.5 в allowed_models ключа в кабинете или возьмите ключ без ограничений моделей.
Переменные ANTHROPIC_BASE_URL / settings.json не работают — это ожидаемо: Desktop читает только конфигурацию стороннего inference из формы Developer. Для env-переменных используйте CLI (страница Claude Code).
Пикер показывает весь каталог, а не только разрешённые ключу модели: GET /v1/models публичен, allow-list ключа проверяется при каждом запросе генерации (неразрешённая модель даст 403 model_not_allowed). Чтобы сузить пикер, задайте model allowlist в этом же меню Inference — только ваши модели.
Пикер моделей пуст — автодискавери показывает только узнаваемые Claude-модели; проверьте, что баланс ключа положителен, задайте список явно полными ID из каталога и перезапустите приложение полностью (Quit).
Нет кнопки Continue with Gateway — перезапустите приложение ещё раз; не помогло — Developer → Clear Cache and Restart и обновите приложение.
WebFetch и встроенные инструменты блокируют сайты (Access blocked by network egress settings) — сетевой трафик инструментов изолирован белым списком; добавьте нужные хосты в Configure Third-Party Inference… → Workspace restrictions → Allowed egress hosts.
Форма конфигурации read-only — на устройство уже распределена администраторская конфигурация (MDM); она имеет приоритет над локальной.