Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://docs.llmeasy.ru/llms.txt

Use this file to discover all available pages before exploring further.

В новых версиях Claude Desktop изменился способ настройки third-party API gateways. В Gateway mode Claude Desktop строже проверяет model IDs, поэтому неофициальные model IDs, например GPT, DeepSeek или GLM, могут блокироваться. Типичный симптом — предупреждение в верхней части страницы: Your provider setup needs a fix Some required fields are missing or malformed. Open Setup to finish configuring it. Одновременно selector third-party model в левом нижнем углу пуст, а Claude Desktop показывает только состояние Legacy Model.
Claude Desktop показывает Your provider setup needs a fix, при этом selector third-party model пуст.
Если вы хотите продолжать использовать Codex или другие third-party модели в Claude Desktop, маршрутизируйте запросы через CC Switch: настройте LLMEasy в разделе Claude Code в CC Switch, затем введите local service address CC Switch в Claude Desktop Gateway.
Этот путь предназначен для API keys Codex group. Не вводите https://www.llmeasy.ru/v1 напрямую в Claude Desktop Gateway.

​
Шаги настройки

1

Скачайте Claude Desktop

Скачайте актуальное приложение Claude Desktop по официальной ссылке:Download Claude for MacПосле установки не входите в Claude account. Перейдите к следующему шагу и включите developer mode.
2

Включите developer mode

Откройте Claude Desktop, затем в macOS menu bar выберите Help → Troubleshooting → Enable Developer Mode.
Выбор Enable Developer Mode в меню Help приложения Claude Desktop.
В окне подтверждения нажмите Enable, затем перезапустите Claude Desktop.
Подтверждение developer mode в Claude Desktop.
3

Откройте настройки third-party inference

После перезапуска в macOS menu bar появится меню Developer.Выберите Developer → Configure Third-Party Inference….
Выбор Configure Third-Party Inference в меню Developer.
4

Откройте Claude Code в CC Switch и добавьте provider

Откройте CC Switch, переключитесь на Claude Code и нажмите Add Provider.
Страница Claude Code в CC Switch, кнопка добавления provider в правом верхнем углу.
5

Заполните базовые поля

  • Provider Name: LLMEasy
  • Base URL: https://www.llmeasy.ru
  • API Key: ваш API Key LLMEasy
Номера на скриншоте соответствуют:
  1. Provider Name
  2. API Key
  3. Base URL
Страница редактирования provider в CC Switch с полями Provider Name, API Key и Base URL.
6

Установите API format и model mappings

Откройте Advanced Options и установите API Format в OpenAI Responses API.
Advanced Options в CC Switch, API Format установлен в OpenAI Responses API.
В Model Mapping нажмите Fetch Model List. Явно выберите значения в dropdown для Primary Model, Thinking Model, Haiku Default Model, Sonnet Default Model и Opus Default Model.
Раздел model mapping в CC Switch с Fetch Model List и mappings для Primary, Thinking, Haiku, Sonnet и Opus.
Используйте model IDs из текущих моделей Codex group в LLMEasy model plaza (https://www.llmeasy.ru/pricing).
7

Сохраните, переключитесь и включите proxy

После сохранения вернитесь к списку providers:
  1. Установите только что сохраненный provider LLMEasy как In use
  2. Включите CC Switch proxy в левом верхнем углу
После сохранения provider LLMEasy выбран активным, а proxy toggle CC Switch включен в левом верхнем углу.
8

Откройте настройки CC Switch

Вернитесь на главный экран CC Switch и нажмите Settings в левом верхнем углу.
Главный экран CC Switch с выделенной кнопкой Settings в левом верхнем углу.
9

Проверьте routing и скопируйте service address

Откройте настройки Routing. Убедитесь, что главный routing switch и route switch Claude включены. Затем скопируйте Service address ниже.
Страница routing settings в CC Switch с главным route switch, Claude route switch и кнопкой копирования service address.
10

Введите Gateway base URL в Claude Desktop

Вернитесь в окно third-party inference settings Claude Desktop и выберите Gateway. Вставьте Service address из CC Switch в Gateway base URL, затем введите API Key LLMEasy.Установите Gateway auth scheme в bearer.
Страница Gateway settings в Claude Desktop с локальным service address из CC Switch.
11

Добавьте model list и примените локально

Добавьте модели, которые должны отображаться в Model list. Для каждой модели нужны и Model ID, и Display name.Например:
Model IDDisplay name
claude-opus-4Claude Opus 4
После заполнения списка нажмите Apply locally.
Model list в Claude Desktop с заполненными Model ID и Display name, кнопка Apply locally доступна.
12

Подтвердите relaunch приложения

После записи локальной конфигурации Claude попросит перезапуск. Нажмите Relaunch now, чтобы новая gateway-конфигурация вступила в силу.
Claude Desktop просит relaunch, кнопка Relaunch now выделена.
13

Войдите через Gateway

После перезапуска подождите около 3 секунд, пока появится выбор способа входа.
Claude Desktop показывает вариант Continue with Gateway.
Выберите Continue with Gateway. Когда Claude откроется, в левом нижнем углу появится Cowork 3P | Gateway, и можно начинать работу.
Claude Desktop готов к работе после входа через Gateway.

​
Диагностика

Если вы все еще видите Your provider setup needs a fix, сначала проверьте:
  1. Provider LLMEasy в CC Switch установлен как In use
  2. API Format установлен в OpenAI Responses API
  3. В Model Mapping явно выбраны модели Codex group для Primary, Thinking, Haiku, Sonnet и Opus
  4. CC Switch proxy, главный routing switch и route switch Claude включены
  5. Gateway base URL в Claude Desktop использует local service address, скопированный из CC Switch
  6. Model list содержит и Model ID, и Display name для каждой модели