CC-Switch Codex
На этой странице описано управление провайдерами для Codex через CC Switch. Это отличается от прямой настройки через клиент Codex или Codex CLI: здесь основной упор делается на то, чтобы сначала настроить провайдеров в CC Switch, а затем применить их к Codex.
Официальная информация Загрузки и документация приведены с официального сайта.
О чем эта страница
Codex обычно работает через интерфейсы OpenAI или совместимые с OpenAI, поэтому обратите особое внимание на проверку трех параметров: Base URL, Key и имя модели. Нужно ли включать /v1 в Base URL, зависит от того, как это указано в панели управления провайдера.
Что проверить перед началом
| Что проверить | Как проверить | Зачем |
|---|---|---|
| Codex запускается нормально | Сначала убедитесь, что сам Codex CLI или соответствующий клиент может работать | CC Switch не устанавливает Codex за вас |
| Провайдер поддерживает OpenAI-совместимый интерфейс | В панели управления указаны адрес API, Base URL, поддержка совместимости с OpenAI и другие инструкции | Codex должен иметь возможность отправлять запросы к совместимому интерфейсу |
| Модель подходит для сценариев Codex | Доступное имя модели отображается в списке моделей панели управления | Не указывайте имена моделей Claude/Gemini для Codex |
| Ключ (Key) активен | Срок действия токена в панели управления не истек, он не отключен, и баланс в норме | Большинство ошибок 401 требуют в первую очередь проверки ключа |
Как заполнить поля
| Параметр | Способ заполнения | Важно для новичков |
|---|---|---|
| Provider Name | Укажите название провайдера или назначение | Например, 'Основной OpenAI-совместимый провайдер' |
| Target Tool / Preset | Выберите Codex или пресеты, связанные с OpenAI/Codex | Не выбирайте Claude Code или Gemini |
| Base URL | Скопируйте ссылку на API из панели управления провайдера | Обычно это адрес API, предоставленный провайдером; нужно ли включать /v1, смотрите в примере из панели управления |
| API Key | Скопируйте ключ полностью | Не добавляйте лишних пробелов в начале или конце, не копируйте вместо него примечание/название ключа |
| Model Name | Точно скопируйте имя из списка моделей в панели управления | Если не удается получить список моделей автоматически, добавьте вручную, в точности скопировав название из панели |
Применение к Codex
- Откройте CC Switch и перейдите в раздел управления Provider.
- Добавьте нового провайдера или выберите существующего OpenAI-совместимого провайдера.
- В качестве целевого инструмента выберите Codex или связанный с OpenAI/Codex пресет.
- Заполните Base URL, API Key, имя модели и сохраните.
- Нажмите Apply / Switch, чтобы применить этого провайдера к Codex.
- Закройте текущее окно терминала, откройте его заново и повторите тест.
Проверка работоспособности
Сначала протестируйте запрос самым коротким вопросом, чтобы убедиться, что он проходит. После успешного теста переходите к использованию в реальном проекте.
Минимальный тест Codex
codex "Please reply only: CC-Switch Codex is active"Если возвращается ошибка о том, что модель не существует, сначала проверьте имя модели; если возвращается ошибка авторизации, проверьте Key; если истекает время ожидания подключения, проверьте Base URL и сеть.