CC Switch — переключение API в один клик

По мере роста популярности таких инструментов для ИИ-программирования, как Claude Code, OpenAI Codex и Gemini CLI, разработчикам часто приходится переключаться между несколькими поставщиками API — официальными API, локальными зеркалами, сторонними прокси... Ручное редактирование файлов конфигурации каждый раз — это и утомительно, и чревато ошибками.

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

Особенности Описание
🔄 Переключение провайдеров в один клик Сохраняйте несколько конфигураций API и переключайтесь одним кликом — не нужно вручную редактировать JSON
🖥️ Единое управление для нескольких приложений Одновременно управляйте пятью инструментами: Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw
🛡️ Локальный прокси для API Встроенный высокопроизводительный HTTP-прокси с автоматическим переключением при сбоях и мониторингом запросов
🔌 Управление серверами MCP Визуально добавляйте, редактируйте и синхронизируйте конфигурации серверов MCP
📊 Статистика использования Просматривайте потребление токенов и расходы на API в реальном времени
💾 Резервное копирование и восстановление Автоматически создавайте резервные копии конфигураций для предотвращения потери данных из-за случайных операций

Поддерживаемые приложения

  • 🤖 Claude Code(Anthropic)
  • ⚡ Codex(OpenAI)
  • ✨ Gemini CLI(Google)
  • 🧩 OpenCode(с открытым исходным кодом)
  • 🦅 OpenClaw(Пятое приложение, новое в v3.11.0)

Установка

Перейдите наGitHub Releases: https://github.com/farion1231/cc-switch/releases/latestСкачайте установщик для вашей платформы.

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

Системные требования

Система Минимальная версия Архитектура
Windows Windows 10 и выше x64
macOS macOS 10.15 (Catalina) и выше Intel (x64) / Apple Silicon (arm64)
Linux См. таблицу ниже x64 / arm64

Windows

Файл Описание
CC-Switch-vX.X.X-Windows.msi ✅ Рекомендуется— установщик MSI, поддерживает автоматические обновления
CC-Switch-vX.X.X-Windows-Portable.zip Портативная версия: распакуйте и запустите, не вносит записи в реестр

Дважды щёлкните по файлу MSI и следуйте указаниям мастера, чтобы завершить установку. Затем найдите «CC Switch» в меню «Пуск» и запустите его.

⚠️ Функция «установка в один клик» отключена в версии для Windows, чтобы избежать побочных эффектов от обработчиков протоколов. Если вам нужно установить такие инструменты, как Claude Code, установите их вручную, а затем управляйте ими через CC Switch.

macOS

Способ 1: прямое скачивание (рекомендуется)

  1. СкачатьCC-Switch-vX.X.X-macOS.zip
  2. После распаковки перетащитеCC Switch.appв папку «Программы»
  3. При первом запуске щёлкните правой кнопкой мыши → «Открыть» или перейдите в «Системные настройки → Конфиденциальность и безопасность → Всё равно открыть»

⚠️ Поскольку у автора нет учётной записи разработчика Apple, macOS может показать предупреждение «Неизвестный разработчик». После закрытия предупреждения перейдите в «Системные настройки → Конфиденциальность и безопасность» и нажмите «Всё равно открыть». После этого приложение будет запускаться нормально каждый раз.

Способ 2: Homebrew

# 添加 tap 并安装
brew tap farion1231/ccswitch
brew install --cask cc-switch
# 更新
brew upgrade --cask cc-switch

Linux

Выберите соответствующий формат в зависимости от вашего дистрибутива:

Дистрибутив Рекомендуемый формат Команда установки
Ubuntu / Debian / Mint .deb sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / Rocky .rpm sudo dnf install ./CC-Switch-*.rpm
openSUSE .rpm sudo zypper install ./CC-Switch-*.rpm
Arch / Manjaro / Другие .AppImage См. ниже

Использование AppImage:

chmod +x CC-Switch-*.AppImage
./CC-Switch-*.AppImage

Быстрый старт

После установки выполните первоначальную настройку, следуя этим шагам:

Шаг 1: Запустите CC Switch

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

Шаг 2: Выберите приложение для управления

В верхней части главного интерфейса находится панель переключения приложений. Нажмите соответствующую иконку (Claude Code / Codex / Gemini CLI и т. д.), чтобы переключить текущее управляемое приложение. Вы можете скрыть ненужные приложения в настройках.

Шаг 3: Добавьте первого провайдера

Нажмите кнопку в правом верхнем углу+и выберите один из встроенных пресетов (например, официальный API Anthropic, DeepSeek, Alibaba Bailian и т. д.) или вручную заполните следующую информацию:

  • Название: Имя-примечание для удобной идентификации
  • Ключ API: API-ключ, предоставленный поставщиком услуг
  • Базовый URL(необязательно): Пользовательский адрес прокси
  • Модель: Укажите имя модели по умолчанию для использования
  • Формат API: Собственный формат Anthropic Messages или совместимый формат OpenAI Chat Completions

Шаг 4: Переключение провайдера

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

Запуститеclaudeкоманду прямо в терминале, и новая конфигурация будет использована.

Шаг 5: Проверка конфигурации (необязательно)

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

💡 НажмитеCmd/Ctrl + ,чтобы быстро открыть Настройки; нажмитеESCчтобы закрыть текущую панель.


Расширенные функции

Управление сервером MCP

В панели "MCP" можно визуально добавлять, редактировать и удалять серверы MCP (Model Context Protocol). Конфигурации автоматически синхронизируются с соответствующими инструментами CLI, поддерживается импорт существующих конфигураций MCP из установленных приложений в один клик.

Управление навыками

Skills — это функция улучшения промптов в Claude Code. CC Switch поддерживает:

  • Установку Skills из репозиториев GitHub (встроенные предустановленные репозитории, такие какbaoyu-skillsи т.д.)
  • Установка из локальных ZIP-файлов
  • Управление Skills для Claude Code и Codex

Менеджер сессий

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

Управление резервными копиями

CC Switch автоматически создаёт резервные копии базы данных регулярно, а также перед миграцией базы данных. В разделе "Настройки → Управление резервными копиями" можно: просматривать все резервные копии, переименовывать, удалять и вручную создавать резервные копии.

Статистика использования и выставление счетов

На странице «Использование» отображается статистика потребления токенов; поддерживаются автообновление, анализ частоты попаданий в кэш и просмотр расходов по моделям и провайдерам, что помогает держать расходы на API под контролем.

Claude Rectifier (исправление сигнатуры Thinking)

При использовании некоторых сторонних API-шлюзов формат блоков thinking Claude может быть несовместим. После включения Rectifier прокси-слой автоматически исправит эту проблему. Переключатель находится в разделе «Настройки → Дополнительно».

Автосинхронизация WebDAV

Поддерживается синхронизация базы данных с сервисом WebDAV (например, Nutstore), что позволяет совместно использовать конфигурацию на нескольких устройствах. Встроенный механизм защиты больших файлов предотвращает случайные загрузки.

Другие расширения