Настройка CC Switch

Подключите QCode.cc к Claude Code и Codex CLI в один клик с помощью десктопного приложения CC Switch и мгновенно переключайтесь между несколькими провайдерами/аккаунтами

Настройка 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 или указывайте напрямую в конфиге:

Во флагманском уровне также есть claude-opus-4-7 (1M). Полная линейка (включая GPT и Gemini) — на странице Модели и цены.

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

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

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

model_provider = "qcode"
model = "gpt-5.3-codex"
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 для проверки соединения. Текущая версия Codex CLI — 0.142.0. Варианты GPT-моделей: gpt-5.5 ($5/$30, 1M), gpt-5.4 ($2.5/$15, 1M), gpt-5.4-mini ($0.75/$4.5, 400K), gpt-5.3-codex ($1.75/$14, 272K).

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

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

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

Быстрый доступ из трея: CC Switch остаётся в системном трее; щёлкните правой кнопкой по иконке в трее, чтобы переключаться между сохранёнными провайдерами без открытия главного окна. Конкретные пункты меню зависят от версии приложения.

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

Сохраните две конфигурации для одного аккаунта 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 4.8 / Sonnet 4.6 и GPT-5.x.

Примечание: это ввод изображений (понимание), а не генерация. Чтобы модель генерировала изображения, используйте модель 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 на QCode — gemini-2.5-pro и gemini-3.5-flash (семейство Gemini тарифицируется с коэффициентом 2x).

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

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

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

Общая квота¶

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

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

• Имена с суффиксами: добавляйте к названиям провайдеров суффиксы вроде (asia) / (work), чтобы переключение из трея было однозначным с первого взгляда.
• Перезапускайте CLI после переключения: переменные окружения читаются при запуске процесса; после смены провайдера откройте новый терминал или перезапустите claude / codex.
• Без завершающего слеша: ни один 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 хранит ключи для каждого провайдера независимо

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

Переключение только перезаписывает файл конфигурации; работающий процесс claude / codex не перечитывает его «на лету». Откройте новый терминал или перезапустите CLI и попробуйте снова.

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 значениями этого провайдера. Размещайте пользовательский контент в конфиге провайдера CC Switch или делайте бэкап перед активацией.

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

• Руководство по 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.