Настройка 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 в одном приложении
- Быстрый доступ из системного трея: переключайте провайдеров из меню трея без открытия главного окна
Предварительные требования¶
- Установлен Claude Code CLI или Codex CLI
- API-ключ QCode.cc (начинается с
cr_), доступный в личном кабинете
Установка CC Switch¶
Скачайте установщик для вашей платформы с GitHub Releases:
| Платформа | Пакет |
|---|---|
| Windows 10+ | CC-Switch-v{ver}-Windows.msi или портативный .zip |
| macOS 12+ | пакет .dmg; или brew tap farion1231/ccswitch && brew install --cask cc-switch |
| Linux | .deb / .rpm / .AppImage; для Arch: paru -S cc-switch-bin |
Настройка провайдера Claude (для Claude Code)¶
Запустите CC Switch → переключитесь на вкладку Claude слева → нажмите Добавить провайдера (Add Provider) в правом верхнем углу → выберите Пользовательский (Custom) → заполните поля как показано:
| Поле | Значение |
|---|---|
| Название провайдера | QCode.cc |
| ANTHROPIC_BASE_URL | https://api.qcode.cc/api |
| ANTHROPIC_AUTH_TOKEN | Ваш API-ключ QCode.cc (начинается с cr_) |
После сохранения нажмите Активировать (Activate), чтобы установить его в качестве текущего провайдера Claude. CC Switch автоматически запишет ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в ~/.claude/settings.json. Запустите claude в терминале для проверки соединения.
Настройка провайдера Codex (для Codex CLI)¶
Переключитесь на вкладку Codex → Добавить провайдера → Пользовательский → заполните поля как показано:
| Поле | Значение |
|---|---|
| Название провайдера | qcode (строчными буквами, используется как ключ TOML) |
| Base URL | https://api.qcode.cc/openai |
| API-ключ | Ваш API-ключ QCode.cc |
| Модель по умолчанию | gpt-5.3-codex-spark (рекомендуется) или gpt-5.4 |
CC Switch сгенерирует соответствующие файлы ~/.codex/config.toml и ~/.codex/auth.json:
model_provider = "qcode"
model = "gpt-5.3-codex-spark"
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 для проверки соединения.
Резервные эндпоинты¶
Если основной эндпоинт недоступен, переключитесь на альтернативный:
| Эндпоинт | Claude Base URL | Codex Base URL |
|---|---|---|
| Международный CDN (рекомендуется) | https://api.qcode.cc/api |
https://api.qcode.cc/openai |
| Прямое подключение Шэньчжэнь | http://103.236.53.153/api |
http://103.236.53.153/openai |
| Гонконг | http://103.218.243.5/api |
http://103.218.243.5/openai |
Общая квота¶
Провайдеры Claude и Codex в CC Switch используют один и тот же API-ключ QCode.cc и расходуют единую квоту подписки (см. Биллинг). Добавление двух провайдеров не удваивает списания.
Часто задаваемые вопросы¶
Кнопка «Активировать» неактивна после сохранения¶
Убедитесь, что в конце ANTHROPIC_BASE_URL / Base URL нет лишнего /. CC Switch чувствителен к завершающему слешу.
Ошибка 401 Unauthorized¶
- Убедитесь, что API-ключ начинается с
cr_и не содержит пробелов в начале или конце - Проверьте действительность ключа в qcode.cc/dashboard
- Если ошибка только у Claude, но не у Codex (или наоборот), ключ введён неверно в одном из провайдеров — CC Switch хранит ключи для каждого провайдера независимо
Codex бесконечно крутится при запуске¶
Проверьте, что base_url в config.toml заканчивается на /openai (не /openai/v1). Поле wire_api = "responses" также обязательно.
Можно ли использовать Claude и Codex одновременно?¶
Да. CC Switch записывает конфигурацию Claude в ~/.claude/, а Codex — в ~/.codex/. Эти конфигурации полностью независимы друг от друга. При необходимости запускайте claude и codex в отдельных терминалах.
Следующие шаги¶
- Руководство по Claude Code — освойте основной рабочий процесс Claude Code
- Руководство по Codex — углублённое использование Codex CLI
- Интеграция с VS Code — используйте Claude Code прямо в редакторе
- Биллинг — узнайте о планах и квотах