# CC Switch

Настольный менеджер провайдеров ИИ-инструментов для кодирования, локальной маршрутизации, агрегации моделей, MCP, навыков, промптов, сессий и использования.

> Это Markdown-версия страницы CC Switch на OpenNavo с теми же сведениями, что и на веб-странице: <https://opennavo.com/ru/apps/cc-switch>

- **Последняя версия**: `4.0.38`
- **Разработчик**: Jason Young (farion1231) and contributors
- **Главная**: <https://github.com/farion1231/cc-switch>
- **Категории**: [Инструменты разработки](https://opennavo.com/ru/categories/developer-tools)
- **Установка**: `brew install --cask cc-switch`
- **Установки за последние 30 дней**: 8 243
- **Homebrew**: Можно установить, приложение обновляется само
- **Ссылка для загрузки**: <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
- **SHA-256**: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`

SHA-256 лишь проверяет, что файл скачан полностью; это не сертификат безопасности.

## Состав установки и удаления

```json
[
  {
    "declaration": {
      "app": [
        "CC Switch.app"
      ],
      "target": "/Applications/CC Switch.app"
    },
    "phase": "install",
    "sources": [
      "CC Switch.app"
    ],
    "target": "/Applications/CC Switch.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.cc-switch",
            "~/Library/Application Support/com.ccswitch.desktop",
            "~/Library/Caches/com.ccswitch.desktop",
            "~/Library/Preferences/com.ccswitch.desktop.plist",
            "~/Library/Saved Application State/com.ccswitch.desktop.savedState",
            "~/Library/WebKit/com.ccswitch.desktop"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## Описание

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

### Возможности
- Переключение параметров подключения к провайдерам с сохранением остальных настроек клиента.
- Выбор прямых подключений, локальной маршрутизации с преобразованием и переключением при сбоях либо агрегации на основе моделей для поддерживаемых клиентов. Агрегация не обеспечивает переключение при сбоях.
- Управление Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, Pi и MiniMax Code; отдельные интеграции различаются.
- Синхронизация поддерживаемых конфигураций MCP и навыков, а также редактирование промптов для конкретных инструментов.
- Просмотр этапов сессий, результатов работы инструментов и изменений, поиск и экспорт переписки, возобновление поддерживаемых сессий.
- Просмотр использования запросов, примерных расходов, квот провайдеров и сведений об учетных записях, если интеграции это поддерживают.

### Установка и требования
Установите зарегистрированный Mac cask с помощью `brew install --cask cc-switch` либо скачайте официальный DMG, откройте его и скопируйте CC Switch в папку Applications. Официальная сборка для Mac универсальна и предназначена для Apple Silicon и Intel; требуется macOS12 или новее. По данным сопровождающего, сборка подписана и нотариально заверена. В cask не указаны дополнительные зависимости-формулы или явные конфликты. Настройте провайдера или импортируйте поддерживаемую существующую конфигурацию, затем выберите нужный режим. Для управляемых инструментов кодирования требуются собственные установки, среды выполнения, разрешения и учетные записи.

Сопровождающий также предоставляет пакеты для Windows10+ (включая сборки ARM) и Linux для x86_64/ARM64. Для Linux требуются glibc2.35+ и WebKitGTK4.1, например в Ubuntu22.04+ или Debian12+; RHEL/Rocky/Alma8–9 не поддерживаются согласно заявленным требованиям выпуска. Поддерживаемая мобильная версия не подтверждена. В указанном руководстве не опубликованы минимальные требования к ОЗУ и свободному месту на диске. Проверенный DMG для Mac версии 4.0.4 имеет размер 33,926,314 байт; это размер загрузки, а не занимаемое после установки место.

### Совместимость и обновления
Маршрутизация и агрегация зависят от локального шлюза и поддержки протокола вышестоящей стороной. Для агрегации Claude Code требуется Claude Code2.1.243 или новее. После переключения перезапустите Codex, Gemini CLI и Grok Build, если появится запрос; изменения агрегации Claude Code применяются без перезапуска. Для сети WSL действуют отдельные требования к localhost.

Версия 4.0 меняет способ сохранения настроек и удаляет распространенные фрагменты конфигурации. Она переносит базу данных на схему 20 и автоматически создает резервную копию в `~/.cc-switch/backups/`; клиент версии 3.x не сможет открыть новую базу данных. Перед откатом или изменением существующих настроек ознакомьтесь с официальными примечаниями к обновлению. Существующие предустановки провайдеров не заменяются новыми значениями по умолчанию без уведомления.

### Учетные записи, расходы и лицензия
CC Switch распространяется по лицензии MIT (авторское право принадлежит Jason Young); приложением можно пользоваться без покупки подписки CC Switch. У каждого провайдера ИИ отдельные способы аутентификации, стоимость подписки/API и условия обслуживания. Для соответствующих операций провайдера нужны API-ключи и учетные данные; оценка стоимости запросов не является счетом. По умолчанию конфигурация и данные сессий хранятся локально в `~/.cc-switch`. Синхронизация Cloud/WebDAV и конечные точки ретрансляции предполагают отдельный выбор учетных записей и способов обработки данных.

Источники: [Официальный проект и требования](https://github.com/farion1231/cc-switch), [Примечания к выпуску 4.0.4 на английском языке](https://github.com/farion1231/cc-switch/blob/main/docs/release-notes/v4.0.4-en.md), [Лицензия](https://github.com/farion1231/cc-switch/blob/main/LICENSE).

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

- macOS 12 или новее · Версия приложения: 4.0.38 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Проверено 2026-11-21
  - <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
  - SHA-256: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`
- macOS 12 или новее · Версия приложения: 4.0.38 · Чип Apple · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Проверено 2026-11-21
  - <https://github.com/farion1231/cc-switch/releases/download/v4.0.38/CC-Switch-v4.0.38-macOS.dmg>
  - SHA-256: `940a6bd07ad472f101b68ee788ece5eac94782f10ee37212d96eae98f87e18a2`

## Факты о безопасности CC Switch

Здесь перечислены только факты, которые можно проверить, с источником и датой; это не сертификат безопасности. Чтобы проверить скачанные файлы, просканируйте их в OpenNavo на своём Mac.

- <https://github.com/farion1231/cc-switch> · Открытый исходный код: Да — <https://github.com/farion1231/cc-switch> · Проверено 2026-11-14

## Удаление

- `brew uninstall --cask cc-switch`

Обычное удаление стирает приложение, но оставляет настройки и кеш.

### Глубокая очистка (по желанию)

- `brew uninstall --zap --cask cc-switch`

`--zap` также удаляет настройки, кеш и другие файлы, перечисленные в определении Homebrew. Среди них могут быть данные, общие с другими приложениями; после удаления их нельзя восстановить. Полное отсутствие остаточных файлов тоже не гарантируется. Сначала создайте резервную копию данных, которые нужно сохранить. Чтобы сохранить настройки и кеш, не добавляйте `--zap`.

Обычное удаление стирает приложение, но оставляет настройки и кеш.

- Файлы и папки: `~/.cc-switch` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Application Support/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Caches/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Preferences/com.ccswitch.desktop.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/Saved Application State/com.ccswitch.desktop.savedState` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.
- Файлы и папки: `~/Library/WebKit/com.ccswitch.desktop` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Эти пункты взяты из определения Homebrew, проверенного 2026-11-21. Они показывают только то, что по определению должно удаляться, и не означают, что всё это есть на вашем Mac.

## Примечания к последнему выпуску

### 4.0.38 (2026-11-21)

CC Switch 4.0.38 чинит импорт поставщиков, аккаунты Antigravity в Linux и чтение сессий.

CC Switch 4.0.38, вышедший 21 ноября 2026 года, — выпуск с исправлениями для тех, кто переключает поставщиков и сессии между агентами для программирования. Ссылки импорта в один клик теперь приносят поставщиков WorkBuddy, а в Linux аккаунты Antigravity переключаются в центре авторизации.

Источник: https://github.com/farion1231/cc-switch/releases/tag/v4.0.38

- Ссылка ccswitch:// импортирует поставщиков WorkBuddy, и в ней должна быть модель.
- В Linux вход и смена аккаунта Antigravity находятся в центре авторизации, а учётные данные лежат в системной связке ключей.
- Список сессий Antigravity убирает пустые, остаточные и внутренние побочные сессии, а просмотр показывает рассуждение, вызовы инструментов и результаты.
- YAML DeepSeek Harness, где выключенный уровень мышления стал false, больше не стирает всех сторонних поставщиков.
- Открытие CC Switch из Finder больше не помечает рабочую установку npm как неспособную запуститься.
- Поиск сессий и запросы расхода делают меньше работы, а главное окно не сжимается в белую полосу и не прячется под строкой меню macOS.

## Сведения и источники

- <https://opennavo.com/ru/apps/cc-switch>
- <https://opennavo.com/ru/apps/cc-switch/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/cc-switch.rb> · Проверено 2026-11-21
- <https://formulae.brew.sh/cask/cc-switch>
- <https://github.com/farion1231/cc-switch> · Проверено 2026-11-14
