Руководство по подключению 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 Можно выбрать один из вариантов:
- OpenRouter: https://openrouter.ai
- DeepSeek Platform: https://platform.deepseek.com
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:
Перейдите на страницу Keys и создайте API Key:
2. Добавление OpenRouter в CC Switch
В «Добавить поставщика» выберите пресет OpenRouter и заполните поля:
| Поле | Значение |
|---|---|
| Название поставщика | OpenRouter |
| Сайт | https://openrouter.ai |
| API Key | Вставьте OpenRouter Key |
| Адрес запроса | https://openrouter.ai/api |
| Формат API | Anthropic Messages (нативный) |
| Нужны сопоставления моделей | Включено |
Важно: рекомендуется не ставить / в конце адреса запроса.
3. Рекомендуемая настройка сопоставления моделей
Ring 2.6 1T не относится к семейству Claude, поэтому роли Claude Desktop нужно сопоставить с реальными ID моделей OpenRouter.
Можно добавить три строки:
| Роль модели | Отображаемое имя в меню | Фактическая модель запроса | Поддержка 1M |
|---|---|---|---|
| Sonnet | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | Не отмечено |
| Opus | inclusionai/ring-2.6-1t | inclusionai/ring-2.6-1t | Не отмечено |
| Haiku | inclusionai/ring-2.6-1t | inclusionai/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:
Перейдите на страницу API Keys и создайте ключ. Обычно для вызова API DeepSeek нужно сначала пополнить баланс.
2. Добавление DeepSeek в CC Switch
В «Добавить поставщика» выберите пресет DeepSeek и заполните:
| Поле | Значение |
|---|---|
| Название поставщика | DeepSeek |
| Сайт | https://platform.deepseek.com |
| API Key | Вставьте DeepSeek Key |
| Адрес запроса | https://api.deepseek.com/anthropic |
| Формат API | Anthropic Messages (нативный) |
| Нужны сопоставления моделей | Включено |
Важно: здесь используется /anthropic, а не /v1.
3. Рекомендуемая настройка сопоставления моделей
Можно распределить модели так: «более дешевые модели для повседневных задач, более мощные — для сложных»:
| Роль модели | Отображаемое имя в меню | Фактическая модель запроса | Поддержка 1M |
|---|---|---|---|
| Sonnet | deepseek-v4-flash | deepseek-v4-flash | Отмечено |
| Opus | deepseek-v4-pro | deepseek-v4-pro | Отмечено |
| Haiku | deepseek-v4-flash | deepseek-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