CC Switch: как переключать API в Claude Code и Codex в один клик
По состоянию на 2026-10-13 API для Claude Code в CC Switch переключается так: на странице Claude нажмите «+» в правом верхнем углу и создайте свою конфигурацию (Custom), укажите ANTHROPIC_BASE_URL = https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN = ключ, начинающийся с cr_, сохраните и нажмите на карточке кнопку Enable. CC Switch запишет оба значения в ~/.claude/settings.json, а Enable на другой карточке переключит вас на неё. Для Codex создайте отдельную конфигурацию на странице Codex с Base URL https://api.qcode.cc/openai. Линейка 4.0 перешла в стабильные релизы: на 2026-10-13 последний стабильный — v4.0.11 (вышел 2026-10-13), предыдущий v4.0.10 вышел 2026-10-12; в 4.0 появился режим агрегации, v4.0.10 посвящён ссылкам импорта ccswitch://, а v4.0.11 добавляет удаление установленных инструментов со страницы Apps; подробности ниже. Здесь по документации QCode и официальному README CC Switch разобраны установка, настройка, переключение и частые проблемы.
Обновлено 2026-10-14
Подключите этот инструмент к эндпоинту QCode — один ключ для Claude, GPT и китайских моделей.
- Оплата по токенам — актуальные цены на /models
- Оплата через СБП, российскими картами, картами Visa / Mastercard или криптовалютой
- Самообслуживание: после пополнения тариф активируется мгновенно
Четыре вещи, которые стоит знать заранее
Адрес для Claude Code
ANTHROPIC_BASE_URL = https://api.qcode.cc/api, ANTHROPIC_AUTH_TOKEN = ваш ключ, начинающийся с cr_; без слеша в конце.
Адрес для Codex
Base URL = https://api.qcode.cc/openai, а не /openai/v1; в созданном config.toml должна остаться строка wire_api = "responses".
Один клик для переключения
И у Claude Code, и у Codex одновременно включена ровно одна конфигурация; нажмите Enable на другой карточке, и CC Switch запишет этот набор в конфигурационный файл.
Последний стабильный релиз (на 2026-10-13)
Вышел 2026-10-13 (UTC); с v4.0.4 (2026-10-07) линейка 4.0 стала стабильной, а v4.0.0 (2026-10-04) — v4.0.3 (2026-10-06) помечены на GitHub как предварительные.
Что на самом деле делает CC Switch
По состоянию на 2026-10-13 CC Switch — кроссплатформенное настольное приложение с открытым кодом (лицензия MIT) для Windows, macOS и Linux: оно хранит API-конфигурации консольных инструментов вроде Claude Code и Codex в виде карточек, и одно нажатие Enable подставляет другой набор. В документации QCode оно описано как переключатель профилей конфигурации.
Само по себе это не эндпоинт для инференса: приложение лишь записывает каждую конфигурацию в стандартный файл инструмента (у Claude Code — ~/.claude/settings.json, у Codex — ~/.codex/config.toml), перезаписывая его при включении карточки и возвращая прежний набор при переключении. Поэтому у Claude Code и у Codex действует только по одной конфигурации, и два набора одновременно не работают.
Официальный README говорит о переключении в один клик без ручной правки файлов JSON, TOML и YAML; список поддерживаемых инструментов меняется от версии к версии, актуальный — в официальном README.
Последние релизы CC Switch (на 2026-10-13)
На 2026-10-13 самый свежий стабильный релиз на GitHub Releases — v4.0.11, опубликованный 2026-10-13 (UTC). В его примечаниях сказано, что релиз посвящён удалению: установленные инструменты теперь можно удалять со страницы Apps, но только те установки, источник которых подтверждён, а конфигурация и данные сессий сохраняются.
Предыдущий релиз, v4.0.10 от 2026-10-12, посвящён ссылкам импорта в один клик (ccswitch:// deep links): ссылка больше не теряется, если CC Switch не запущен, ссылка может указывать формат API, а в диалоге подтверждения можно выбрать, переключаться ли сразу после импорта; вместе с релизом вышли руководства для владельцев сайтов на китайском, английском и японском и онлайн-генератор ссылок.
Первый релиз линейки, v4.0.0 от 2026-10-04, помечен как предварительный, как и v4.0.1 с v4.0.2 (2026-10-05) и v4.0.3 (2026-10-06); v4.0.4 (2026-10-07) опубликован стабильным, как и v4.0.10 с v4.0.11. По примечаниям к v4.0, новый режим агрегации собирает модели нескольких провайдеров в один список моделей Claude Code или Codex, переключаться между ними можно прямо в клиенте; он включается вручную, сейчас поддерживает Claude Code и Codex, отправляет запрос провайдеру выбранной модели и не предоставляет failover.
Механизм записи конфигурации переписан: при переключении заменяются только ключевые поля, а не весь файл; остальное сохраняется. Более ранний v3.20.4 от 2026-09-22 исправил ошибку, из-за которой редактирование конфигурации Codex или переключение с неё стирало сохранённый API-ключ. Документация QCode по CC Switch обновлена 2026-10-08; в ней указано, что сверка выполнена по официальной документации v3.20.3 (2026-09-11) и датирована 2026-09-18, поэтому подписи в интерфейсе могут отличаться.
Хронология релизов и документации
Выходит CC Switch v3.20.3; документация QCode по CC Switch сверена с официальной документацией этой версии. По документации QCode, с этого релиза в редакторе Claude есть быстрый переключатель Disable Artifact Tool.
Выходит v3.20.4 с исправлением ошибки, из-за которой редактирование конфигурации Codex или переключение с неё стирало сохранённый API-ключ; он оставался самым свежим стабильным релизом, пока v4.0.4 2026-10-07 не перевёл линейку 4.0 в стабильные релизы.
Выходит предварительная версия v4.0.0: появился режим агрегации, и при переключении заменяются только ключевые поля, а не весь файл; v4.0.4 (2026-10-07) вышел стабильным, а к 2026-10-13 линейка дошла до v4.0.11; предыдущий v4.0.10 (2026-10-12) был посвящён ссылкам импорта ccswitch://, а v4.0.11 добавляет удаление установленных инструментов.
Подтверждено vs не описано или противоречиво
Подтверждено (дословно по документации)
Всё перечисленное можно дословно сверить по документации QCode, официальному README CC Switch, его руководству пользователя или примечаниям к релизам на GitHub: конфигурация Claude Code — это ANTHROPIC_BASE_URL = https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN = ключ, начинающийся с cr_, и при включении оба значения записываются в ~/.claude/settings.json; Base URL для Codex — https://api.qcode.cc/openai, CC Switch создаёт ~/.codex/config.toml и ~/.codex/auth.json со строкой wire_api = "responses"; переключатель локального прокси-преобразования в панели Codex, рассчитанный на сервисы только с Chat Completions, для QCode остаётся выключенным; одновременно включена только одна конфигурация; конфигурации Claude и Codex могут использовать один ключ; CC Switch хранит отдельный ключ для каждой конфигурации; проверка соединения на карточке ключ не проверяет; на 2026-10-13 последний стабильный релиз на GitHub — v4.0.11 от 2026-10-13 (предыдущий v4.0.10 — от 2026-10-12), v4.0.0 — v4.0.3 помечены как предварительные, а v4.0.4 (2026-10-07) и далее стабильные; примечания к v4.0 говорят, что агрегация включается вручную и собирает модели нескольких провайдеров в один список, а примечания к v4.0.10 — что ссылка ccswitch:// не теряется, даже когда приложение не запущено.
Не описано или противоречиво
По трём вопросам эта страница выводов не делает. Первое — нужен ли перезапуск Claude Code после переключения: официальный README пишет, что Claude Code поддерживает горячее переключение без перезапуска, и FAQ официального руководства пользователя тоже говорит, что обычно перезапуск не нужен, добавляя лишь, что если изменение не применилось, стоит закрыть и снова открыть терминал или перезапустить IDE; issue #3057, на который ссылается документация QCode, тоже фиксирует, что запущенная сессия продолжала работать со старой конфигурацией.
Проверьте на своей версии и, если запросы всё ещё уходят на старый адрес, перезапустите сессию. Второе — сотрёт ли включение конфигурации ваши ручные правки в settings.json: документация QCode приводит сообщения о том, что некоторые версии перезаписывали файл целиком и теряли enabledPlugins и hooks, и советует сначала сделать резервную копию; в примечаниях к v4.0 и в FAQ руководства пользователя сказано, что при переключении заменяются только адрес, учётные данные, модель и протокол, а добавленные вами плагины, hooks, права, MCP и переменные окружения вместе с комментариями и форматированием сохраняются, и с v4.0.4 (2026-10-07) линейка 4.0 стабильна, но поведение этой версии эта страница не проверяла.
Третье — слеш в конце Base URL: эндпоинты QCode требуют адрес без него, а как его обрабатывает сам CC Switch, по словам документации QCode, в официальной документации не описано.
CC Switch или ручная правка конфигов
CC Switch против ручной правки
В обоих случаях меняются одни и те же файлы: CC Switch записывает ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN в ~/.claude/settings.json, а base_url и связанные ключи — в ~/.codex/config.toml; сам он не является эндпоинтом для инференса. Если вы часто переходите между несколькими наборами — например, между asia.qcode.cc и api.qcode.cc в сети материкового Китая или между официальным входом и QCode для сравнения, — CC Switch экономит время.
Если набор один или вы работаете на сервере без рабочего стола, проще править вручную: CC Switch выпускается только как настольное приложение с графическим интерфейсом, а для машин без рабочего стола официальный README советует CC Switch CLI, который поддерживает сообщество.
Claude Code против Codex
В CC Switch это две страницы и две конфигурации: Claude записывается в ~/.claude/, Codex — в ~/.codex/, друг другу они не мешают, так что достаточно запустить claude и codex в разных терминалах. Разница в протоколе и адресе: Claude Code работает по протоколу Anthropic с https://api.qcode.cc/api, Codex — по протоколу OpenAI Responses с https://api.qcode.cc/openai.
Документация QCode прямо говорит, что модели Claude работают только через эндпоинт Anthropic, а Codex должен использовать Responses; в обе конфигурации можно вписать один и тот же ключ cr_.
Шесть шагов: установка, настройка, переключение
- 1Установка: скачайте пакет со страницы GitHub Releases проекта CC Switch. Для Windows 10 и новее — .msi или портативный .zip; для macOS 12 и новее — .dmg или brew install
--caskcc-switch; для Linux — .deb, .rpm или .AppImage (официально нужны glibc 2.35+ и WebKitGTK 4.1), а в Arch — paru -S cc-switch-bin. - 2Настройка Claude Code: выберите Claude в переключателе сверху, нажмите «+» в правом верхнем углу, в пресетах выберите Custom и в JSON конфигурации задайте
ANTHROPIC_BASE_URL=https://api.qcode.cc/apiиANTHROPIC_AUTH_TOKEN= ваш ключ cr_; имя можно выбрать любое, в примере документации — QCode.cc. - 3Сохраните, наведите курсор на карточку и нажмите Enable: CC Switch запишет оба значения в
~/.claude/settings.json.Для проверки запустите claude в терминале. - 4Настройка Codex: переключитесь на Codex, нажмите «+» и выберите Custom, укажите Base URL
https://api.qcode.cc/openai, в API Key — тот же ключ cr_, модель по умолчанию —gpt-6-solилиgpt-5.6-terra; имя можно выбрать любое, в примере документации — qcode строчными буквами (так удобнее для ключа TOML), и вconfig.tomlоно появится как model_provider = "qcode". Переключатель локального прокси-преобразования для сервисов только с Chat Completions не включайте. - 5Сохраните, нажмите Enable и для проверки запустите codex; в
config.tomlдолжны быть base_url = "https://api.qcode.cc/openai" и wire_api = "responses". - 6Чтобы потом переключиться, нажмите Enable на другой карточке или щёлкните имя конфигурации в системном трее. Сначала откройте
~/.claude/settings.json(для Codex —~/.codex/config.toml) и убедитесь, что адрес сменился; Codex требует перезапуска терминала, а если Claude Code всё ещё обращается к старому адресу, закройте сессию и откройте новую. Если сохраняете вторую копию для asia.qcode.cc, добавьте к имени суффикс вроде (asia), чтобы различать их в трее. После 4.0 появились два новых приёма. Первый — режим агрегации, появившийся в v4.0: он включается вручную, по README требуется Claude Code 2.1.243 или новее, и failover он не даёт; добавив нескольких провайдеров, вы видите их модели в одном списке Claude Code или Codex, а запрос уходит провайдеру выбранной модели. Как этим пользоваться — на отдельной странице этого сайта про режим агрегации в CC Switch 4.0. Второй — ссылки импорта в один клик: конфигурацию можно добавить по ссылке ccswitch:// прямо с сайта провайдера; с v4.0.10 (2026-10-12) ссылка не теряется, даже если CC Switch не запущен, а в диалоге подтверждения можно выбрать, переключаться ли сразу после импорта.
На QCode
На QCode в конфигурации Claude Code и Codex можно вписать один и тот же ключ cr_ (создаётся в консоли): ключ работает со всеми протоколами, а протокол определяется путём запроса. Конфигурация Claude Code использует https://api.qcode.cc/api с моделями вроде claude-sonnet-5, claude-sonnet-5-5 или claude-opus-5, а сменить модель можно и командой /model внутри Claude Code; конфигурация Codex использует https://api.qcode.cc/openai с gpt-6-sol или gpt-5.6-terra.
Три домена одинаковы по возможностям и принимают один и тот же ключ: us.qcode.cc рассчитан на Северную Америку и Европу, а для сетей в материковом Китае документация советует asia.qcode.cc, пути при этом не меняются, так что в CC Switch можно держать по конфигурации на каждый домен. Один ключ на две конфигурации не приводит к двойному списанию; оплата за токены, цены каждой модели — на /models. Каждый запрос можно посмотреть на probe.qcode.cc, введя свой ключ.
Частые вопросы
CC Switch переключился, а Claude Code этого не заметил. Что делать?
Сначала проверьте файл, потом перезапустите сессию. Откройте ~/.claude/settings.json и убедитесь, что в ANTHROPIC_BASE_URL стоит только что включённый набор; если файл изменился, а сессия нет, закройте запущенный claude и запустите его в новом терминале. Issue #3057, на который ссылается документация QCode, описывает именно это: Claude Code при запуске процесса читает блок env из settings.json в переменные окружения, и работающая сессия его не перечитывает. Нужен ли перезапуск вообще — официальные источники тут близки: официальный README пишет, что Claude Code поддерживает горячее переключение без перезапуска, и FAQ руководства пользователя тоже пишет, что обычно перезапуск не нужен, а если изменение не применилось — закрыть и снова открыть терминал или перезапустить IDE; для Codex оба источника требуют перезапустить терминал. Переключение из трея пишет в тот же файл и не завершает за вас запущенный claude. Если включён режим агрегации, есть ещё один слой: по README и руководству пользователя изменения агрегированных моделей в Claude Code применяются сразу, а Codex требует полного перезапуска при входе в агрегацию, выходе из неё и при изменении списка агрегированных моделей. Подробнее об агрегации — на отдельной странице этого сайта о режиме агрегации в CC Switch 4.0.
Как разобраться с ошибкой 401 Unauthorized?
Обычно в одной из конфигураций неверный ключ. Убедитесь, что ключ начинается с cr_ и не содержит пробелов в начале или в конце, затем проверьте в консоли, что он действителен. Если Claude Code получает 401, а Codex работает (или наоборот), ошибка именно в этой конфигурации: CC Switch хранит отдельный ключ для каждой, поэтому при смене ключа обновите их по очереди. И учтите: проверка соединения на карточке смотрит только, доступен ли адрес; в официальном руководстве пользователя сказано, что ключ она не проверяет, так что успешная проверка не доказывает, что ключ верный.
Codex после запуска бесконечно крутит индикатор. Что проверить?
Сначала проверьте ~/.codex/config.toml. base_url должен заканчиваться на /openai, а не на /openai/v1, и строка wire_api = "responses" обязательно должна остаться. По документации QCode, самая частая причина — не указан model_provider верхнего уровня или он не совпадает с именем таблицы [model_providers.xxx]; тогда Codex откатывается на встроенный официальный эндпоинт openai. Исправьте, перезапустите терминал и снова запустите codex.
Можно ли пользоваться Claude Code и Codex одновременно?
Да. CC Switch записывает конфигурацию Claude в ~/.claude/, а Codex — в ~/.codex/; они не мешают друг другу, так что просто запускайте claude и codex в разных терминалах. В обе можно вписать один ключ cr_: Claude Code — с https://api.qcode.cc/api, Codex — с https://api.qcode.cc/openai. В документации QCode сказано, что общий ключ не приводит к двойному списанию из-за того, что вы создали вторую конфигурацию.
Я правил settings.json вручную. Сотрёт ли включение другой конфигурации мои изменения?
Официально сейчас ответ «нет», но эта страница ничего не проверяла, поэтому надёжнее сначала сделать резервную копию. В документации QCode сказано, что при включении CC Switch перезаписывает соответствующие поля в ~/.claude/settings.json значениями этой конфигурации и что копировать файл перед включением советуют там же, а для некоторых версий были сообщения о перезаписи всего файла с потерей enabledPlugins и hooks; в примечаниях к v4.0 и в FAQ руководства пользователя сказано, что теперь при переключении заменяются только ключевые поля, а ваши плагины, hooks, права, MCP и переменные окружения вместе с комментариями и форматированием сохраняются, а 4.0 с v4.0.4 (2026-10-07) опубликован как стабильная версия. Если что-то пропало, восстановите из ~/.cc-switch/backups/ (официально хранятся 10 последних копий) или из экспорта с именем вида cc-switch-export-{timestamp}.sql. Кроме того, при первом запуске CC Switch импортирует ваши существующие настройки Claude Code и Codex как конфигурацию с именем default.
Как вернуться к официальному входу Anthropic?
Выберите в списке встроенную официальную конфигурацию (для Claude Code — Claude Official, для Codex — OpenAI Official; если вы её удалили, добавьте снова из пресетов), нажмите Enable, перезапустите CLI и пройдите вход средствами самого инструмента: /login в Claude Code, codex login для Codex. После этого можно свободно переходить между официальным входом и своей конфигурацией QCode. Документация QCode предупреждает: не собирайте вручную гибридную конфигурацию, где блок env пуст, а ключ cr_ остался.
Источники
Настройка, адреса и устранение проблем: страница документации QCode о CC Switch (обновлена 2026-10-08; в ней указано, что сверка выполнена по официальной документации CC Switch v3.20.3 (2026-09-11) и датирована 2026-09-18) и страница об эндпоинтах и форматах API (какой протокол идёт через какой эндпоинт, три домена и правило про слеш в конце), обе получены 2026-10-13. Установка, системные требования, правила применения переключения, проверка соединения и официальный вход на стороне CC Switch: README репозитория CC Switch на GitHub (лицензия MIT) и страница часто задаваемых вопросов официального руководства пользователя, получены в тот же день. Версии и даты: GitHub Releases API и примечания к релизам CC Switch (v3.20.4, v4.0.0 — v4.0.4, v4.0.10 и v4.0.11 с датами публикации и пометками «предварительная» или «стабильная»), получены в тот же день.
Подключите CC Switch к QCode
Один ключ cr_: Claude Code — на /api, Codex — на /openai, переключение одним нажатием Enable. Оплата за токены, цены каждой модели — на /models.
Читайте также
Настройка своего эндпоинта в Claude Code
Две переменные окружения, форма settings.json и apiKeyHelper.
Codex CLI со сторонним API: настройка
Как задать model_provider, base_url и env_key в config.toml.
CC Switch 4.0: агрегация и импорт в один клик
Три вкладки режимов, один список моделей для нескольких провайдеров, deep-ссылки ccswitch:// не теряются при незапущенном приложении, в README консольной версии нет.
Оплата криптовалютой
Девять монет, 56 сетей, нулевая комиссия платформы за кредиты AI-кодинга.
Шаги и цитаты на этой странице сверены 2026-10-13; приоритет у официальных страниц — документации QCode, официального README CC Switch и примечаний к релизам на GitHub. Подписи в интерфейсе CC Switch и поведение переключения меняются от версии к версии, ориентируйтесь на свою; доступность моделей — по /models.