CC Switch: Управляйте поставщиками AI-кодирования, не нарушая вашу настройку

Последнее тестирование и обновление: 26 августа 2026

CC Switch — это бесплатный десктопный менеджер с открытым исходным кодом для файлов конфигурации, используемых инструментами AI-кодирования. Текущий проект описывает поддержку Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw и Hermes Agent.

Он полезен, когда у вас уже есть более одного легитимного поставщика моделей или необходимо поддерживать серверы MCP и навыки синхронизированными между несколькими клиентами. Это не подписка на модели, не поставщик API и не способ обойти условия использования инструмента. Карта поставщика — это всего лишь профиль конфигурации, пока целевой CLI успешно не выполнит запрос через него.

В этом руководстве для первого теста используется один поставщик и один клиент. Ваша цель:

1. ваша исходная конфигурация сохранена;
2. CC Switch показывает выбранного поставщика как активного;
3. целевой клиент начинает работу с ожидаемой модели или конечной точки;
4. один небольшой тестовый запрос проходит успешно;
5. вы можете восстановить исходный логин или конфигурацию.

Знайте, что изменяет CC Switch

CC Switch записывает в реальную конфигурацию, используемую каждым поддерживаемым клиентом. Важные места включают:

Клиент	Общие рабочие файлы	Активация после переключения
Claude Code	~/.claude/settings.json	Обычно перезагружается сразу
Codex	~/.codex/auth.json и ~/.codex/config.toml	Перезапустите терминал/клиент
Gemini CLI	~/.gemini/.env и ~/.gemini/settings.json	Прочитать снова при следующем запросе
OpenCode	~/.config/opencode/opencode.json	Перезапустите клиент
Гермес	~/.hermes/config.yaml и связанные данные провайдера	Перезапустите или перезагрузите соответствующую поверхность Hermes

CC Switch хранит собственный источник правды под ~/.cc-switch/, включая базу данных SQLite, настройки устройства, навыки, резервные копии навыков и резервные копии конфигураций. Переключение, таким образом, является реальным изменением локальной конфигурации, а не визуальным предпочтением.

Шаг 1: выберите надежный выпуск

26 августа 2026 года был выпущен самый новый стабильный релиз на GitHub v3.20.0, опубликованный 18 августа. Всегда проверяйте последний официальный релиз вместо того, чтобы позже копировать этот номер версии.

Проект предупреждает, что CC Switch является бесплатным и распространяется только через:

• ccswitch.io
• официальный репозиторий GitHub
• официальные релизы GitHub

Не используйте сайт или клиент, который взимает плату за CC Switch, просит пополнить баланс CC Switch или запрашивает пароль вашей учетной записи. Поставщики API могут взимать плату отдельно; проверяйте каждого поставщика самостоятельно, прежде чем передавать ему ключ или отправлять приватный код.

Текущие задокументированные минимальные требования: Windows 10 или новее, macOS 12 Monterey или новее, а также поддерживаемые современные дистрибутивы Linux. Выпуск v3.20.0 предоставляет пакеты для macOS на Intel/Apple-silicon, пакеты для Linux x64/ARM64 и пакеты для Windows x64/ARM64.

Шаг 2: установите CC Switch

macOS

Homebrew — это самый короткий поддерживаемый путь:

brew install --бочка cc-switch

Или скачайте текущую версию macOS .dmg, откройте её и перетащите Переключатель CC в Приложения. Проект заявляет, что текущие сборки macOS подписаны и нотариально заверены.

Windows

Скачайте MSI, соответствующий вашей архитектуре, с официальной страницы релиза. Используйте обычный Windows.msi для x64 или явно обозначенный MSI для ARM64 для Windows на Arm. Портативный ZIP полезен для временного теста, но MSI является стандартным способом установки.

Linux

Скачайте пакет, который соответствует и дистрибутиву, и архитектуре. Для скачанного пакета Debian или Ubuntu:

судо dpkg -i CC-Switch-v3.20.0-Linux-x86_64.deb
судо apt-get install -f

Используйте имя файла ARM64 на машине ARM64. Также доступны сборки AppImage:

chmod +x CC-Switch-v3.20.0-Linux-x86_64.AppImage
./CC-Switch-v3.20.0-Linux-x86_64.AppImage

Не копируйте эти устаревшие имена файлов после того, как версия v3.20.0 перестанет быть актуальной. Выберите соответствующий файл из релиза, который вы проверили.

Шаг 3: подтвердите клиент, которым вы хотите управлять

CC Switch управляет конфигурацией; он не заменяет целевой CLI. Убедитесь, что клиент уже запущен, перед тем как добавлять другой слой:

клод --version
codex --version
gemini --version

Запускайте только команду для используемого вами клиента. Если команды нет, сначала установите этого клиента согласно его официальной документации. Устранение отсутствующего CLI и настройка провайдера — разные задачи.

Запустите CC Switch и проверьте:

• что главное окно открывается;
• что значок в трее или на панели меню отображается;
• что переключатель приложений включает установленного вами клиента;
• Настройки → О программе отображают ожидаемую версию.

Шаг 4: экспорт перед первым переключением

Открыть Настройки → Управление данными → Экспорт конфигурации и сохраните экспорт в безопасном месте. Относитесь к нему как к конфиденциальной информации: экспорты провайдеров могут содержать конечные точки, идентификаторы и учетные данные API.

Запишите небольшую карту отката без копирования секретов:

Дата: 26.08.2026
Версия переключателя CC: [версия, указанная в 'О программе']
Клиент: [Claude Code / Codex / Gemini CLI / другой поддерживаемый клиент]
Исходная аутентификация: [официальный вход / указанный провайдер]
Исходная модель: [отображаемое название модели]
Экспорт сохранен: [да]
Тестовый проект: [имя временной папки]

Если вы уже используете официальный OAuth-вход, убедитесь, что можете определить профиль официального входа перед добавлением чего-либо еще. Для Codex официальное кэширование аутентификации и настройки провайдера времени выполнения разделены; не перезаписывайте. auth.json случайно.

Шаг 5: добавьте одного провайдера

Выберите целевое приложение, затем нажмите кнопку + Выберите Провайдер, специфичный для приложения для этого первого теста. Универсальный провайдер изменяет несколько интерфейсов приложения и труднее диагностируется при сбое.

Используйте этот порядок:

1. Выберите официальную предустановку провайдера, если она существует.
2. Дайте профилю имя, которое идентифицирует провайдера и цель.
3. Подтвердите конечную точку согласно документации провайдера.
4. Вставляйте ключ API только в предназначенное для этого поле секрета.
5. Выберите или получите модель, которую провайдер действительно предоставляет.
6. Добавьте заметку с информацией о счёте или биллинге, не включая ключ.
7. Сохраните профиль.

Кнопка получения модели вызывает совместимую с OpenAI функцию провайдера /v1/models конечная точка, когда поддерживается. Ошибка 404 или ошибка парсинга может означать, что конечная точка не реализует этот стандарт; это не разрешение угадывать идентификатор модели.

Контрольный список доверия поставщика

Перед отправкой реальной работы через неофициального поставщика убедитесь:

• кто им управляет и где находятся его условия и политика конфиденциальности;
• регистрируются ли подсказки, код, вызовы инструментов и результаты;
• как представлены биллинг и идентичность модели;
• разрешено ли использовать поставщика для данных вашего работодателя или клиента;
• как отозвать ключ и получить записи использования.

Предустановка доказывает только то, что CC Switch знает форму конфигурации. Она не доказывает независимо безопасность поставщика, точность модели, платежеспособность или утверждения о ценообразовании.

Шаг 6: переключитесь и проверьте реальный результат

Щелкнуть Включить на новой карте провайдера. Активная карта должна получить метку текущего состояния. Для Codex и OpenCode закройте и снова откройте терминал/клиент. Claude Code и Gemini CLI обычно подхватывают изменения без полного перезапуска, но перезапуск — это чистый первый тест.

Проверьте соответствующий живой файл, не показывая секрет на общем экране. Например:

sed -n '1,160p' "$HOME/.codex/config.toml

Не выводите auth.json, .env, или другой файл с учетными данными в запись, вставленный баг-репорт или публичную историю терминала. Проверяйте поля с секретами локально в редакторе, который не используется совместно.

Теперь откройте одноразовый проект и сделайте один ограниченный запрос:

Сообщите текущий рабочий каталог и определите активную модель или провайдера, если клиент это отображает. Не редактируйте файлы, не запускайте инструменты и не просматривайте родительские каталоги. Прекратите после отчета.

Даже один короткий запрос к API может повлечь оплату провайдеру. Принимайте тест только тогда, когда клиент отвечает, активный профиль остается выбранным, и на странице использования провайдера или в запросе использования CC Switch видно соответствующий запрос, если эти данные доступны.

Шаг 7: подтвердите откат

Переключитесь обратно на исходный профиль official-login или провайдера. Перезапустите клиент, если этого требует модель активации, затем повторите тест только для чтения.

Если исходное состояние не вернется:

1. остановите клиент;
2. используйте элемент управления CC Switch для импорта/восстановления с экспортом, который вы создали;
3. снова проверьте рабочую конфигурацию;
4. откройте клиент снова;
5. не удаляйте ~/.cc-switch/ до завершения восстановления.

Возможность возврата является частью настройки, а не необязательным мероприятием по восстановлению после катастрофы.

Необязательно: локальный прокси, использование и резервирование

CC Switch может запускать локальный прокси, обычно на http://127.0.0.1:15721, для регистрации запросов, оценки использования, преобразования поддерживаемых форматов API и маршрутизации сбоев на резервные копии.

Используйте его только после того, как прямое переключение работает:

1. Открыть Настройки → Дополнительно → Сервис прокси.
2. Оставьте адрес прослушивания на 127.0.0.1 для одного компьютера.
3. Запустите прокси и включите перехват только для клиента, который тестируется.
4. Сделайте один короткий запрос.
5. Подтвердите, что журнал запросов показывает ожидаемое приложение, поставщика, модель, задержку и статус.
6. Остановите прокси и подтвердите, что CC Switch восстанавливает исходную прямую конфигурацию.

Не привязывайте прокси 0.0.0.0 только чтобы ошибка исчезла. Это может сделать слушателя доступным в локальной сети. Если вам действительно нужен доступ к LAN, сначала разработайте аутентификацию, правила файрвола, ведение журналов и обработку данных.

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

Дополнительно: синхронизируйте серверы MCP и навыки

CC Switch может записывать конфигурацию MCP на поддерживаемые клиенты и поддерживать повторно используемые навыки.

Для MCP:

1. Импортируйте существующий проверенный сервер или добавьте один проверенный сервер.
2. Проверьте его команду, аргументы, рабочую директорию, переменные окружения и сетевое соединение.
3. Включите только один переключатель целевого приложения.
4. Перезапустите этого клиента и убедитесь, что указанный сервер появился.
5. Вызовите один безвредный инструмент только для чтения и проверьте запись выполнения.

Для навыков:

1. Просмотрите исходный репозиторий и полную папку Skills.
2. Установите один навык в целевое приложение.
3. Попросите клиента определить навык и объяснить, когда он будет его использовать.
4. Запустите ограниченный тест и проверьте действия инструментов/файлов.
5. Используйте процесс резервного копирования/восстановления CC Switch перед удалением важного навыка.

Сервер MCP может выполнять команды или передавать данные. Навык может давать агенту указания для выполнения действий. Ни один из них не становится надежным только потому, что он появляется в каталоге.

Устранение неполадок

Симптом	Вероятная причина	Восстановление
Клиент отсутствует в CC Switch	Его каталог конфигурации не создан или путь к приложению кастомный	Запустите клиент один раз, затем укажите его каталог в настройках CC Switch
Карта провайдера активна, но старая модель остается	Клиент сохранил текущую конфигурацию	Полностью закройте и снова откройте клиент; Codex требует перезапуска после переключения
Переключение не удалось из-за ошибки файла	Конфигурация заблокирована, имеет неправильный формат или недоступна для записи	Закройте клиент, проверьте формат файла и владение каталогом перед повторной попыткой
Тест возвращает 401 или 403	Неверный ключ, неверное поле аутентификации, истекшие учетные данные или политика провайдера	Отозвать скомпрометированные ключи, создать ключ с правильными правами в официальной консоли провайдера и проверить ожидаемый метод аутентификации
Сборка модели возвращает 404 или 405	Провайдер не раскрывает /v1/models	Вручную введите задокументированный идентификатор модели; не рассматривайте отказ конечной точки как недействительный ключ
Прокси сообщает о «адресе уже используется»	Другой процесс владеет портом	Останавливать этот процесс только если вы его распознаёте, или выбирайте неиспользуемый локальный порт, пока прокси остановлен
Резервное переключение никогда не активируется	Очередь прокси, захвата, авторезервного перекопирования или резервного копирования неполна	Проверьте все четыре требования и проведите контролируемый тест на отказ с небольшим бюджетом
Удалённые записи MCP снова появляются	Два источника конфигураций всё ещё синхронизируются	Выберите один источник истины, отключите дублирующий переплет и просмотрите полученный живой файл

Обновить или удалить

На macOS с Homebrew:

brew обновление --бочка cc-switch

CC Switch также проверяет обновления в Настройки → О программе. Читайте примечания к выпуску, если обновление изменяет объединение провайдеров, сохранение OAuth, захват прокси, историю сессий или синхронизацию навыков.

Чтобы удалить на macOS, переместите приложение в Корзину или используйте Homebrew. На Windows используйте Настройки → Приложения. На Linux удалите пакет с помощью менеджера пакетов, который использовался для установки.

Сохранить ~/.cc-switch/ до тех пор, пока вы не восстановите официальные конфигурации клиента и не решите, нужны ли еще экспорты, база данных, журналы и резервные копии навыков. Удаление этой директории — это отдельное решение по удалению данных от деинсталляции приложения.

FAQ

Нужен ли мне CC Switch для одного официального провайдера?

Обычно нет. Собственный логин официального клиента проще и имеет меньше уровней настройки. CC Switch становится полезным, когда настоящей проблемой является переключение, синхронизация, проверка использования или резервирование.

Предоставляет ли CC Switch доступ к API?

Нет. Вам всё равно нужен легитимный официальный логин, подписка или API-учетные данные от выбранного провайдера.

Является ли предустановка провайдера одобрением?

Нет. Это удобный шаблон. Проверьте компанию, конечную точку, условия, конфиденциальность, биллинг и идентичность модели самостоятельно.

Почему Codex не изменился сразу?

CC Switch указывает, что Codex требует перезапуска терминала после переключения провайдера. Закройте текущий процесс и откройте новый.

Могу ли я синхронизировать свой экспорт через облачное хранилище?

Вы можете, но экспорт может содержать учетные данные. Используйте защищенное шифрованием место с контролем доступа и проверьте содержимое перед загрузкой куда-либо.

Стоит ли включать резервное подключение прокси с первого дня?

Нет. Сначала подтвердите прямое переключение и откат. Добавляйте один уровень маршрутизации за раз, чтобы можно было выявить, какой уровень не удался и куда пошли данные.

Официальные источники

• Официальное репозиторий CC Switch
• Последний официальный выпуск
• Руководство пользователя на английском
• Руководство по установке
• Переключение провайдера
• Прокси-сервис
• Конфигурационные файлы и резервные копии

Что дальше

Создайте более легкую рабочую среду Mac с учетом разрешений в T02: Vorssaint для macOS.