CC Switch 4.0: режим агрегации и импорт в один клик
По состоянию на 2026-10-13 CC Switch 4.0 разделил прямое подключение, маршрутизацию и агрегацию на три вкладки вверху каждой страницы приложения: в официальных release notes новый режим агрегации описан как режим, который собирает модели от нескольких провайдеров в один список моделей в Claude Code или Codex, и каждый запрос уходит к провайдеру выбранной модели, без выхода из клиента. Все сведения об CC Switch на этой странице взяты из официальных релизов на GitHub и README: v4.0.0 опубликован 2026-10-04, v4.0.10 — 2026-10-12, а самый свежий релиз в официальном списке на момент проверки — v4.0.11 от 2026-10-13. Отдельной консольной версии CC Switch не существует: в официальном README прямо написано, что это только десктопное приложение с графическим интерфейсом. Начиная с v4.0.10 deep-ссылка ccswitch:// не теряется, даже если приложение не запущено; ссылка может объявлять формат API, а в диалоге подтверждения выбирают, переключаться ли сразу после импорта.
Обновлено 2026-10-13
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard / AMEX или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре ключевых факта
Прямой / Маршрутизация / Агрегация
По официальным release notes, каждая страница приложения теперь начинается с этих трёх вкладок; клик по вкладке меняет только то, что вы видите, и не трогает конфигурацию, кнопка реального переключения режимов описывает, что произойдёт, а возврат к прямому режиму делается в один шаг и отменяется.
Версия Claude Code для агрегации
В разделе про агрегацию в официальном README сказано, что агрегация не даёт переключения на резерв и что Claude Code нужен версии 2.1.243 или новее; после изменения агрегированного списка Codex требует перезапуска, а Claude Code — нет.
Ссылки импорта в один клик
Главная тема v4.0.10. Официальная формулировка: клик по ссылке при незапущенном приложении больше не приводит к потере — ссылка сначала сохраняется, а обработанной считается только после появления диалога подтверждения. В диалоге появился переключатель «сразу перейти к этому провайдеру после импорта», по умолчанию выключен.
Ссылка объявляет формат API
Новый параметр для владельцев сайтов в v4.0.10: один параметр объявляет, какой формат API использует сервис (anthropic, openai_chat, openai_responses и другие), а CC Switch подставляет поля, которые понятны каждому приложению; поведение ссылок без этого параметра не изменилось.
Что именно делает режим агрегации
По состоянию на 2026-10-13 агрегация — это третий способ подключения, добавленный в CC Switch 4.0, и release notes описывают его как режим, который собирает модели от нескольких провайдеров в один список моделей в Claude Code или Codex, чтобы переключать их прямо в клиенте. Описан и прежний сценарий: раньше, чтобы взять модель другого провайдера, нужно было вернуться в CC Switch, переключить провайдера и только потом вернуться к работе; теперь несколько провайдеров добавлены — и их модели появляются в списке выбора моделей клиента, а запрос уходит к провайдеру выбранной модели. Ограничения также официальные: агрегацию нужно включать вручную, она поддерживает Claude Code и Codex, распределяет запросы по выбранной модели и не даёт переключения на резерв; конвертация форматов и резервирование относятся к маршрутизации. README добавляет два условия: Claude Code версии 2.1.243 или новее, а официальные подписки Claude в агрегации пока не поддерживаются. В этой версии переписан и механизм записи конфигурации: при переключении провайдера заменяются только адрес, ключ, модель и протокол, всё остальное сохраняется как было.
Содержание официальных релизов и их даты
Описание релиза v4.0.0 начинается с фразы, что это самое крупное обновление CC Switch на сегодня; в официальном релизе на GitHub published_at указан как 2026-10-04T11:01:01Z, а в метаданных prerelease стоит true. Подзаголовок v4.0.10 называет его шестым исправительным релизом стабильной линии 4.0, published_at — 2026-10-12T16:38:21Z, prerelease — false, а первое предложение говорит, что главная тема релиза — ссылки импорта в один клик (deep-ссылки ccswitch://); одновременно вышли руководства для владельцев сайтов на китайском, английском и японском и онлайн-генератор ссылок. Следом 2026-10-13 вышел v4.0.11 (published_at 2026-10-13T15:35:29Z, prerelease false) — на момент проверки это самый свежий пункт официального списка релизов; релиз, по его собственному описанию, добавляет удаление установленных инструментов со страницы «Приложения» и по умолчанию включает проверку остатка по плану во всех приложениях, а не только в Claude Code. В v4.0.10 переписали и описание режимов подключения, начав с сильных сторон каждого: прямой режим ближе всего к штатной работе клиента, маршрутизация переключает провайдера на горячую и даёт резервирование с конвертацией форматов, агрегация переключает модели нескольких провайдеров внутри клиента. Есть и предыстория: CC Switch вышел в августе 2025 года, когда форматы API различались сильнее, поэтому переключение провайдера изначально делалось полной перезаписью файла — теперь его заменила замена ключевых полей.
Хронология вокруг 4.0
Самая ранняя запись в официальном списке релизов CC Switch на GitHub — v2.0.3 с published_at 2025-08-22T00:12:40Z; релиз v4.0.0 тоже относит появление CC Switch к августу 2025 года.
Вышел v4.0.0 с prerelease true в метаданных GitHub: интерфейс переработан от боковой панели до трей, появилась агрегация, а запись конфигурации заменила полную перезапись заменой ключевых полей.
Вышел v4.0.10 с prerelease false: deep-ссылки ccswitch:// больше не теряются при незапущенном приложении, добавлены параметры для владельцев сайтов (в том числе apiFormat) и онлайн-генератор, а в режиме маршрутизации алиас модели haiku в settings.json изменился с claude-haiku-4-5 на claude-haiku-5-5.
Подтверждённое и то, о чём официальные страницы молчат
Подтверждено (дословно в release notes и README)
Каждый пункт ниже можно проверить слово в слово по текстам релизов и README, сохранённым для этой страницы: прямой режим, маршрутизация и агрегация разнесены по трём вкладкам, и клик по вкладке не меняет конфигурацию; агрегация собирает модели нескольких провайдеров в один список моделей Claude Code или Codex и распределяет запросы по выбранной модели; агрегация включается вручную, пока охватывает Claude Code и Codex, не даёт резервирования, требует Claude Code 2.1.243 или новее и не поддерживает официальные подписки Claude; после изменения агрегированного списка Codex нужно перезапустить, а Claude Code — нет; переключение провайдера вместо полной перезаписи меняет только адрес, ключ, модель и протокол; v4.0.10 чинит потерю deep-ссылки при незапущенном приложении, добавляет в диалог подтверждения переключатель немедленного перехода (по умолчанию выключен) и параметр apiFormat; онлайн-генератор работает с четырьмя типами — провайдеры, MCP, промпты и скиллы; даты публикации — 2026-10-04 для v4.0.0, 2026-10-12 для v4.0.10 и 2026-10-13 для v4.0.11, взяты из поля published_at.
Неподтверждённое и неофициальное
По трём вопросам первичных источников нет, поэтому не стройте на них планы. Первое: консольная версия самого CC Switch — README прямо пишет, что приложение выпускается только как десктопное, с графическим интерфейсом, и единственное исключение, которое он называет, это поддерживаемый сообществом CC Switch CLI, отдельный проект с собственными релизами; поэтому на этой странице нет команд для управления CC Switch из терминала. Второе: официальные страницы расходятся в том, что считать стабильной версией — у v4.0.0 prerelease стоит true, а v4.0.10 называет 4.0 стабильной линией при prerelease false, и у v4.0.11 тоже prerelease false; страница приводит только даты из published_at и выводов не делает. Третье: споры в интернете о том, какой из похожих инструментов лучше, первичных источников не имеют и здесь не пересказываются; в v4.0.10 сказано, что структура базы данных осталась 20, но это не обещание совместимости для будущих версий.
Прямой, маршрутизация, агрегация: как выбирать
Прямой против маршрутизации
В официальной классификации прямой режим подключает клиента сразу к провайдеру и подходит на каждый день; маршрутизация передаёт запросы через локальный сервис на вашей машине к одному провайдеру, умеет конвертировать форматы API и настраивать резервирование — это нужно при несовпадении протокола или когда резервирование требуется. Конфигурации Codex для QCode маршрутизация не нужна: в документации QCode сказано, что переключатель локальной маршрутизации в редакторе провайдера Codex предназначен для сервисов, которые говорят только на Chat Completions, а QCode сам предоставляет протокол Responses, поэтому его держать включённым не следует.
Маршрутизация против агрегации
Оба режима идут через локальный сервис на вашей машине, различается распределение: маршрутизация отдаёт запросы одному провайдеру, агрегация распределяет их по нескольким в зависимости от выбранной модели — это то, что нужно, когда в одной сессии вы хотите смешивать модели. Агрегация не даёт резервирования, включается вручную и пока охватывает только Claude Code и Codex, а официальные подписки Claude в ней не поддерживаются. Официальное предупреждение и о расходах: при смене модели посреди сессии новая модель заново строит кэш промптов, поэтому первый ход после переключения обходится заметно дороже.
Как добавить QCode в CC Switch 4.0
① Установка или обновление: официальный README даёт пакеты десктопной версии и команды пакетных менеджеров — msi или portable zip для Windows 10 и новее, brew install --cask cc-switch для macOS 12 и новее, paru -S cc-switch-bin для Arch, а для остальных дистрибутивов Linux — .deb, .rpm или .AppImage. По работе в терминале README отвечает однозначно: сам CC Switch выпускается только как десктопное приложение с графическим интерфейсом, а для серверов, SSH-сессий и машин без рабочего стола он рекомендует поддерживаемый сообществом CC Switch CLI — отдельный проект с интерактивным терминальным интерфейсом (TUI) и командным режимом, который ставится командой brew install cc-switch-cli; там же указано, что по умолчанию оба продукта делят каталог данных ~/.cc-switch и что версия структуры базы, которую понимает CLI, иногда отстаёт от десктопной. ② Конфигурация Claude — по документации QCode: запустите CC Switch, в переключателе приложений выберите Claude, нажмите плюс в правом верхнем углу, в пресетах выберите «Свой» (Custom), укажите ANTHROPIC_BASE_URL https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN — ключ из консоли, начинающийся с cr_. После сохранения нажмите Enable на карточке: CC Switch запишет оба значения в ~/.claude/settings.json, а подключение проверяется запуском claude в терминале. ③ Конфигурация Codex: добавьте своего провайдера на странице Codex с Base URL https://api.qcode.cc/openai; в config.toml из документации провайдер назван qcode (документация рекомендует нижний регистр, чтобы имя подходило в качестве ключа TOML), wire_api остаётся responses, модель по умолчанию — gpt-6-sol или gpt-5.6-terra, а переключатель локальной маршрутизации не включайте; версию Codex смотрите выводом codex --version на своей машине. ④ Если нужна агрегация: откройте вкладку «Агрегация» на странице Claude или Codex, добавьте провайдеров, которые хотите смешивать, затем выберите один как основной — запросы без указанной агрегированной модели уйдут к нему, а при изменении списка моделей перезапустите клиент (у Codex CLI перезапуск фонового сервиса есть прямо в баннере). ⑤ Если импорт по ссылке: после клика по ccswitch:// появляется диалог подтверждения импорта; если нужно сразу перейти на нового провайдера, включите в нём переключатель (по умолчанию выключен) — при включении он предупреждает, что запросы клиента уйдут на адрес из ссылки. Документация QCode добавляет, что при первом запуске по deep-ссылке приложение перестраивает окно и это занимает чуть больше времени.
Как это делается на QCode
Сам CC Switch не является эндпоинтом — он лишь пишет конфигурационные файлы каждого CLI, а работает ключ, который вы получили в QCode. Один ключ из консоли, начинающийся с cr_, покрывает оба протокола: ключ протокол не различает, всё решает путь запроса. В конфигурации Claude указывают ANTHROPIC_BASE_URL https://api.qcode.cc/api (протокол Anthropic, полный путь /api/v1/messages), в конфигурации Codex — base_url https://api.qcode.cc/openai и wire_api responses. Модели Claude ходят только по эндпоинту протокола Anthropic; если вписать такую модель в совместимый с OpenAI путь, вы получите ошибку. Список вызываемых моделей QCode включает claude-sonnet-5, claude-sonnet-5-5, claude-opus-5, claude-opus-5-5, claude-haiku-5-5, gpt-6.1-sol, gpt-6-sol, gpt-5.6-sol и gpt-5.6-terra. Начать работу можно с пополнения баланса: сначала пополнение, затем покупка тарифа за счёт этого баланса. Доступны Alipay, WeChat Pay, банковские карты (Visa, Mastercard, AMEX), Apple Pay, Google Pay и криптовалюта (много сетей и монет), при этом для платежей в рублях есть СБП и российские банковские карты — вы платите в рублях, а баланс начисляется в долларах, и эти способы видны только при русском интерфейсе. Пополнение в юанях начинается от ¥100, диапазон долларовых пополнений — от $1 до $2,000. Оплата за токены; цены каждой модели указаны на /models.
Частые вопросы
Что такое режим агрегации в CC Switch 4.0?
Это один список моделей для нескольких провайдеров. В официальных release notes новый режим агрегации описан как режим, который собирает модели от нескольких провайдеров в один список моделей в Claude Code или Codex, и переключать их можно прямо в клиенте: запрос уходит к провайдеру выбранной модели, не выходя из клиента. Режим нужно включать вручную, он поддерживает Claude Code и Codex, распределяет запросы по выбранной модели и не даёт переключения на резерв.
Есть ли у CC Switch командная строка (CLI)?
У самого CC Switch — нет. В официальном README есть ответ на вопрос о консольной или headless-версии: приложение выпускается только в виде десктопной программы, которой нужен графический интерфейс. Для серверов, SSH-сессий и машин без рабочего стола README рекомендует поддерживаемый сообществом CC Switch CLI — это отдельный проект, релизы которого не связаны с десктопной версией; у него есть интерактивный терминальный интерфейс (TUI) и командный режим, ставится он командой brew install cc-switch-cli, по умолчанию делит с десктопной версией каталог данных ~/.cc-switch, и там же предупреждается, что версия структуры базы данных, которую понимает CLI, иногда отстаёт. Ещё одна связанная с CLI функция в README — страница «Приложения»: там показывают и обновляют версии самих командных инструментов, таких как Claude Code и Codex, а не управляют CC Switch из терминала. Поэтому на этой странице нет команд для управления CC Switch из терминала; приводимые команды установки взяты из README дословно.
Теряется ли ссылка импорта ccswitch://, если приложение закрыто?
Нет, с v4.0.10 не теряется. В релизе описано прежнее поведение: на Windows и Linux клик по ссылке импорта при незапущенном CC Switch запускал приложение, но диалог подтверждения не появлялся, в лёгком режиме ссылка терялась при перестройке окна, а на macOS один и тот же диалог показывали дважды. Теперь ссылка сначала сохраняется и считается обработанной только после появления диалога, поэтому прерывание её не теряет, а старая ссылка, пришедшая позже, не перетирает новую. Документация QCode добавляет, что при первом запуске по ccswitch:// приложение перестраивает окно и это занимает чуть больше времени.
Какие эндпоинты указывать в провайдерах Claude и Codex в CC Switch?
Сохраните по одному провайдеру QCode для каждого клиента: в записи Claude укажите ANTHROPIC_BASE_URL https://api.qcode.cc/api и ключ, начинающийся с cr_, в записи Codex — base_url https://api.qcode.cc/openai и wire_api responses. Оба используют один и тот же API-ключ QCode.cc; по документации QCode они делят квоту тарифа, повторного списания нет. Модели Claude работают только по эндпоинту протокола Anthropic и в совместимый с OpenAI путь их вписать нельзя.
О чём помнить при работе с агрегацией?
О пяти официальных пунктах. Claude Code нужен версии 2.1.243 или новее; агрегация не даёт переключения на резерв; её включают вручную, и пока она поддерживает Claude Code и Codex, а официальные подписки Claude в ней недоступны; после изменения агрегированного списка Codex нужно перезапустить, а Claude Code не нужно; при смене модели посреди сессии новая модель заново строит кэш промптов, поэтому первый ход после переключения обходится заметно дороже.
Как пополнить QCode из материкового Китая, если нет зарубежной карты?
Через Alipay или WeChat Pay. В документации QCode о способах оплаты сказано, что при платежах в юанях из материкового Китая основной выбор — Alipay (комиссию не перекладывают на пользователя), а WeChat Pay служит запасным вариантом, и оба зачисляют средства на баланс в юанях; там же указана нижняя граница пополнения в юанях — ¥100. После пополнения скопируйте ключ cr_ из консоли в карточку своего провайдера CC Switch и приступайте к работе. Если вы платите из России, доступны СБП и российские банковские карты: вы платите в рублях, а баланс начисляется в долларах. Оплата за токены; цены каждой модели указаны на /models.
Источники
По CC Switch: тексты и метаданные двух релизов GitHub в официальном репозитории farion1231/cc-switch — v4.0.0 (published_at 2026-10-04T11:01:01Z, prerelease true) и v4.0.10 (published_at 2026-10-12T16:38:21Z, prerelease false), а также README из main; всё получено 2026-10-13. По QCode: страница docs.qcode.cc о настройке CC Switch (помечено обновлением 2026-10-08), страница об эндпоинтах и путях API, обзор способов оплаты (обновлён 2026-10-01) — получены в тот же день. Заметки к релизу v4.0.11 и официальный список релизов получены 2026-10-14.
Один API-ключ и для Claude Code, и для Codex
В записи Claude укажите https://api.qcode.cc/api, в записи Codex — https://api.qcode.cc/openai; оба провайдера работают с одним и тем же ключом QCode.cc и расходуют одну квоту тарифа. Оплата за токены; цены каждой модели указаны на /models.
Похожие материалы
CC Switch: переключение API в Claude Code и Codex
Как создать своего провайдера QCode на странице Claude, указать ANTHROPIC_BASE_URL https://api.qcode.cc/api и ключ cr_, нажать Enable, чтобы запись попала в settings.json; для Codex отдельная запись на /openai, плюс разбор случаев, когда переключение не применилось и когда приходит 401.
Codex CLI со сторонним API: config.toml, base_url и ошибки
Как соотносятся model_provider, base_url, wire_api и env_key в config.toml и как читать типовые ошибки.
Claude Code в Китае (2026): Alipay и WeChat Pay
Направьте ANTHROPIC_BASE_URL на QCode из материкового Китая и пополните баланс через Alipay или WeChat Pay — зарубежная карта не нужна.
Факты на этой странице проверены 2026-10-13; записи релизов, задающие актуальную версию, получены и сверены заново 2026-10-14. CC Switch — сторонний открытый проект (лицензия MIT): его возможности, тексты интерфейса и поведение переключения определяются официальными страницами релизов и README; эта страница не даёт обещаний о совместимости от его имени и не выражает позицию проектов. Поля конфигурации и способы оплаты QCode следуют официальной документации, изменения в ней могут происходить без предупреждения. Доступность моделей определяется тем, что показано на /models.