Инструменты ИИЗнаков 7968Время чтения20 мин

Руководство по подключению CC Switch к Claude Desktop: переключение между OpenRouter и DeepSeek через локальную маршрутизацию

Рассматривается, как с помощью CC Switch управлять конфигурациями сторонних поставщиков в Claude Desktop и подключать модели OpenRouter, DeepSeek и другие, не относящиеся к семейству Claude, через сопоставление моделей и локальную маршрутизацию.

Начиная с версии CC Switch v3.15.0 поддерживается самостоятельное управление Claude Desktop. Основная ценность CC Switch не в том, что это «ещё одна оболочка», а в том, что она сводит настройки сторонней инференс-конфигурации Claude Desktop, сопоставление моделей и локальную маршрутизацию в единую графическую панель, уменьшая ручную правку конфигураций, ввод endpoints и ID моделей. (Если вы еще не знакомы с базовым назначением CC Switch и поддерживаемыми инструментами, сначала посмотрите «CC Switch: что это и почему это консоль для унифицированного управления AI-инструментами и поставщиками моделей».)

Claude Desktop изначально уже предоставляет встроенный интерфейс для стороннего инференса. Обычно путь такой: Help → Troubleshooting → Enable Developer Mode, затем Developer → Configure third-party inference. Проблема в том, что ручная настройка не слишком дружелюбна для новичков: нужно заполнить адрес Gateway, API Key, способ аутентификации, список моделей и т. д., и любая ошибка в одном поле может привести к сбою подключения.

Роль CC Switch — свести эти шаги в один инструмент. Особенно это полезно, когда вы хотите подключить к Claude Desktop модели OpenRouter, DeepSeek и другие, которые не входят в серию Claude: здесь особенно полезны функции «сопоставление моделей» и «локальная маршрутизация».

1. Что именно она решает?

При подключении Claude Desktop к стороннему поставщику обычно возникают две основные сложности:

1. Сложный путь к настройкам: сначала нужно включить режим разработчика, затем перейти к окну конфигурации стороннего инференса. 2. Проблема совместимости названий моделей: Claude Desktop обычно воспринимает роли моделей в терминах Claude (например, Sonnet, Opus, Haiku), тогда как сторонние платформы используют собственные ID, например inclusionai/ring-2.6-1t, deepseek-v4-pro, deepseek-v4-flash.

CC Switch вводит слой адаптации:

Claude Desktop → CC Switch локальная маршрутизация → Сторонний поставщик

Этот слой выполняет три задачи:

  • Перенаправляет запросы Claude Desktop к стороннему поставщику;
  • Сопоставляет роли Sonnet / Opus / Haiku с фактическими ID моделей;
  • Автоматически записывает требуемую конфигурацию стороннего инференса Claude Desktop.

2. Когда обязательно включать сопоставление моделей?

Критерий прост:

Тип поставщикаНужны ли сопоставления моделейНужна ли локальная маршрутизация
Модели Claude, например официальный Claude API или промежуточный сервис, который предоставляет только Claude-моделиОбычно не требуетсяОбычно не требуется
Модели не из семейства Claude, например Ring, DeepSeek V4 на OpenRouterТребуютсяТребуются

Оба примера в этой статье относятся к моделям не из семейств Claude, поэтому включают:

  • «Сопоставление моделей»
  • «Локальная маршрутизация»

Любой раз, когда вы используете модели не из семейства Claude, локальная маршрутизация должна работать непрерывно. Если выключить CC Switch или выключить переключатель маршрутизации, Claude Desktop потеряет связь со сторонними моделями.

3. Подготовка

Перед началом подготовьте три вещи:

1. CC Switch v3.15.0 или выше Официальный сайт: https://ccswitch.io

2. Claude Desktop Официальная загрузка: https://claude.ai/download

3. Аккаунт стороннего поставщика и API Key Можно выбрать один из вариантов:

4. Установка или обновление CC Switch

Если CC Switch уже установлен, просто выполните обновление автоматически.

Чистая установка выполняется следующим образом:

## macOS
brew tap farion1231/ccswitch
brew install --cask cc-switch

Пользователи Windows загружают установщик .msi; пользователи Linux выбирают .deb, .rpm или .AppImage в зависимости от дистрибутива.

После установки откройте CC Switch. Если в переключателе приложений появился отдельный пункт «Claude Desktop» рядом с «Claude Code», это означает, что у вас новая версия с поддержкой управления Claude Desktop.

5. Переход в панель Claude Desktop

В левом или верхнем переключателе приложений CC Switch выберите:

Claude Desktop

Затем нажмите «Добавить поставщика» (Add Provider), выберите платформу для подключения и заполните API Key и адрес запроса.

Ниже приведены два типичных варианта конфигурации.

6. Пример A: OpenRouter + Ring 2.6 1T

OpenRouter — это агрегатор моделей, который предоставляет единый вход к множеству моделей. Он поддерживает бесплатные модели, оплату по мере использования и корпоративные тарифы, поэтому подходит для тестирования разных моделей и временного переключения поставщика.

1. Создание API Key OpenRouter

Откройте OpenRouter:

https://openrouter.ai

Перейдите на страницу Keys и создайте API Key:

https://openrouter.ai/keys

2. Добавление OpenRouter в CC Switch

В «Добавить поставщика» выберите пресет OpenRouter и заполните поля:

ПолеЗначение
Название поставщикаOpenRouter
Сайтhttps://openrouter.ai
API KeyВставьте OpenRouter Key
Адрес запросаhttps://openrouter.ai/api
Формат APIAnthropic Messages (нативный)
Нужны сопоставления моделейВключено

Важно: рекомендуется не ставить / в конце адреса запроса.

3. Рекомендуемая настройка сопоставления моделей

Ring 2.6 1T не относится к семейству Claude, поэтому роли Claude Desktop нужно сопоставить с реальными ID моделей OpenRouter.

Можно добавить три строки:

Роль моделиОтображаемое имя в менюФактическая модель запросаПоддержка 1M
Sonnetinclusionai/ring-2.6-1tinclusionai/ring-2.6-1tНе отмечено
Opusinclusionai/ring-2.6-1tinclusionai/ring-2.6-1tНе отмечено
Haikuinclusionai/ring-2.6-1tinclusionai/ring-2.6-1tНе отмечено

Смысл такой: независимо от того, выбираете ли вы в Claude Desktop Sonnet, Opus или Haiku, запрос будет отправляться к inclusionai/ring-2.6-1t на OpenRouter.

7. Пример B: DeepSeek V4 официально

Официальная документация DeepSeek предоставляет Anthropic-совместимый интерфейс, base URL:

https://api.deepseek.com/anthropic

Это означает, что DeepSeek может подключаться к части инструментов экосистемы Anthropic API. В документации DeepSeek также есть пример переменных окружения для Claude Code, включая имена моделей вроде deepseek-v4-pro[1m], deepseek-v4-flash.

1. Создание API Key DeepSeek

Откройте DeepSeek Platform:

https://platform.deepseek.com

Перейдите на страницу API Keys и создайте ключ. Обычно для вызова API DeepSeek нужно сначала пополнить баланс.

2. Добавление DeepSeek в CC Switch

В «Добавить поставщика» выберите пресет DeepSeek и заполните:

ПолеЗначение
Название поставщикаDeepSeek
Сайтhttps://platform.deepseek.com
API KeyВставьте DeepSeek Key
Адрес запросаhttps://api.deepseek.com/anthropic
Формат APIAnthropic Messages (нативный)
Нужны сопоставления моделейВключено

Важно: здесь используется /anthropic, а не /v1.

3. Рекомендуемая настройка сопоставления моделей

Можно распределить модели так: «более дешевые модели для повседневных задач, более мощные — для сложных»:

Роль моделиОтображаемое имя в менюФактическая модель запросаПоддержка 1M
Sonnetdeepseek-v4-flashdeepseek-v4-flashОтмечено
Opusdeepseek-v4-prodeepseek-v4-proОтмечено
Haikudeepseek-v4-flashdeepseek-v4-flashНеобязательно

Так в Claude Desktop при выборе Sonnet будет использоваться более дешёвый deepseek-v4-flash, а при выборе Opus — более мощный deepseek-v4-pro.

Если вы хотите использовать вариант с записью 1M из документации DeepSeek, можно попробовать в реальном запросе модель:

deepseek-v4-pro[1m]

Работоспособность зависит от того, как это поддерживается официальной документацией DeepSeek и текущей версией CC Switch.

8. Включение локальной маршрутизации

После включения сопоставления моделей также необходимо включить локальную маршрутизацию.

Обычно путь такой:

CC Switch → Настройки → Маршрутизация

Нужно включить две позиции:

1. Главный переключатель маршрутизации: после включения состояние должно быть «Работает». 2. Маршрутизация приложения Claude: отметьте Claude, чтобы запросы Claude Desktop шли через локальную маршрутизацию.

Адрес сервиса по умолчанию обычно:

http://127.0.0.1:15721

Обычно его изменять не нужно.

Рекомендуется также включить «Показывать переключатель локальной маршрутизации на главной странице», чтобы быстро видеть в панели, работает ли маршрутизация.

9. Включение поставщика и перезапуск Claude Desktop

После настройки выберите в панели Claude Desktop добавленного поставщика и нажмите «Включить» (Enable).

Затем перезапустите Claude Desktop.

Важно: нужно именно полностью завершить приложение, а не просто закрыть окно:

  • macOS: полностью выйдите с помощью Command + Q;
  • Windows: в системном трее найдите значок Claude и выберите выход через контекстное меню.

Откройте Claude Desktop заново и отправьте тестовое сообщение:

Здравствуйте, ответьте одной фразой.

Если ответ пришел корректно, вернитесь в CC Switch и проверьте логи прокси-трафика. Наличие записей запросов означает, что цепочка соединений работает.

10. Часто задаваемые вопросы

1. Как вернуться к официальному аккаунту Claude?

В панели Claude Desktop в CC Switch отключите текущего стороннего поставщика или переключитесь обратно на официальную конфигурацию, затем перезапустите Claude Desktop.

2. Как переключаться между несколькими поставщиками?

В панели Claude Desktop выберите другого поставщика, нажмите «Включить», затем перезапустите Claude Desktop. Менять локальную маршрутизацию при этом не нужно.

3. Можно ли подключать так же Claude Code?

Можно. CC Switch управляет Claude Code и Claude Desktop на отдельных панелях. Разница в том, что Claude Code обычно удобнее для сценариев разработки в командной строке, а Claude Desktop — для повседневного диалога, обработки материалов и работы на рабочем столе.

В документации DeepSeek также приведена конфигурация окружения для Claude Code, например через ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL.

4. Как диагностировать ошибки подключения?

Проверьте в первую очередь:

1. Нет ли лишнего / в конце адреса запроса; 2. Полностью ли скопирован API Key; 3. Выбран ли формат API Anthropic Messages; 4. Включено ли переключение «Нужны сопоставления моделей»; 5. Верно ли записаны реальные ID моделей в сопоставлении; 6. Запущен ли главный переключатель локальной маршрутизации; 7. Отмечена ли маршрутизация приложения Claude; 8. На самом ли деле Claude Desktop завершен и перезапущен.

Большинство сбоев подключения сводятся к API Key, URL endpoint, ID моделей или отключенной локальной маршрутизации.

5. Нужно ли держать CC Switch постоянно открытым?

Если вы используете модели не из семейства Claude и полагаетесь на сопоставление моделей, CC Switch должен работать в фоне.

Можно включить Lightweight Mode (легкий режим), чтобы после закрытия главного окна оставался только процесс в трее, а локальная маршрутизация продолжала работать.

11. Как лучше использовать на практике?

Мой совет:

  • Ежедневное письмо, доработка контента для веба: можно подключить модели с лучшим соотношением цена/качество на OpenRouter;
  • Обработка больших китайских текстов, помощь в коде, сложное рассуждение: можно попробовать DeepSeek V4 Pro;
  • Низкозатратное тестирование: в первую очередь используйте дешевые или бесплатные модели;
  • Критически важные задачи: всё ещё лучше возвращаться к официальному Claude, OpenAI или стабильным платным моделям.

Главное преимущество сторонних поставщиков — гибкость и дешевизна, но нужно учитывать стабильность, приватность, задержку и различия в способностях моделей. Не стоит привязывать все важные рабочие процессы к одному дешёвому поставщику: лучше сохранять резервные варианты.

12. Итоги

Значение CC Switch v3.15.0 в том, что она переводит подключение сторонних моделей в Claude Desktop с режима «ручного заполнения конфигурации» на режим «графического переключения поставщика».

Ключевой процесс можно свести к пяти шагам:

Установить CC Switch → Открыть панель Claude Desktop → Добавить поставщика → Настроить сопоставление моделей → Включить локальную маршрутизацию и перезапустить Claude Desktop

Если понять два понятия — «сопоставление моделей» и «локальная маршрутизация» — подключить к Claude Desktop OpenRouter, DeepSeek и другие модели не из семейства Claude становится относительно проще.

Ссылки

Share

Поделиться статьёй