Настройка CC Switch

Подключите QCode.cc через CC Switch к Claude Code и Codex CLI: формы, несколько тарифов, сосуществование с официальным входом, переключение без эффекта и восстановление перезаписанного конфига

Настройка CC Switch¶

CC Switch — кросс-платформенное десктопное приложение (Windows / macOS / Linux), которое предоставляет единый визуальный интерфейс для управления конфигурацией API-провайдеров для CLI-инструментов, таких как Claude Code, Codex, Gemini CLI, OpenCode и OpenClaw. В этом руководстве рассказывается, как добавить QCode.cc в качестве пользовательского провайдера в CC Switch, как переключаться между несколькими провайдерами/аккаунтами в один клик, а также рассматриваются типичные сценарии использования и устранение неполадок.

Зачем использовать CC Switch¶

• Без ручного редактирования конфигов: визуальные формы заменяют settings.json / config.toml
• Переключение провайдера в один клик: мгновенно переключайтесь между qcode.cc, официальным Anthropic и локальными прокси
• Экосистема Claude + Codex: управляйте конфигурациями Claude Code и Codex CLI в одном приложении
• Управление несколькими аккаунтами / тарифами: сохраняйте несколько конфигов для одного провайдера (например, рабочий ключ и личный ключ) и переключайтесь в любой момент
• Быстрый доступ из системного трея: переключайте провайдеров из меню трея без открытия главного окна

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

Предварительные требования¶

• Установлен Claude Code CLI или Codex CLI
• API-ключ QCode.cc (начинается с cr_), доступный в личном кабинете
• Один и тот же ключ работает с несколькими протокольными эндпоинтами (Anthropic, OpenAI, Gemini и др.) — см. Эндпоинты и форматы API

Установка CC Switch¶

Скачайте установщик для вашей платформы с GitHub Releases:

Точные шаги установки и предупреждения о подписи для каждой платформы смотрите в README проекта.

Настройка провайдера Claude (для Claude Code)¶

Запустите CC Switch → переключитесь на вкладку Claude слева → нажмите Добавить провайдера (Add Provider) в правом верхнем углу → выберите Пользовательский (Custom) → заполните поля как показано:

Почему asia.qcode.cc? Это гонконгский узел QCode.cc с наименьшей задержкой для пользователей материкового Китая; вернитесь на api.qcode.cc (глобальный Route 53), если он нестабилен. Один и тот же ключ работает на всех четырёх доменах: api / asia / us / eu.

После сохранения нажмите Активировать (Activate), чтобы установить его в качестве текущего провайдера Claude. CC Switch автоматически запишет ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в ~/.claude/settings.json. Запустите claude в терминале для проверки соединения.

Выбор модели по умолчанию¶

QCode.cc предлагает полную линейку от флагманских до лёгких моделей. Переключайтесь в Claude Code командой /model или указывайте напрямую в конфиге:

Тарифы — снимок от 2026-08-16 с qcode.cc/models; смотрите эту страницу вживую. 4.x не удаляйте — сдвиньте только рекомендацию по умолчанию на линейку 5. Полная линейка (GPT, Gemini, китайские семейства) там же.

Настройка провайдера Codex (для Codex CLI)¶

Переключитесь на вкладку Codex → Добавить провайдера → Пользовательский → заполните поля как показано:

CC Switch сгенерирует соответствующие файлы ~/.codex/config.toml и ~/.codex/auth.json:

model_provider = "qcode"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.qcode]
name = "qcode"
base_url = "https://api.qcode.cc/openai"
wire_api = "responses"
requires_openai_auth = true

Сохраните и активируйте, затем запустите codex для проверки соединения. Варианты GPT-моделей: gpt-5.6-terra / gpt-5.6-sol / gpt-5.6-luna / gpt-5.5 / gpt-5.4 / gpt-5.6-mini (тарифы и контекст: qcode.cc/models). Версию Codex CLI смотрите командой codex --version на своей машине; не опирайтесь на историческое число в этой статье.

Переключение между несколькими провайдерами/аккаунтами¶

Главная ценность CC Switch — в переключении. Типичная настройка:

1. На вкладке Claude сохраните несколько провайдеров, например QCode.cc (основной), QCode.cc (asia) (узел для материка), Anthropic Official (резервный).
2. Чтобы переключиться, нажмите Активировать рядом с нужным провайдером — CC Switch перезапишет соответствующие ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN в ~/.claude/settings.json.
3. Чтобы новый конфиг заработал: официальный README пишет, что Claude Code сейчас умеет горячее переключение данных провайдера; официальный FAQ и issue #3057 описывают другой случай — settings.json на диске уже новый, а идущая сессия всё ещё бьёт в старого провайдера. Если текущая сессия на старом узле, закройте её и откройте новый терминал, затем снова claude. Codex и остальные CLI по FAQ всегда переоткрывают терминал.
4. Codex работает так же: переключение активного элемента на вкладке Codex перезаписывает ~/.codex/config.toml.

Быстрый доступ из трея: CC Switch остаётся в системном трее; щёлкните правой кнопкой по иконке в трее, чтобы переключаться между сохранёнными провайдерами без открытия главного окна. Конкретные пункты меню зависят от версии приложения. Трей пишет те же live-файлы, что и «Активировать» в главном окне; ловушки — в разделе «После подключения» ниже.

Пример с несколькими аккаунтами / тарифами¶

Сохраните две конфигурации для одного аккаунта QCode.cc, каждую с разным API-ключом:

Переключение активного провайдера плавно перемещает вас между двумя квотами без смешивания биллинга.

Сценарии использования¶

• Нестабильная сеть в Китае: используйте asia.qcode.cc как основной и переключайтесь в один клик на глобальный api.qcode.cc при колебаниях.
• Сравнение провайдеров: запустите одну и ту же задачу через QCode.cc и официальный Anthropic, чтобы сравнить ответы и стоимость.
• Разделение команды / личного: используйте разные ключи для разделения рабочего и личного потребления для удобного учёта.
• Claude + Codex вместе: управляйте Claude Code и Codex CLI в одном приложении, направленными на эндпоинты протокола Anthropic и протокола OpenAI соответственно.

Продвинутые возможности Claude Code (работают через QCode)¶

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

Ввод изображений: понимание требований из скриншотов / диаграмм¶

Claude Code может передавать изображения моделям с поддержкой зрения: вставка (Ctrl+V), перетаскивание или указание пути к файлу изображения в промпте. Типичные применения:

• Построение UI из макета / скриншота
• Отладка по скриншоту с ошибкой
• Чтение архитектурных диаграмм и графиков

Модели с поддержкой зрения через QCode включают claude-opus-5 / claude-sonnet-5, а также всё ещё продающиеся claude-opus-4-8 / claude-sonnet-4-6 и GPT-5.x. Живые флаги возможностей: qcode.cc/models.

Примечание: это ввод изображений (понимание), а не генерация. Чтобы модель генерировала изображения, используйте модель gpt-image-2 — см. Генерация изображений gpt-image-2.

Динамические рабочие процессы (оркестрация фоновых субагентов)¶

Включите в промпт ключевое слово ultracode (или просто попросите «запустить рабочий процесс»), чтобы запустить динамические рабочие процессы Claude Code: они оркеструют десятки-сотни фоновых субагентов параллельно, что идеально для ревью, миграции и исследования по всей кодовой базе. Агенты продолжают работать в фоне, пока вы продолжаете работу; просматривайте запуски командой /workflows. Эта возможность выполняется на той модели, на которую настроен Claude Code, — поэтому она работает, когда Claude Code указывает на QCode. Подробнее: Субагенты.

Headless-режим / автоматизированный вывод¶

В скриптах и CI запускайте разово через -p и указывайте формат вывода:

# Структурированный JSON (вкл. result / total_cost_usd / usage / session_id), разбор через jq
claude -p "Сделай сводку покрытия тестами в этом репозитории" --output-format json | jq '.result'

# Поток JSON-событий с разделителями строк, удобно для real-time конвейеров
claude -p "Проверь src/ на риски безопасности" --output-format stream-json

Подробнее о конвейерах и CI — в Автоматизация и CI/CD.

О Gemini / Antigravity¶

Визуальный список CC Switch включает Gemini CLI, но обратите внимание: Google вывел Gemini CLI из эксплуатации (EOL 2026-06-18 для тарифов Pro/бесплатных; корпоративные платные ключи не затронуты), преемник — Google Antigravity CLI (доступен с 2026-05-19). Чтобы использовать модели семейства Gemini через QCode, переключитесь на Antigravity:

• Отредактируйте ~/.config/antigravity/config.toml
• Установите base_url в https://api.qcode.cc/openai/v1, укажите ваш API-ключ QCode и выберите модель
• Antigravity новый и развивается — точные ключи конфигурации смотрите в официальной документации

Модели Gemini, которые всё ещё в продаже и часто упоминаются здесь: gemini-2.5-pro и gemini-3.5-flash. Множитель и точный тариф берите с qcode.cc/models — не повторяйте устное «2x», если страница в этот момент его не показывает.

Резервные эндпоинты¶

Если основной эндпоинт недоступен, переключитесь на альтернативный (один и тот же ключ работает везде):

Самопроверка: обращение к пути Base URL напрямую возвращает 401 — это нормально, значит путь верный и не хватает только авторизации.

Общая квота¶

Провайдеры Claude и Codex в CC Switch используют один и тот же API-ключ QCode.cc и расходуют единую квоту подписки (см. Биллинг). Добавление двух провайдеров не удваивает списания. Если вы создали несколько провайдеров с разными ключами, каждый ключ тарифицируется независимо и не влияет на другие.

После подключения: переключение, сосуществование, восстановление¶

Этот раздел — то, что реально ищут люди после «CC Switch». Как заполнить форму — выше; здесь только то, что происходит уже на ходу.

Несколько тарифов / несколько ключей¶

Один провайдер = один BASE_URL + ключ + (для Codex) модель. Для одного аккаунта QCode можно держать несколько строк, например:

Активен только один провайдер. CC Switch не запишет два конфига в ~/.claude/settings.json сразу. Чтобы сравнить официальный Anthropic и QCode, жмите «Активировать» туда-сюда. Не ждите, что оба будут живыми.

CLI не перешёл на нового провайдера¶

Проверяйте в этом порядке; не начинайте с ключа:

1. Откройте ~/.claude/settings.json (для Codex — ~/.codex/config.toml) и убедитесь, что ANTHROPIC_BASE_URL / base_url — это только что активированная строка.
2. Файл сменился, сессия нет: это поведение из issue #3057 — Claude Code копирует блок env из settings.json при старте процесса. Идущая сессия его не перечитывает. Закройте текущий claude / codex и откройте новый терминал.
3. Официальный README говорит, что Claude Code теперь переключается на лету. Если ваша сборка так и делает, перезапуск не нужен; если всё ещё бьёт в старый узел — переоткройте сессию.
4. FAQ пишет, что переключение Gemini CLI из трея применяется сразу. Сам Gemini CLI уже EOL (см. выше) — не переносите эту фразу на Claude / Codex.

Сосуществование с официальным входом Anthropic / ChatGPT¶

Официальные README / FAQ:

1. Добавьте пресет Official Login (Claude / Codex) или Google Official (Gemini)
2. Нажмите Enable
3. Переоткройте соответствующий CLI и пройдите его Log out / Log in (или OAuth)
4. После этого можно переключаться между официальным входом и пользовательским QCode.cc

Не смешивайте вручную в settings.json официальный OAuth и ANTHROPIC_AUTH_TOKEN от QCode — при активации CC Switch переписывает поля, которыми владеет. Переключение между несколькими официальными аккаунтами Codex — по README: Codex умеет переключаться между разными официальными провайдерами.

Ловушки переключения из трея¶

• Нет иконки: macOS — настройки строки меню; Windows — переполнение панели задач; Linux может потребовать libappindicator (официальный FAQ)
• Lightweight Mode (меню трея): главное окно закрывается, трей остаётся. Функции на месте; первая глубокая ссылка ccswitch:// заново собирает окно и чуть медленнее (официальный FAQ, с v3.13.0)
• Кликнули в трее, CLI не изменился: трей пишет те же live-файлы, что и «Активировать». Он не убивает идущий claude. Переоткройте сессию, как выше
• Суффиксы (asia) / (work) делают меню трея читаемым

Конфиг перезаписали — как вернуть¶

При активации / перехвате CC Switch пишет поля провайдера в live-файлы CLI. Несколько issue (#2992, #4274, #1656) описывают полную перезапись файла с потерей ключей, которыми CC Switch не владеет (enabledPlugins, hooks, statusLine, permissions, …). Файлы плагинов часто остаются на диске; они просто не грузятся без enabledPlugins.

Проверяемые пути восстановления (официальные README / руководство, не чужие мантры):

1. Бэкапы приложения: ~/.cc-switch/backups/ (ротация; официально: последние 10)
2. Ваш экспорт: файл из настроек вида cc-switch-export-{timestamp}.sql; импорт перезаписывает текущую БД — сначала экспортируйте ещё раз
3. Общий фрагмент конфига (FAQ README «пропали плагины после переключения»): Правка провайдера → панель общего конфига → «Извлечь из текущего провайдера»; на новых провайдерах оставляйте «Записать общий конфиг» (включено по умолчанию). Провайдер по умолчанию, импортированный при первом запуске, должен хранить исходный полный набор
4. Ручные правки Claude: если вы правили только ~/.claude/settings.json и никогда не извлекали его в общий фрагмент, верните из своего бэкапа / Time Machine / локальной истории редактора и вставьте в общий фрагмент. Следующая активация сама не смержит

Своя БД CC Switch — ~/.cc-switch/cc-switch.db; UI устройства — ~/.cc-switch/settings.json. Удаление второго только сбрасывает интерфейс, хуки Claude не вернёт.

Практические советы¶

• Имена с суффиксами: добавляйте к названиям провайдеров суффиксы вроде (asia) / (work), чтобы переключение из трея было однозначным с первого взгляда.
• Сначала файл, потом новая сессия: доверяйте ~/.claude/settings.json / ~/.codex/config.toml; идущий процесс не перечитывает конфиг (FAQ / #3057).
• Без завершающего слеша: ни один Base URL не должен заканчиваться на /, иначе может получиться неверный путь.
• Храните ключи раздельно: CC Switch хранит ключи независимо для каждого провайдера; не забывайте обновлять каждый при ротации ключей.
• Делайте резервную копию конфига: если вы вручную правили ~/.claude/settings.json, активация перезапишет ваши правки — сначала бэкап или извлечение в общий фрагмент.

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

Кнопка «Активировать» неактивна после сохранения¶

Убедитесь, что в конце ANTHROPIC_BASE_URL / Base URL нет лишнего /. CC Switch чувствителен к завершающему слешу.

Ошибка 401 Unauthorized¶

1. Убедитесь, что API-ключ начинается с cr_ и не содержит пробелов в начале или конце
2. Проверьте действительность ключа в qcode.cc/dashboard
3. Если ошибка только у Claude, но не у Codex (или наоборот), ключ введён неверно в одном из провайдеров — CC Switch хранит ключи для каждого провайдера независимо

Переключение провайдера не дало эффекта¶

Сначала проверьте, что live-файл уже показывает нового провайдера. Если файл сменился, закройте текущую сессию claude / codex и откройте новую (официальный FAQ; #3057). Не ограничивайтесь кликом в трее и продолжением набора в старом окне.

Codex бесконечно крутится при запуске¶

Проверьте, что base_url в config.toml заканчивается на /openai (не /openai/v1). Поле wire_api = "responses" также обязательно.

Можно ли использовать Claude и Codex одновременно?¶

Да. CC Switch записывает конфигурацию Claude в ~/.claude/, а Codex — в ~/.codex/. Эти конфигурации полностью независимы друг от друга. При необходимости запускайте claude и codex в отдельных терминалах.

Я вручную правил settings.json — потеряю ли я это при активации?¶

Да. При активации CC Switch перезаписывает соответствующие поля в ~/.claude/settings.json значениями этого провайдера. В части сборок сообщали о замене всего файла и потере enabledPlugins / hooks (#2992, #4274). Держите лишнее в общем фрагменте, делайте бэкап до активации и восстанавливайте из ~/.cc-switch/backups/ или экспортированного .sql.

Как вернуться к официальному входу Anthropic?¶

Добавьте пресет Official Login → Enable → переоткройте CLI → официальный Log out / Log in. Не собирайте вручную гибрид «пустой env, но ключ cr_ на месте».

Следующие шаги¶

• Интеграция с WorkBuddy — тот же ключ как пользовательская модель Tencent WorkBuddy
• Руководство по Claude Code — освойте основной рабочий процесс Claude Code
• Руководство по Codex — углублённое использование Codex CLI
• Интеграция с VS Code — используйте Claude Code прямо в редакторе
• Субагенты — оркеструйте фоновых агентов с динамическими рабочими процессами
• Автоматизация и CI/CD — headless-режим и интеграция со скриптами
• Биллинг — узнайте о планах и квотах

Ещё нет API-ключа QCode.cc? Перейдите на qcode.cc/pricing и выберите тариф — один ключ управляет и Claude Code, и Codex CLI внутри CC Switch.