Solución de problemas de Codex
El aspecto clave en la solución de problemas de Codex es la interfaz compatible con OpenAI. En general, diagnostique en este orden: Base URL, Key, nombre del modelo y si el proveedor actual está activo.
¿Qué se debe verificar primero?
| Elementos a verificar | Cómo comprobarlo | Por qué |
|---|---|---|
| El proveedor admite interfaces compatibles con OpenAI | El panel de control puede mostrar la dirección de la API, Base URL, compatibilidad con OpenAI y otras instrucciones | Codex necesita poder realizar solicitudes a la interfaz compatible |
| Base URL | Copie el enlace de la API proporcionado por el proveedor | Si se requiere /v1 siga el ejemplo del panel de control, no intente adivinarlo |
| Estado de la Key | La Key no está deshabilitada ni vencida, y el saldo de la cuenta es normal | Para el error 401, por lo general comience verificando la Key |
| Nombre del modelo | Cópielo exactamente de la lista de modelos del panel de control | El nombre del modelo, mayúsculas/minúsculas, guiones o número de versión causarán fallos si se escriben de forma incorrecta |
Errores comunes
| Problema | Verificación prioritaria | Soluciones |
|---|---|---|
| 401 / Unauthorized | API Key | Regenere o copie la Key, y confirme que no esté deshabilitada ni vencida, y que el saldo de la cuenta sea normal. |
| 404 / model not found | Nombre del modelo | No escriba nombres de modelos de memoria; cópielos según la lista de modelos del panel del proveedor. Si es posible obtener la lista de modelos, consígala primero; si falla, agréguelo manualmente. |
| Errores relacionados con la Base URL | ¿Está completo el enlace de la API? | La Base URL es el enlace de la API proporcionado por el proveedor. Si se requiere /v1 siga el ejemplo del panel de control, no intente adivinarlo. |
| La solicitud no se envía pero la Key es normal | ¿Coincide el protocolo? | Confirme que el proveedor actual ofrezca una interfaz compatible con OpenAI, y no con Claude, Gemini o una interfaz que solo admita chat web. |
| No surte efecto tras usar CC-Switch | Selección de la herramienta de destino | Asegúrese de que el proveedor se aplique a Codex y no a Claude Code; reinicie la terminal o el cliente antes de volver a probar. |
Prueba mínima
Pruebe primero con la pregunta más breve posible para confirmar que la solicitud se procese antes de trabajar en el proyecto real.
Prueba mínima de Codex
codex "Please reply only: Codex configuration test successful"Plantilla de reporte
Al enviar un reporte al proveedor, escriba así
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