CC Switch — единый менеджер AI-инструментов

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

Главная проблема, которую решает проект, проста: у каждого инструмента свой формат конфигурации. Для перехода на другого API-провайдера приходится вручную править JSON, TOML или .env, а MCP и Skills нужно настраивать отдельно для разных приложений. CC Switch заменяет этот ручной процесс визуальным интерфейсом с импортом провайдеров в один клик и быстрым переключением между ними.

Что умеет приложение

Управление провайдерами

В приложении доступны более 50 встроенных пресетов провайдеров, включая AWS Bedrock, NVIDIA NIM и релеев от сообщества. Провайдера можно добавить из пресета или создать собственную конфигурацию. Переключение доступно из основного интерфейса и из меню system tray, а конфигурации можно импортировать, экспортировать и сортировать перетаскиванием.

Отдельная функция универсальных провайдеров позволяет использовать одну конфигурацию сразу в Claude Code, Codex и Gemini CLI. Это удобно, когда один и тот же набор параметров нужен нескольким инструментам, но их форматы всё ещё нужно синхронизировать автоматически.

Прокси и отказоустойчивость

CC Switch умеет работать как локальный прокси с hot-switching. В этом режиме приложение выполняет конвертацию форматов запросов, автоматически переключается на резервный маршрут при сбое, применяет circuit breaker, отслеживает состояние провайдеров и исправляет некорректные запросы.

Проксирование можно включать на уровне отдельного приложения или провайдера. Поддерживается независимое перехватывание трафика для Claude, Codex, Gemini и Grok Build. Это полезно, когда нужно протестировать альтернативный endpoint или автоматически переживать недоступность текущего провайдера.

MCP, Prompts и Skills

Единая панель MCP позволяет управлять MCP-серверами для поддерживаемых инструментов с двусторонней синхронизацией. Сервер можно добавить из шаблона или собственной конфигурации, а затем включать или отключать синхронизацию для каждого приложения. Импорт поддерживается через Deep Link.

Prompts редактируются в Markdown и синхронизируются с файлами CLAUDE.md, AGENTS.md и GEMINI.md. В приложении предусмотрена защита от нежелательного backfill, то есть от потери уже существующих данных при обновлении конфигурации.

Skills можно устанавливать из GitHub-репозиториев и ZIP-файлов, добавлять собственные репозитории и распространять навыки через symlink или копирование файлов. Для приложений, которые ожидают обычные файлы в своих каталогах, предусмотрен файловый режим.

Сессии и рабочее пространство

Session Manager позволяет просматривать, искать и восстанавливать историю разговоров из поддерживаемых источников сессий. Для OpenClaw есть отдельный редактор workspace: в нём можно изменять AGENTS.md, SOUL.md и другие файлы агента с предварительным просмотром Markdown.

Это отдельный слой над обычным переключением провайдеров. Он помогает восстановить контекст работы с разными AI-инструментами, не переходя вручную к их каталогам данных.

Как это устроено

Desktop-приложение построено на Tauri 2. Frontend написан на React и TypeScript, а backend использует Rust. В архитектуре выделяются команды Tauri, сервисы, слой доступа к данным и SQLite-компоненты.

В качестве единого источника данных используется база ~/.cc-switch/cc-switch.db. В ней хранятся провайдеры, MCP-серверы, Prompts и Skills. Локальные настройки устройства вынесены в ~/.cc-switch/settings.json, поэтому их можно отделить от синхронизируемых данных.

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

Для разработки проекта используются Node.js 18+, pnpm 8+, Rust 1.85+ и Tauri CLI 2.8+. В репозитории есть команды для dev-режима, typecheck, форматирования, unit-тестов frontend и сборки Tauri-приложения. Backend проверяется через cargo fmt, cargo clippy и cargo test.

Установка

CC Switch выпускается для Windows, macOS и Linux. Для macOS доступна установка через Homebrew:

brew install --cask cc-switch

Обновление выполняется отдельной командой:

brew upgrade --cask cc-switch

Для Arch Linux README предлагает paru:

paru -S cc-switch-bin

На Windows и Linux можно скачать MSI, portable ZIP, DEB, RPM или AppImage со страницы Releases. Для macOS доступны DMG и ZIP. Официальный Flatpak в релизы не входит: его можно собрать самостоятельно из DEB по инструкции из Flatpak README.

Для Linux-систем с Wayland и NVIDIA README описывает отдельный escape hatch. Если клики не работают или при изменении размера окна появляется чёрный экран, приложение можно запустить с нативным Wayland:

CC_SWITCH_GDK_BACKEND=wayland ./CC-Switch-*.AppImage

Для tiling-композиторов, где наоборот лучше работает X11, значение переменной меняется на x11.

Синхронизация и хранение данных

Провайдеры можно синхронизировать через Dropbox, OneDrive, iCloud, WebDAV-сервер или пользовательский каталог конфигурации. Также поддерживаются Deep Link ccswitch:// для импорта провайдеров, MCP-серверов, Prompts и Skills.

Основные пути хранения:

• ~/.cc-switch/cc-switch.db — SQLite-база с провайдерами, MCP, Prompts и Skills;
• ~/.cc-switch/settings.json — настройки интерфейса на уровне устройства;
• ~/.cc-switch/backups/ — автоматические резервные копии, последние 10 версий;
• ~/.cc-switch/skills/ — Skills, по умолчанию связанные symlink с соответствующими приложениями;
• ~/.cc-switch/skill-backups/ — резервные копии Skills, последние 20 версий.

Минимальное вмешательство

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

Для возврата к официальному провайдеру нужно добавить соответствующий пресет, переключиться на него и пройти штатный процесс Log out / Log in. В Codex поддерживается переключение между несколькими официальными аккаунтами Plus или Team.

Подробные сценарии настройки провайдеров, MCP, Prompts, Skills, прокси и других функций собраны в пользовательском руководстве. История изменений доступна в Changelog, а отдельные заметки о релизе — в Release Notes.

Итог

CC Switch — это не новый coding agent, а слой управления окружением вокруг уже используемых AI-инструментов. Он сводит в единый desktop-интерфейс провайдеров, локальный прокси, MCP, Prompts, Skills, сессии, резервные копии и синхронизацию. Для разработчика, который работает с несколькими Claude Code, Codex, OpenCode или Gemini CLI одновременно, это способ уменьшить ручную работу с конфигурациями и сделать переключение между рабочими окружениями предсказуемее.