Переключение провайдера в Claude Code: руководство по CC Switch за 5 минут

В этом руководстве описана CC Switch v4.0.26 (ноябрь 2026 года). Названия кнопок могут измениться в следующих версиях, но модель конфигурации остаётся прежней.

Чтобы переключить Claude Code между провайдерами, обычно приходится редактировать ~/.claude/settings.json: менять базовый URL, API-ключ и иногда модель. С одним провайдером это несложно. С двумя или тремя настройка превращается в небольшую рутинную работу — и сбой можно не заметить: устаревшая переменная ANTHROPIC_*, заданная в оболочке, может переопределить файл, который вы только что отредактировали.

CC Switch заменяет эту процедуру карточкой, на которую достаточно нажать. Встроенный пресет AiHubMix заполняет эндпоинт, а вам остаётся вставить API-ключ. Обычно Claude Code подхватывает изменения без перезапуска. В этом руководстве мы разберём полную настройку, а затем объясним, что именно записывает CC Switch, где таится ловушка с переменными окружения и когда достаточно прямого режима.

Если нужна только краткая версия: установите CC Switch, создайте ключ AIHubMix, выберите пресет AiHubMix в разделе Claude Code, вставьте ключ, добавьте ANTHROPIC_MODEL=claude-sonnet-5-5 в настройки провайдера, нажмите Переключить и выполните claude -p "1+1, output only the answer" --model claude-sonnet-5-5. Остальная часть статьи подробно объясняет эти шаги.

Что такое CC Switch

CC Switch — приложение с открытым исходным кодом для компьютеров (MIT, Tauri + Rust + React), позволяющее управлять конфигурациями провайдеров в Claude Code, Codex, Gemini CLI, OpenCode и других инструментах для программирования. В приложении есть более 90 пресетов провайдеров, а также поддержка пользовательских провайдеров.

Это не просто переключатель ключей:

• Прямой режим меняет поля с ключами в конфигурационном файле клиента, после чего клиент обращается к провайдеру напрямую.
• Режим маршрутизации запускает локальный шлюз по адресу 127.0.0.1:15721 с преобразованием форматов API, переключением при сбоях, проверками работоспособности и журналами запросов.
• Режим объединения собирает модели нескольких провайдеров в единый список /model.

Репозиторий и руководство пользователя доступны по адресу github.com/farion1231/cc-switch. Официальные источники загрузки — только ccswitch.io и страница GitHub Releases. Сайты, запрашивающие оплату или учётные данные, не являются официальными.

Перед началом

Вам понадобятся три вещи:

• Установленный Claude Code, который запускается из терминала. Проверьте это командой claude --version. Если приложение не установлено, воспользуйтесь официальным установщиком: curl -fsSL https://claude.ai/install.sh | bash или npm i -g @anthropic-ai/claude-code при наличии Node.js 22 или новее.
• Учётная запись AIHubMix и API-ключ. Создайте ключ в консоли AIHubMix. Обычно он начинается с sk-.
• Установщик CC Switch. Скачайте его с сайта ccswitch.io или со страницы GitHub Releases.

Шаг 1. Установите CC Switch

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

Если Claude Code ещё не установлен, его можно установить или обновить на странице Apps в CC Switch.

Шаг 2. Создайте API-ключ AIHubMix

Откройте страницу API-ключей AIHubMix, создайте ключ и скопируйте его.

Обозначение AIHUBMIX_API_KEY в документации — не настоящий ключ. Если вставить его как есть, запрос завершится ошибкой 401 invalid key: AIHUBMIX_API_KEY.

Шаг 3. Добавьте AIHubMix в Claude Code

1. Выберите Claude Code на боковой панели слева.
2. Нажмите кнопку + в правом верхнем углу.
3. Найдите AiHubMix через поиск или в категории сторонних платформ.
4. Название и эндпоинт заполняются автоматически: https://aihubmix.com. Вставьте ключ в поле API Key.
5. Нажмите Добавить.

Пресет задаёт две переменные окружения:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com"
  }
}

Пресет не задаёт модель. В руководстве AIHubMix переменная ANTHROPIC_MODEL указана как основная, поэтому добавьте её в тот же блок env перед переключением:

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5"
  }
}

Если не указать модель, Claude Code отправит ID модели по умолчанию, который может отсутствовать среди моделей AIHubMix.

Стоит учесть две детали.

Не добавляйте /v1 к базовому URL. Claude Code использует протокол Anthropic Messages и самостоятельно формирует путь запроса. Правильный адрес — https://aihubmix.com; https://aihubmix.com/v1 — базовый URL с совместимостью с OpenAI для других клиентов, и Claude Code допишет к нему собственный /v1/messages.

В пресете используется ANTHROPIC_API_KEY, а в собственном руководстве AIHubMix по Claude Code — ANTHROPIC_AUTH_TOKEN. AIHubMix принимает оба варианта: ANTHROPIC_AUTH_TOKEN отправляет заголовок Bearer, а ANTHROPIC_API_KEY — x-api-key. Выберите один вариант. Не указывайте оба с разными значениями. Подробности настройки AIHubMix, ID моделей и описание ошибок приведены в документации AIHubMix по Claude Code.

Если пресета нет — например, в старой версии или после удаления карточки — выберите Пользовательская конфигурация и вставьте JSON, приведённый выше. В менеджере эндпоинтов карточки провайдера можно проверить задержку. В пресете также указан альтернативный эндпоинт https://api.aihubmix.com на случай, если aihubmix.com не разрешается.

Шаг 4. Переключитесь и проверьте работу

На вкладке Direct нажмите Переключить на карточке AiHubMix. После записи конфигурации на кнопке появится надпись Используется.

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

Проверьте весь путь запроса:

claude -p "1+1, output only the answer" --model claude-sonnet-5-5

Ответ 2 означает, что запрос дошёл до AIHubMix. В интерактивном сеансе строка Anthropic base URL в выводе команды /status должна содержать https://aihubmix.com.

Для быстрого переключения воспользуйтесь системным треем: щёлкните правой кнопкой мыши значок CC Switch, откройте подменю Claude Code и выберите провайдера. В заголовке подменю отображаются активный провайдер и сводка по квоте.

Чтобы вернуться к официальному провайдеру, переключитесь на Claude Official, перезапустите Claude Code и пройдите процесс входа.

Что именно меняется при переключении

В прямом режиме CC Switch заменяет только поля подключения и совместимости в файле ~/.claude/settings.json: ANTHROPIC_*, AWS_*, селекторы протокола, такие как CLAUDE_CODE_USE_BEDROCK, а также model, apiKeyHelper и некоторые параметры совместимости для конкретных провайдеров, например CLAUDE_CODE_DISABLE_ARTIFACT и размер контекстного окна.

permissions, hooks, enabledPlugins, statusLine, конфигурация MCP, комментарии и всё остальное, что вы добавили, остаются на месте. Полный список приведён в справочнике по файлу конфигурации.

Перед первой перезаписью конфигурации инструмента CC Switch сохраняет её копию в ~/.cc-switch/backups/live-first-write/. Если JSON содержит синтаксические ошибки, приложение отказывается записывать изменения, указывает строку и столбец и оставляет файл без изменений.

Ловушка: устаревшие переменные ANTHROPIC_*

Именно из-за этой проблемы может показаться, что CC Switch не сработал.

Если раньше вы следовали руководству по ручной настройке и добавили export ANTHROPIC_BASE_URL=... или export ANTHROPIC_AUTH_TOKEN=... в ~/.zshrc или ~/.bash_profile, эти переменные могут переопределить значения, записанные CC Switch. Вы переключаете карточку на AIHubMix, но запросы по-прежнему идут на старый эндпоинт.

CC Switch обнаруживает конфликт. В верхней части окна появляется жёлтое предупреждение о том, что переменные окружения могут переопределять конфигурацию; в подробностях указаны имя переменной, её значение и источник. Кнопка Удалить выбранные удаляет их, предварительно сохраняя резервную копию в ~/.cc-switch/backups/env-backup-<timestamp>.json.

Чтобы проверить вручную:

grep -n "ANTHROPIC" ~/.zshrc ~/.bash_profile 2>/dev/null

Закомментируйте старые команды экспорта, затем выполните source ~/.zshrc или откройте новый терминал. В документации AIHubMix рекомендуется удалять глобальные переменные ANTHROPIC_*, если конфигурацией управляет CC Switch. Полный порядок действий при конфликте описан в справочнике по переменным окружения.

Псевдонимы моделей и переключение

Если задана ANTHROPIC_MODEL, Claude Code по умолчанию использует Sonnet 5.5. Для псевдонимов /model (opus, sonnet, haiku, fable) нужно отдельно задать соответствие ID моделей AIHubMix. Добавьте эти ключи в env:

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

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-your-key",
    "ANTHROPIC_BASE_URL": "https://aihubmix.com",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_DEFAULT_FABLE_MODEL": "claude-fable-5-1"
  }
}

Приоритет выбора модели, от самого высокого к самому низкому: /model <name> → claude --model <name> → ANTHROPIC_MODEL → поле model в settings.json. Скопируйте ID моделей из списка моделей AIHubMix: регистр символов имеет значение.

Когда использовать маршрутизацию или объединение

Для AIHubMix обычно лучше всего подходит прямой режим. Эндпоинт уже поддерживает протокол Anthropic Messages, поэтому преобразование протокола не требуется.

Используйте маршрутизацию, если нужна очередь переключения при сбоях или если вы хотите подключить к Claude Code провайдера с форматом OpenAI. В режиме маршрутизации Claude Code обращается к http://127.0.0.1:15721, ключ в конфигурации заменяется на PROXY_MANAGED, а CC Switch подставляет настоящий ключ. Приложение должно оставаться запущенным; при выходе из CC Switch прямая конфигурация восстанавливается. Официальные подписки Claude не работают через маршрутизацию — для них используйте прямой режим.

Используйте агрегацию, если хотите видеть модели нескольких провайдеров в одном списке /model. Запросы без префикса обрабатывает провайдер по умолчанию; модели других провайдеров отображаются с префиксом ccs-. Агрегация не обеспечивает переключение на резервный вариант. Она доступна только для Claude Code и Codex; подписки Claude Official в режиме агрегации не поддерживаются. Для списка моделей с префиксом ccs- требуется Claude Code версии 2.1.243 или новее. Claude Code сразу применяет изменения списка моделей, а Codex нужно полностью перезапустить.

Что ещё умеет CC Switch

• Использование: панель объединяет журналы маршрутизируемых запросов и локальных сеансов. Сеансы можно сканировать и без маршрутизации; стоимость рассчитывается исходя из модели, указанной в журнале. Маршрутизируемые запросы записываются отдельно.
• MCP: единая панель управления MCP-серверами с синхронизацией в выбранные вами приложения.
• Навыки: находите, устанавливайте и удаляйте навыки в одном месте.
• Сеансы: ищите, просматривайте, экспортируйте и возобновляйте локальные сеансы.
• Проекты: сохраняйте конфигурацию провайдера проекта, MCP-серверы, навыки и файлы памяти в виде снимка, а затем переключайте весь набор для каждого проекта.

Данные хранятся в ~/.cc-switch/, а в основе лежит база данных SQLite. По умолчанию автоматическое резервное копирование сохраняет 10 последних копий; также доступна синхронизация через WebDAV или S3-совместимое хранилище. База данных и экспортированные резервные копии содержат конфигурации провайдеров, в том числе ключи, поэтому обращайтесь с ними как с секретными данными.

Решение проблем

Ниже приведены тексты ошибок из документации AIHubMix по Claude Code.

Если ошибка не отображается:

• Появляется экран входа или сообщение Not logged in: проверьте /status; в разделе Settings → App config → Claude Code включите Skip Claude Code first-run confirmation; перезапустите приложение и убедитесь, что ключ указан.
• Переключение не действует: возможно, осталась устаревшая переменная оболочки или закэшированный сеанс; откройте новый терминал или перезапустите Claude Code.
• Проверка соединения в карточке проходит, но запросы не работают: проверяется доступность, а не ключ или модель; выполните сквозную проверку командой claude -p.
• Хотите вернуться к официальному провайдеру: переключитесь на Claude Official, перезапустите Claude Code и войдите в систему снова.

Если на macOS команда claude не найдена, официальный установщик обычно размещает её в ~/.local/bin/claude. Добавьте export PATH="$HOME/.local/bin:$PATH" в профиль оболочки и откройте новый терминал.

Контрольный список

• [ ] Установите CC Switch с ccswitch.io или из GitHub Releases.
• [ ] Создайте API-ключ в консоли AIHubMix.
• [ ] В Claude Code → + → AiHubMix → вставьте ключ → Добавить.
• [ ] Добавьте ANTHROPIC_MODEL=claude-sonnet-5-5 в JSON-конфигурацию провайдера.
• [ ] Нажмите Переключить и убедитесь, что на карточке указано Используется.
• [ ] Удалите устаревшие переменные ANTHROPIC_* из профиля оболочки.
• [ ] Выполните claude -p "1+1, output only the answer" --model claude-sonnet-5-5 и проверьте, что результат — 2.

Если последняя команда возвращает 2, переключение провайдера завершено. Осталось добавить нужные псевдонимы моделей и решить, нужны ли вам маршрутизация или агрегация; большинству пользователей AIHubMix достаточно прямого режима.

Часто задаваемые вопросы

CC Switch бесплатен?
Да. Это проект с открытым исходным кодом, распространяемый по лицензии MIT. Вы платите только провайдеру, API которого используете.

Переключение удалит мои хуки, MCP-серверы или плагины?
Нет. При прямом переключении заменяются эндпоинт, ключ, модель и несколько параметров, относящихся к провайдеру. Хуки, разрешения, MCP-серверы, плагины и настройки строки состояния остаются в файле.

Загружает ли CC Switch мой API-ключ?
Конфигурации провайдеров хранятся локально в ~/.cc-switch/cc-switch.db. Если включить синхронизацию через WebDAV или S3, они будут синхронизироваться с хранилищем под вашим контролем. Базы данных и резервные копии содержат ключи, поэтому обращайтесь с ними как с секретными данными.

Нужно ли оставлять CC Switch запущенным?
В прямом режиме — нет. Для маршрутизации и агрегации приложение должно быть запущено; после выхода из CC Switch клиент возвращается в прямой режим.

Можно ли одновременно использовать Claude Official и AIHubMix?
В прямом режиме в каждый момент времени активен только один провайдер. Агрегация позволяет объединить модели нескольких провайдеров в одном списке, но подписка Claude Official в этом режиме не поддерживается; чтобы использовать её, переключитесь обратно в прямой режим.

Работает ли программа в Windows?
Да. CC Switch поддерживает Windows 10 и более поздние версии; доступен установщик .msi или портативная сборка. Для Linux требуются glibc 2.35+ и WebKitGTK 4.1.

Почему карточка провайдера показывает, что соединение работает, а Claude Code всё равно выдаёт ошибку?
Проверка соединения в карточке определяет, доступен ли эндпоинт. Она не проверяет API-ключ или модель. Для проверки всей цепочки выполните команду claude -p.

Источники

• Репозиторий CC Switch
• Руководство пользователя CC Switch: добавление провайдера
• Руководство пользователя CC Switch: переключение провайдера
• Руководство пользователя CC Switch: файлы конфигурации
• Документация AIHubMix: Claude Code