Настройка CC Switch

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

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Последняя проверка: 2026-09-18 · 📄 По официальной документации (CC Switch v3.20.3, выпуск 2026-09-11)

Кратко¶

CC Switch — кросс-платформенное десктопное приложение (Windows / macOS / Linux) для управления конфигурацией API-провайдеров девяти инструментов: Claude Code, Claude Desktop, Codex, Gemini CLI, Grok Build, OpenCode, OpenClaw, Hermes, MiniMax Code (список из официального README; скриншоты в руководстве чуть отстают). В этом руководстве рассказывается, как добавить 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 в верхнем переключателе приложений → нажмите «+» (Добавить провайдера) в правом верхнем углу → во вкладке прикладных провайдеров выберите Пользовательский (Custom) → правьте JSON конфигурации в панели (формулировки интерфейса меняются по версиям, ориентируйтесь на свой билд):

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

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

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

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

Тарифы и контексты смотрите живьём на qcode.cc/models — цифры на эту страницу больше не переносим, чтобы они не устаревали. Полная линейка (GPT, Gemini, китайские семейства) там же. С v3.20.3 в редакторе провайдера Claude есть панель маппинга моделей по ролям (Sonnet / Opus / Fable / Haiku / субагенты) с кнопкой применить ко всем ролям.

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

Выберите Codex в верхнем переключателе → «+» Добавить провайдера → Пользовательский → заполните так:

⚠️ В редакторе провайдера Codex есть переключатель «Нужна локальная маршрутизация» — он для апстримов, умеющих только Chat Completions. Для QCode не включайте: QCode отдаёт Responses нативно, а с этим переключателем понадобится постоянно запущенный локальный прокси.

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

model_provider = "qcode"
model = "gpt-6-sol"
model_reasoning_effort = "high"

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

Сохраните, нажмите Включить, затем запустите codex для проверки соединения. Варианты GPT-моделей: gpt-6-sol / gpt-5.6-terra / gpt-5.6-sol (тарифы и контекст: 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 остаётся в системном трее; с v3.13.0 контекстное меню разбито на подменю по приложениям (Claude / Codex / Gemini), в заголовке подменю — текущий включённый провайдер и сводка расхода; клик по имени провайдера переключает. Трей пишет те же 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:

• CC Switch по-прежнему поддерживает Gemini CLI как приложение первого класса; вход тот же, что для Claude / Codex
• Пошаговая настройка Gemini-моделей через QCode — на странице Google Antigravity CLI; точные ключи — по официальной документации

Модели 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 «пропали плагины после переключения»): Правка провайдера → панель общего конфига → «Извлечь из текущего провайдера»; на новых провайдерах оставляйте включённым чекбокс записи общего конфига (по умолчанию включён; метка в README плавает: "Write Shared Config" / "Apply shared config". Провайдер по умолчанию, импортированный при первом запуске, должен хранить исходный полный набор
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).
• Без завершающего слеша: QCode требует Base URL без / на конце (иначе SDK соберёт битый путь вида //v1/...).
• Храните ключи раздельно: CC Switch хранит ключи независимо для каждого провайдера; не забывайте обновлять каждый при ротации ключей.
• Делайте резервную копию конфига: если вы вручную правили ~/.claude/settings.json, активация перезапишет ваши правки — сначала бэкап или извлечение в общий фрагмент.

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

Кнопка «Включить» не нажимается после сохранения¶

Проверьте по порядку: ① поле эндпоинта не пустое; ② JSON / TOML в панели синтаксически корректен (ручная правка ломает его чаще всего); ③ попробуйте убрать завершающий / в Base URL (эндпоинты QCode требуют без слеша; как именно CC Switch обращается с завершающим слешем, документация не описывает — этот порядок — наш опыт).

Все запросы Claude Code 2.1.265–2.1.267 падают с 400 (схема Artifact)¶

Схема инструмента Artifact в Claude Code 2.1.265–2.1.267 отвергается строгими шлюзами целиком (400, Invalid schema for function 'Artifact'). С CC Switch 3.20.3 (2026-09-11) в редакторе провайдера Claude есть быстрый переключатель «Disable Artifact Tool», записывающий env.CLAUDE_CODE_DISABLE_ARTIFACT="1". Официальное исправление Claude Code — апгрейд на ≥2.1.268; см. устранение неполадок. Взаимодействие с каналом QCode по каждому случаю мы не воспроизводили — при повторении несите request id в тикет.

Ошибка 401 Unauthorized¶

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

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

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

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

Проверьте, что base_url соответствует соглашению об эндпоинтах QCode и заканчивается на /openai (не /openai/v1); wire_api = "responses" обязательно. Самое частое упущение: верхнеуровневый model_provider отсутствует или не совпадает с именем таблицы [model_providers.xxx] — тогда Codex молча возвращается к встроенному официальному эндпоинту openai (официальный issue #7263 с таким симптомом).

Можно ли использовать 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.

Enterprise →