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-провайдера. Mixen реализует протокол Anthropic Messages, поэтому подключается как таковой провайдер; через шлюз работают локальные сессии разработки (вкладка Code).

Настройка

1. Откройте Help → Troubleshooting → Enable Developer Mode — приложение перезапустится с меню Developer.
2. Откройте Developer → Configure Third-Party Inference…
3. В секции Connection выберите Inference provider → Gateway.
4. В карточке 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 принимает оба

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

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

Ограничения

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

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

Через шлюз доступна та же поверхность 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) и сеть.

Рекомендуемые модели

Через протокол Anthropic Messages доступны все текстовые модели каталога, ID передаются как есть. Цены — за 1M токенов, вход/выход; полные таблицы с кэш-колонками — в каталоге.

Задача	Модель	Вход / выход
Быстрые вопросы, рутина, черновики	GLM 5.3 Flash (z-ai/glm-5.3-flash)	8,4 / 27,9 ₽
Правки в знакомом коде, длинные задачи	GLM 5.3 (z-ai/glm-5.3)	156 / 490,2 ₽
Сложные агентные сессии, незнакомая кодовая база	Claude Sonnet 5 (anthropic/claude-sonnet-5)	213,9 / 1069,5 ₽

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

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

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

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

• Gateway was unreachable — приложение не смогло достучаться до base URL на старте: проверьте, что адрес указан без /v1, и что сеть не режет api.mixen.ai.
• Переменные ANTHROPIC_BASE_URL / settings.json не работают — это ожидаемо: Desktop читает только конфигурацию стороннего inference из формы Developer. Для env-переменных используйте CLI (страница Claude Code).
• Пикер моделей пуст — автодискавери показывает только узнаваемые Claude-модели; задайте список явно полными ID из каталога.
• Форма конфигурации read-only — на устройство уже распределена администраторская конфигурация (MDM); она имеет приоритет над локальной.