Настройка CC Switch
CC Switch это бесплатное приложение, которое подключает Claude Code и Codex к другим провайдерам через окно с полями. Файлы настроек оно пишет само. Подходит, если не хочется открывать конфиги руками.
Что понадобится
- CC Switch. На macOS поставьте его командой ниже через Homebrew. Для Windows и Linux скачайте установщик на странице релизов: файл
.msiдля Windows,.deb,.rpmили.AppImageдля Linux. Инструкция написана для версии 4.0. - Установленный Claude Code или Codex. Как их поставить, описано в руководствах Claude Code и Codex.
- Ключ Claudexia. Создайте его в кабинете, раздел «API-ключи». Ключ начинается с
sk_cdx_. Если аккаунта ещё нет, зарегистрируйтесь. - Деньги на балансе. Пополнить можно рублями: картой российского банка или по СБП, от 1 доллара. Способы оплаты перечислены на странице Тарифы.
brew install --cask cc-switchШаги
- Откройте CC Switch и выберите вверху значок Claude Code (первый в ряду).
- Нажмите оранжевую кнопку «+» справа.
- Выберите Custom Configuration и заполните поля:
| Name | Claudexia |
| API Key | sk_cdx_YOUR_KEY |
| Endpoint URL | https://api.claudexia.tech |
| Модель, если форма её просит | claude-sonnet-5 |
- Нажмите Add, затем выберите провайдера Claudexia в списке, чтобы включить его.
- Закройте Claude Code, если он был открыт, и запустите снова: настройки читаются при старте.
Для Claude Code адрес пишется без /v1, для Codex с /v1. Косую черту в конце адреса не ставьте.
Codex
Выберите вверху значок Codex, нажмите «+», затем Custom Configuration и заполните поля:
| Name | Claudexia |
| API Key | sk_cdx_YOUR_KEY |
| Endpoint URL | https://api.claudexia.tech/v1 |
| Модель, если форма её просит | gpt-6-sol |
CC Switch запишет адрес и ключ в ~/.codex/config.toml. После этого закройте и снова откройте Codex.
Проверьте, что работает
Откройте новый терминал и выполните команду. В ответ придёт OK:
claude -p "Reply with OK"Перед первой записью CC Switch сохраняет исходные файлы настроек в папку ~/.cc-switch/backups/. Вернуться к подписке Anthropic или OpenAI можно, выбрав в списке официального провайдера.
Какую модель выбрать
- Для повседневной работы:
claude-sonnet-5. Это модель по умолчанию в наших примерах, она есть в канале Premium. В канале Cheap вместо неёclaude-opus-5-5. - Для сложных задач и больших проектов:
claude-opus-5-5. Она дороже Sonnet 5. - Чтобы тратить меньше, если программа принимает модели других семейств:
deepseek-v4.1-flashилиgpt-6-luna. Обе в разы дешевле Sonnet 5 и работают только в канале Premium.
Цены и полный список моделей в каталоге. Модели GPT, DeepSeek, Gemini и другие не из семейства Claude доступны только ключам канала Premium: см. Каналы.
Частые ошибки
Нажмите на ошибку, чтобы увидеть, что делать.
401: Invalid or missing API key
Программа отправила неверный ключ или не отправила его вовсе. Скопируйте ключ из раздела «API-ключи» целиком: он начинается с sk_cdx_, в нём нет пробелов и переносов строк. Если ключ удалили или отозвали, создайте новый. После замены ключа перезапустите программу.
402: баланс пуст
На балансе закончились деньги. В формате OpenAI ошибка приходит с кодом insufficient_quota, в формате Anthropic это HTTP-статус 402. Пополните баланс в разделе «Оплата»: рублями с карты или по СБП, от 1 доллара. Настройки менять не нужно, просто повторите запрос. Если баланс почти пуст, запросы идут по одному и может прийти 429 с кодом low_balance. Код account_frozen значит, что аккаунт приостановлен: напишите в поддержку.
404: Not found или неверный адрес
Программа обращается не по тому адресу. Для этой программы адрес пишется без /v1: https://api.claudexia.tech. Программа сама добавит /v1/messages. Если вписать адрес с /v1, получится /v1/v1/messages и ошибка 404. Таблица адресов есть на странице Адреса и форматы.
Программа не видит ключ
Программы читают настройки при запуске. Закройте программу полностью и откройте снова, а терминал откройте новый. Переменная окружения, заданная в одном окне терминала, не видна в другом. Приложения, запущенные из Dock, меню «Пуск» или ярлыка, не читают ~/.zshrc и ~/.bashrc: для них ключ вписывают в настройки самой программы.
Model not found или модель не найдена
Имя модели должно совпадать с ID в каталоге до символа: claude-sonnet-5, а не «Claude Sonnet 5». Суффикс [1m] понимает только Claude Code, в других программах его не пишите.
403: model_not_in_channel
Модели нет в канале вашего ключа. В канале Cheap работают только модели Claude, в канале Premium весь каталог. Смените модель или канал ключа: подробнее в разделе Каналы Premium и Cheap.
Проверьте ключ отдельно от программы
Команда ниже отправляет один короткий запрос напрямую в Claudexia, без программы. Так видно, в чём дело: в ключе и балансе или в настройках программы. Замените sk_cdx_YOUR_KEY на свой ключ. Запрос стоит доли цента.
curl https://api.claudexia.tech/v1/chat/completions \
-H "Authorization: Bearer sk_cdx_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'Invoke-RestMethod https://api.claudexia.tech/v1/chat/completions -Method Post `
-Headers @{ Authorization = 'Bearer sk_cdx_YOUR_KEY' } -ContentType 'application/json' `
-Body '{"model": "claude-sonnet-5", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'Пришёл ответ с полем choices: ключ и баланс в порядке, ищите ошибку в настройках программы. Пришла ошибка: код и текст подскажут причину, они разобраны выше и в справочнике ошибок.