Устранение неполадок в Codex
Ключевой аспект устранения неполадок в Codex — совместимый с OpenAI интерфейс. Как правило, диагностика выполняется в следующем порядке: Base URL, ключ (Key), название модели и активность текущего провайдера.
Что следует проверить в первую очередь?
| Элемент проверки | Как посмотреть | Зачем |
|---|---|---|
| Провайдер поддерживает OpenAI-совместимый интерфейс | В панели управления указаны адрес API, Base URL, совместимость с OpenAI и другие инструкции | Codex должен иметь возможность отправлять запросы к совместимому интерфейсу |
| Base URL | Скопируйте ссылку API, предоставленную провайдером | Нужен ли /v1 — ориентируйтесь на пример в панели управления, не угадывайте наугад |
| Статус ключа | Ключ активен, срок действия не истек, и баланс аккаунта положительный | При ошибке 401 проверку обычно начинают с ключа |
| Название модели | Скопируйте из списка моделей в панели управления | Ошибка в названии модели, регистре, дефисе или номере версии приведет к сбою |
Частые ошибки
| Симптом | Что проверить в первую очередь | Решение |
|---|---|---|
| 401 / Unauthorized | API-ключ | Сгенерируйте заново или скопируйте ключ, убедившись, что он не отключен, не просрочен и на балансе аккаунта есть средства. |
| 404 / model not found | Название модели | Не вводите названия моделей по памяти; копируйте их из списка в панели провайдера. Если поддерживается получение списка моделей, сначала запросите его; в случае сбоя добавьте вручную. |
| Ошибки, связанные с Base URL | Полная ли ссылка на API | Base URL — это ссылка на API, предоставленная провайдером. Требуется ли /v1 — ориентируйтесь на пример в панели управления, не гадайте. |
| Запрос не проходит, хотя ключ в норме | Соответствует ли протокол | Убедитесь, что текущий провайдер предоставляет OpenAI-совместимый интерфейс, а не Claude, Gemini или интерфейс только для веб-чата. |
| Изменения не применились после использования CC-Switch | Выбор целевого инструмента | Убедитесь, что провайдер применен к Codex, а не к Claude Code; перезапустите терминал или клиент перед повторной проверкой. |
Минимальный тест
Сначала протестируйте самым коротким вопросом, чтобы убедиться, что запрос проходит, прежде чем переходить к реальному проекту.
Минимальный тест Codex
codex "Please reply only: Codex configuration test successful"Шаблон обращения в поддержку
При обращении к провайдеру напишите так
Tool: Codex System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened