CC Switch: как переключать API в Claude Code и Codex в один клик
По состоянию на 2026-10-07 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. Здесь по документации QCode и официальному README CC Switch разобраны установка, настройка, переключение и частые проблемы.
Обновлено 2026-10-07
Четыре вещи, которые стоит знать заранее
Адрес для 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-07)
Вышел 2026-09-22; v4.0.0–v4.0.3 — предварительные версии, выходящие с 2026-10-04, и автоматически они не обновляются.
Что на самом деле делает CC Switch
По состоянию на 2026-10-07 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-07)
На 2026-10-07 самый свежий стабильный релиз на GitHub Releases — v3.20.4, опубликованный 2026-09-22 (UTC); в его примечаниях сказано, что редактирование конфигурации Codex или переключение с неё больше не стирает сохранённый API-ключ. Всё от v4.0.0 (2026-10-04) до v4.0.3 (2026-10-06) помечено как предварительные версии. По примечаниям к v4.0, механизм записи конфигурации переписан, и при переключении заменяются только ключевые поля, а не весь файл; новый режим агрегации собирает модели нескольких провайдеров в один список моделей в Claude Code или Codex. Предварительные версии не обновляются автоматически, обновление внутри приложения идёт только по стабильным релизам. Документация QCode по CC Switch сверена с официальной документацией v3.20.3 (2026-09-11), поэтому подписи в интерфейсе могут отличаться от версии к версии.
Хронология релизов и документации
Выходит CC Switch v3.20.3; документация QCode по CC Switch сверена с официальной документацией этой версии. По документации QCode, с этого релиза в редакторе Claude есть быстрый переключатель Disable Artifact Tool.
Выходит v3.20.4 с исправлением ошибки, из-за которой редактирование конфигурации Codex или переключение с неё стирало сохранённый API-ключ; на 2026-10-07 это по-прежнему последний стабильный релиз на GitHub.
Выходит предварительная версия v4.0.0: при переключении заменяются только ключевые поля, а не весь файл; к 2026-10-06 линейка дошла до v4.0.3, и предварительные версии не обновляются автоматически.
Подтверждено 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 хранит отдельный ключ для каждой конфигурации; проверка соединения на карточке ключ не проверяет; последний стабильный релиз v3.20.4 вышел 2026-09-22, а v4.0.0–v4.0.3 — предварительные версии.
Не описано или противоречиво
По трём вопросам эта страница выводов не делает. Первое — нужен ли перезапуск Claude Code после переключения: официальный README пишет, что Claude Code поддерживает горячее переключение без перезапуска, а FAQ официального руководства пользователя велит закрыть и снова открыть терминал; issue #3057, на который ссылается документация QCode, тоже фиксирует, что запущенная сессия продолжала работать со старой конфигурацией. Проверьте на своей версии и, если запросы всё ещё уходят на старый адрес, перезапустите сессию. Второе — сотрёт ли включение конфигурации ваши ручные правки в settings.json: документация QCode приводит сообщения о том, что некоторые версии перезаписывали файл целиком и теряли enabledPlugins и hooks; v4.0 заменяет только ключевые поля, но это пока предварительная версия, а поведение стабильной v3.20.4 эта страница не проверяла. Третье — слеш в конце 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_.
Шесть шагов: установка, настройка, переключение
① Установка: скачайте пакет со страницы GitHub Releases проекта CC Switch. Для Windows 10 и новее — .msi или портативный .zip; для macOS 12 и новее — .dmg или brew install --cask cc-switch; для Linux — .deb, .rpm или .AppImage (официально нужны glibc 2.35+ и WebKitGTK 4.1), а в Arch — paru -S cc-switch-bin. ② Настройка Claude Code: выберите Claude в переключателе сверху, нажмите «+» в правом верхнем углу, в пресетах выберите Custom и в JSON конфигурации задайте ANTHROPIC_BASE_URL = https://api.qcode.cc/api и ANTHROPIC_AUTH_TOKEN = ваш ключ cr_; имя можно выбрать любое, в примере документации — QCode.cc. ③ Сохраните, наведите курсор на карточку и нажмите Enable: CC Switch запишет оба значения в ~/.claude/settings.json. Для проверки запустите claude в терминале. ④ Настройка 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 не включайте. ⑤ Сохраните, нажмите Enable и для проверки запустите codex; в config.toml должны быть base_url = "https://api.qcode.cc/openai" и wire_api = "responses". ⑥ Чтобы потом переключиться, нажмите Enable на другой карточке или щёлкните имя конфигурации в системном трее. Сначала откройте ~/.claude/settings.json (для Codex — ~/.codex/config.toml) и убедитесь, что адрес сменился; Codex требует перезапуска терминала, а если Claude Code всё ещё обращается к старому адресу, закройте сессию и откройте новую. Если сохраняете вторую копию для asia.qcode.cc, добавьте к имени суффикс вроде (asia), чтобы различать их в трее.
На 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.
Как разобраться с ошибкой 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 сказано, что теперь при переключении заменяются только ключевые поля. Если что-то пропало, восстановите из ~/.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-09-25, сверена с официальной документацией CC Switch v3.20.3) и страница об эндпоинтах и форматах API (обновлена 2026-09-25: какой протокол идёт через какой эндпоинт, три домена и правило про слеш в конце), обе получены 2026-10-07. Установка, системные требования, правила применения переключения и официальный вход на стороне CC Switch: README и FAQ руководства пользователя в репозитории CC Switch на GitHub, получены в тот же день. Версии и даты: GitHub Releases проекта CC Switch (примечания к v3.20.3, v3.20.4 и v4.0.0–v4.0.3), получены в тот же день.
Подключите 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.
Руководство пользователя Claude Code
Руководство по CLI Claude Code: от установки и настройки до повседневной работы.
Шаги и цитаты на этой странице сверены 2026-10-07; приоритет у официальных страниц — документации QCode, официального README CC Switch и примечаний к релизам на GitHub, а изменения на стороне вендоров возможны без предупреждения. Подписи в интерфейсе CC Switch и поведение переключения меняются от версии к версии, ориентируйтесь на свою; доступность моделей — по /models.